Referencia de comando > Referencia de comando pmrep > MassUpdate
  

MassUpdate

Actualiza las propiedades de la sesión para un conjunto de sesiones que cumplen con las condiciones especificadas. Puede actualizar todas las sesiones de una carpeta o una lista de sesiones. Para actualizar una lista de sesiones, cree un archivo de entrada persistente. La lista puede contener una lista específica de sesiones o puede contener condiciones tales como un patrón de nombre o un valor de propiedad. Emplee ExecuteQuery para generar un archivo de entrada persistente.
Al ejecutar MassUpdate, puede ver información tal como el nombre de carpeta, la cantidad de sesiones que se han actualizado correctamente o que han presentado error y los nombres de las sesiones que se han actualizado. Puede ver el estado de la actualización en la ventana de la línea de comandos o en un archivo de registros generado por el comando. Especifique el nombre y la ruta del archivo de registro al ejecutar el comando. De manera predeterminada, el archivo de registro se almacena en el directorio donde se ejecuta el comando.
Emplee MassUpdate para actualizar una propiedad de sesión en varias sesiones cuando una versión de PowerCenter cambia un valor predeterminado.
Antes de actualizar las sesiones, también puede ejecutar MassUpdate en modo de prueba para ver los cambios. Para ver un archivo de registro de muestra, consulte Archivo de registro de muestra.
El comando MassUpdate emplea la siguiente sintaxis:
pmrep massupdate

-t <session_property_type (session_property, session_config_property, transformation_instance_attribute, session_instance_runtime_option)>

-n <session_property_name>

-v <session_property_value>

[-w <transformation_type>]

{-i <persistent_input_file> | -f <folder_name> }

[-o <condition_operator (equal, unequal, less, greater)>]

[-l <condition_value>]

[-g <update_session_instance_flag>]

[-m <test_mode>]

[-u <output_log_file_name>]
La tabla siguiente describe las opciones y los argumentos de pmrep MassUpdate:
Opción
Argumento
Descripción
-t
session_property_type
Obligatorio. Tipo de propiedad de sesión que se actualizará. Las propiedades de la sesión son de los tipos siguientes:
  • - session_property
  • - session_config_property
  • - transformation_instance_attribute
  • - session_instance_runtime_option
-n
session_property_name
Obligatorio. Nombre del atributo o propiedad que se actualizará.
-v
session_property_value
Obligatorio. Valor que desea asignar a la propiedad seguido por un punto y coma.
Por ejemplo, para asignar un valor a la propiedad, utilice la siguiente sintaxis: -v "IgnoreNULLInExpressionComparison=Yes;"
Nota: Escriba el valor de propiedad de sesión entre comillas dobles.
-w
transformation_type
Obligatorio si actualiza un atributo de instancia de transformación. Tipo de transformación que se actualizará. Puede actualizar los siguientes tipos de transformación: de agregación, de combinación, de procedimiento de búsqueda, de rango, de ordenación, de definición de origen y de definición de destino.
-i
persistent_input_file
Obligatorio si no usa la opción -f. Nombre del archivo que contiene la lista seleccionada de sesiones que se actualizarán. Puede emplear el comando pmrep ExecuteQuery para ejecutar una consulta y generar este archivo. MassUpdate producirá un error si se especifica un objeto que no es una sesión. Debe usar la opción -i o la opción -f, pero no ambas.
-f
folder_name
Obligatorio si no usa la opción -i. Nombre de la carpeta. Se utiliza para actualizar todas las sesiones de una carpeta. Debe usar la opción -i o la opción -f, pero no ambas.
-o
condition_operator
Obligatorio si utiliza condition_value. Parte de la condición que define el conjunto de sesiones.
El atributo de una sesión o instancia de sesión se actualiza cuando se cumple esta condición.
Puede emplear los siguientes operadores de condición para actualizar una cadena: equal o unequal.
Puede emplear los siguientes operadores de condición para actualizar un entero: equal, unequal, less o greater.
-l
condition_value
Obligatorio si usa un operador de condición. Parte de la condición. La condición se muestra de la siguiente manera:
<session_property_value> <condition operator> <condition_value>
-g
update_session_instance_flag
Obligatorio si actualiza una opción de tiempo de ejecución de instancia de sesión.
Opcional para los siguientes tipos de propiedad de sesión: propiedad de sesión, atributo de configuración de sesión y atributo de instancia de transformación.
Actualiza las instancias de sesión.
Puede actualizar un atributo en una instancia de sesión si la instancia de sesión reemplaza el atributo.
-m
test_mode
Opcional. Ejecuta MassUpdate en modo de prueba. Permite ver las sesiones que este comando modificará antes de que los cambios se realicen efectivamente. Puede ver los siguientes detalles en la ventana de la línea de comandos:
  • - Nombre de la sesión
  • - Tipo de sesión: reusable o non-reusable
  • - Valor actual de la propiedad de sesión
  • - Sesiones para las cuales el atributo tiene el mismo valor y sobre las cuales el comando no tiene efecto.
