Action operators

The following table described the Action Operators for finding and updating jobs:

Action

Description

assign

Assigns the value as is (no functions, place holders or regular expressions).

If the field contains several values (a list field, such as scheduling Dates field), you can add or modify values in the list, by providing comma-separated values. If only one value is specified, only the first value in the list field is updated.

EXAMPLE: To add three scheduling dates to the list use:

Update "Dates" assign "0909,0807,0221"

assign function

Assigns function values.

The '*' character is a special place holder of the previous field value (or a part of it).

EXAMPLES:

Set the job File Name from /home/user1/* TO /home2/user3/*

Update where Out Condition Name like "*" assign function *@HHMMSS.
The condition name is evaluated and set by Control-M at runtime, enabling users to create unique condition names in cyclic jobs. The character ‘*’ has a special meaning and can save the previous field value.

For more information about Assign Function Operators, see Function operators.

clear

Clears the field value. Fields that are assigned with a predefined set of values reset to the default value.

replace substring

Replaces all occurrences of the substring specified in the first field with the one specified in the second field (which may be empty).

EXAMPLE:

If the field contains several values (a list field, such as the "SAP R3:Variant Name" field), you can replace a substring like "VAR1" with another string "VAR2" in all cell values using the following statement:

Update "SAP R3:Variant Name" replace substring "VAR1" "VAR2"

replace expression

Regular expressions search and replace support (can use references to numbered groups).

EXAMPLE:

Update Application replaces expression (.*)account(.*) with \2account\1

In this example, if the Application's original value was GLOBALaccount45, the update is set to 45accountGLOBAL.

If the field contains several values (a list field, such as the "AFT::File Path on Host 1" field), the assign operator allows you to modify the whole list at once, using comma-separated values. However, you can set all cell values with the same "test" value like this:

Update "AFT::File Path on Host 1" replace expression ".*" "test"

Parent Topic

Find and Update