Command Reference > pmrep Command Reference > MassUpdate
  

MassUpdate

Updates session properties for a set of sessions that meet specified conditions. You can update all sessions in a folder or a list of sessions. To update a list of sessions, create a persistent input file. The list can contain a specific list of sessions, or it can contain conditions such as a name pattern or a property value. Use ExecuteQuery to generate a persistent input file.
When you run MassUpdate, you can view information such as the folder name, the number of sessions that are successfully updated or failed, and the names of the sessions that are updated. You can view the status of the update in the command line window or in a log file that the command generates. You specify the name and path for the log file when you run the command. By default, the log file is stored in the directory where you run the command.
Use MassUpdate to update a session property across multiple sessions when a PowerCenter version changes a default value.
Before you update the sessions, you can also run MassUpdate in a test mode to view changes. To view a sample log file, see Sample Log File.
The MassUpdate command uses the following syntax:
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>]
The following table describes pmrep MassUpdate options and arguments:
Option
Argument
Description
-t
session_property_type
Required. Session property type to update. Session properties are of the following types:
  • - session_property
  • - session_config_property
  • - transformation_instance_attribute
  • - session_instance_runtime_option
-n
session_property_name
Required. Name of the attribute or property to update.
-v
session_property_value
Required. Value that you want to assign to the property followed by a semicolon.
For example, to assign a value to the property, use the following syntax: -v "IgnoreNULLInExpressionComparison=Yes;"
Note: Enclose the session property value in double quotes.
-w
transformation_type
Required if you update a transformation instance attribute. Transformation type to update. You can update the following transformation types: aggregator, joiner, lookup procedure, rank, sorter, source definition, and target definition.
-i
persistent_input_file
Required if you do not use the -f option. Name of the file that contains the selected list of sessions to update. You can use the pmrep ExecuteQuery command to run a query and generate this file. MassUpdate returns an error if you specify an object that is not a session. You must use the -i option or the -f option, but not both.
-f
folder_name
Required if you do not use the -i option. Name of the folder. Use to update all sessions in a folder. You must use the -i option or the -f option, but not both.
-o
condition_operator
Required if you use condition_value. Part of the condition that defines the session set.
The attribute of a session or session instance is updated when the condition is met.
You can use the following condition operators to update a string: equal or unequal.
You can use the following condition operators to update an integer: equal, unequal, less, or greater.
-l
condition_value
Required if you use a condition operator. Part of the condition. The condition appears as follows:
<session_property_value> <condition operator> <condition_value>
-g
update_session_instance_flag
Required if you update a session instance run-time option.
Optional for the following session property types: session property, session configuration attribute, and transformation instance attribute.
Updates session instances.
You can update an attribute in a session instance if the session instance overrides the attribute.
-m
test_mode
Optional. Runs MassUpdate in test mode. View sessions that will be impacted by the command before you commit changes. You can see the following details in the command line window:
  • - Session name
  • - Type of session: reusable or non-reusable
  • - Current value of the session property
  • - Sessions for which the attribute has the same value and are not affected by the command.
-u
output_log_file_name
Optional. Name of the log file that stores the status of the update and basic information about the sessions or session instances. Previous attribute values are also written to this file. If you do not use this option, the details appear in the command line window.
The MassUpdate command returns “massupdate successfully completed” or returns “failed to execute massupdate” message. The update might fail for the following reasons:

Session Property Types

When you run MassUpdate, specify the session property type and the name. You specify the following session property types:
The following table lists the session properties that you can update and the session property types:
Session Property
Session Property Type
$Source connection value
session_property
$Target connection value
session_property
Additional Concurrent Pipelines for Lookup Cache Creation
session_config_property
Aggregator Data Cache Size
transformation_instance_attribute
The transformation_type argument must be aggregator.
Aggregator Index Cache Size
transformation_instance_attribute
The transformation_type argument must be aggregator.
Allow Temporary Sequence for Pushdown
session_property
Allow Temporary View for Pushdown
session_property
Cache Directory
transformation_instance_attribute
The transformation_type argument must be aggregator, joiner, or rank.
Cache LOOKUP( ) function
session_config_property
Collect performance data
session_property
Commit Interval
session_property
Commit Type
session_property
Constraint based load ordering
session_config_property
Custom Properties
session_config_property
DateTime Format String
session_config_property
Default buffer block size
session_config_property
Disable this task
session_instance_runtime_option
DTM buffer size
session_property
Enable high precision
session_property
Enable Test Load
session_property
Fail parent if this task does not run
session_instance_runtime_option
Fail parent if this task fails
session_instance_runtime_option
Incremental Aggregation
session_property
Is Enabled
session_config_property
Java Classpath
session_property
Joiner Data Cache Size
transformation_instance_attribute
The transformation_type argument must be joiner.
Joiner Index Cache Size
transformation_instance_attribute
The transformation_type argument must be joiner.
Line Sequential buffer length
session_config_property
Lookup cache directory name
transformation_instance_attribute
The transformation_type argument must be lookup procedure.
Lookup Data Cache Size
transformation_instance_attribute
The transformation_type argument must be lookup procedure.
Lookup Index Cache Size
transformation_instance_attribute
The transformation_type argument must be lookup procedure.
Maximum Memory Allowed For Auto Memory Attributes
session_config_property
Maximum Percentage of Total Memory Allowed For Auto Memory Attributes
session_config_property
On Pre-Post SQL error
session_config_property
On Pre-session command task error
session_config_property
On Stored Procedure error
session_config_property
Output file directory
transformation_instance_attribute
The transformation_type argument must be target definition.
Override tracing
session_config_property
Parameter Filename
session_property
Pre 85 Timestamp Compatibility
session_config_property
Pre-build lookup cache
session_config_property
Pushdown Optimization
session_property
Rank Data Cache Size
transformation_instance_attribute
The transformation_type argument must be rank.
Rank Index Cache Size
transformation_instance_attribute
The transformation_type argument must be rank.
Recovery Strategy
session_property
Reject file directory
transformation_instance_attribute
The transformation_type argument must be target definition.
Rollback Transactions on Errors
session_property
Save session log by
session_config_property
Session Log File directory
session_property
Session retry on deadlock
session_property
Session Sort Order
session_property
When the Integration Service runs in Unicode mode, you can choose the sort order to sort character data in the session. You can configure the following values for the sort order:
  • - 0. BINARY
  • - 2. SPANISH
  • - 3. TRADITIONAL_SPANISH
  • - 4. DANISH
  • - 5. SWEDISH
  • - 6. FINNISH
Sorter Cache Size
transformation_instance_attribute
The transformation_type argument must be sorter.
Source file directory
transformation_instance_attribute
The transformation_type argument must be source definition.
Stop on errors
session_config_property
Treat source rows as
session_property
Treat the input link as AND
session_instance_runtime_option
Write Backward Compatible Session Log File
session_property

Rules and Guidelines for MassUpdate

Use the following rules and guidelines when you run MassUpdate:

Sample Log File

The following text shows a sample log file generated by 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.
------------------------------------------------------------------------------