-u
output_log_file_name
Opcional. Nombre del archivo de registro que almacena el estado de la información básica y de actualización sobre las sesiones o las instancias de sesión. Los valores de atributos anteriores también se escriben en este archivo. Si no utiliza esta opción, los detalles se muestran en la ventana de la línea de comandos.
El comando MassUpdate devuelve los mensajes “actualización masiva completada correctamente” o bien “error al realizar actualización masiva”. Es posible que se produzca un error en la actualización por las razones siguientes:

Tipos de propiedades de la sesión

Al ejecutar MassUpdate, especifique el nombre y tipo de propiedad de la sesión. Puede especificar los siguientes tipos de propiedades de la sesión:
En la tabla siguiente, se describen las propiedades de la sesión que puede actualizar y los tipos de propiedades de la sesión:
Propiedad de la sesión
Tipo de propiedad de la sesión
Valor de conexión $Source
session_property
Valor de conexión $Target
session_property
Canales simultáneos adicionales para la creación de la memoria caché de búsqueda
session_config_property
Tamaño de la memoria caché de datos de agregación
transformation_instance_attribute
El argumento de transformation_type debe ser aggregator.
Tamaño de la memoria caché de índice de agregación
transformation_instance_attribute
El argumento de transformation_type debe ser aggregator.
Permitir secuencia temporal para inserción
session_property
Permitir vista temporal para inserción
session_property
Directorio de la memoria caché
transformation_instance_attribute
El argumento de transformation_type debe ser agregador, combinación o rango.
Función LOOKUP( ) de memoria caché
session_config_property
Recopilar datos de rendimiento
session_property
Intervalo de Commit
session_property
Tipo de Commit
session_property
Ordenación de carga basada en restricciones
session_config_property
Propiedades personalizadas
session_config_property
Cadena de formato de fecha y hora
session_config_property
Tamaño de bloque de búfer predeterminado
session_config_property
Deshabilitar esta tarea
session_instance_runtime_option
Tamaño de búfer DTM
session_property
Habilitar alta precisión
session_property
Habilitar carga de prueba
session_property
Anular el primario si la tarea no se ejecuta
session_instance_runtime_option
Anular el primario si la tarea falla
session_instance_runtime_option
Agregación incremental
session_property
Está habilitado
session_config_property
Vía de acceso de clases Java
session_property
Tamaño de la memoria caché de datos de combinación
transformation_instance_attribute
El argumento de transformation_type debe ser combinación.
Tamaño de la memoria caché de índice de combinación
transformation_instance_attribute
El argumento de transformation_type debe ser combinación.
Longitud del búfer secuencial de línea
session_config_property
Nombre del directorio de la memoria caché de búsqueda
transformation_instance_attribute
El argumento de transformation_type debe ser lookup procedure.
Tamaño de la memoria caché de datos de búsqueda
transformation_instance_attribute
El argumento de transformation_type debe ser lookup procedure.
Tamaño de la memoria caché de índice de búsqueda
transformation_instance_attribute
El argumento de transformation_type debe ser lookup procedure.
Memoria máxima permitida para atributos de memoria automática
session_config_property
Porcentaje máximo de memoria total permitida para atributos de memoria automática
session_config_property
Al producirse error previo a Post de SQL
session_config_property
Al producirse error de tarea de comando previo a la sesión
session_config_property
Al producirse error en procedimiento almacenado
session_config_property
Directorio del archivo de salida
transformation_instance_attribute
El argumento de transformation_type debe ser target definition.
Seguimiento de reemplazo
session_config_property
Nombre del archivo de parámetros
session_property
Compatibilidad de marca de tiempo Pre 85
session_config_property
Generar previamente la memoria caché de búsqueda
session_config_property
Optimización de inserción
session_property
Tamaño de la memoria caché de datos de rango
transformation_instance_attribute
El argumento de transformation_type debe ser rank.
Tamaño de la memoria caché de índice de rango
transformation_instance_attribute
El argumento de transformation_type debe ser rank.
Estrategia de recuperación
session_property
Directorio de archivos de rechazo
transformation_instance_attribute
El argumento de transformation_type debe ser target definition.
Revertir transacciones en caso de errores
session_property
Guardar registro de la sesión por
session_config_property
Directorio del archivo de registro de la sesión
session_property
Reintentar sesión en caso de bloqueo
session_property
Orden de clasificación de sesión
session_property
Si el servicio de integración se ejecuta en modo Unicode, puede seleccionar el orden de clasificación para ordenar los datos de caracteres de la sesión. Puede configurar los valores siguientes para el orden de clasificación:
  • - 0. BINARY
  • - 2. SPANISH
  • - 3. TRADITIONAL_SPANISH
  • - 4. DANISH
  • - 5. SWEDISH
  • - 6. FINNISH
Tamaño de la memoria caché de ordenación
transformation_instance_attribute
El argumento de transformation_type debe ser sorter.
Directorio del archivo de origen
transformation_instance_attribute
El argumento de transformation_type debe ser source definition.
Detener en caso de error
session_config_property
Tratar filas de origen como
session_property
Tratar vínculo de entrada como AND
session_instance_runtime_option
Escribir archivo de registro de la sesión compatible hacia atrás
session_property

Reglas y directrices para MassUpdate

Utilice las siguientes reglas y directrices cuando ejecute MassUpdate:

Archivo de registro de muestra

El texto siguiente muestra un archivo de registro de muestra generado por pmrep MassUpdate:
cases_auto,s_test_ff,reusable,0
s_test_ff was successfully checked out.

------------------------------------------------------------------------------
11/10/2008 11:12:55 ** Saving... Repository test_ver_MU, Folder cases_auto
------------------------------------------------------------------------------
Session s_test_ff updated.
Checking-in saved objects...done
------------------------------------------------------------------------------

cases_auto,wf_non_reusable_test_ff.s_test_ff_non_reusable,non-reusable,0
wf_non_reusable_test_ff was successfully checked out.

------------------------------------------------------------------------------
11/10/2008 11:12:57 ** Saving... Repository test_ver_MU, Folder cases_auto
------------------------------------------------------------------------------
Validating the flow semantics of Workflow wf_non_reusable_test_ff...
...flow semantics validation completed with no errors.

Validating tasks of Workflow wf_non_reusable_test_ff...
...Workflow wf_non_reusable_test_ff tasks validation completed with no errors.

Workflow wf_non_reusable_test_ff updated.
Checking-in saved objects...done
------------------------------------------------------------------------------

Massupdate Summary:
Number of reusable sessions that are successfully updated: 1.
Number of non-reusable sessions that are successfully updated: 1.
Number of session instances that are successfully updated: 0.
Number of reusable sessions that fail to be updated: 0.
Number of non-reusable sessions that fail to be updated: 0.
Number of session instances that fail to be updated: 0.
------------------------------------------------------------------------------