Previous Topic: Update Utility From and To Character Strings SubmenuNext Topic: Update Utility Update Fields Submenu


Field Descriptions

Pos

Type the position within the record where the scan is to begin. Valid values are 1 through 32760

Len

Type the length of the scan to perform. A scan-length of zero means to scan the entire record starting at the position parameter's value. Valid values are 0 – 32760.

Op

Type the operator value to use when scanning. Valid choices include:

EQ — Equal

NE — Not equal

GT — Greater than

GE — Greater than or equal to

LE — Less than or equal to

LT — Less than

From Value

Type the from string values for the scan to use. If the scan operation is evaluated to be true, the data beginning at the first byte of the from string value will be REPLACED by the to string value. From string data is replaced for the length of the to string value with no shifting of data or alteration of the record length, unless the Input Format JCL option is Y.

When the Input Format JCL option is Y, and the to character string is shorter than the from character string, data is shifted to the left until two consecutive spaces/blanks are found, then padded with spaces/blanks. If the to character string is longer than the from string and there are not enough consecutive blanks to accommodate the difference, a new (continued) JCL card will be inserted with one or more JCL parameters from the updated JCL record.

Valid syntax is as follows:

'c…'

Text – matches both lower and uppercase alphabetic characters.

C'c…'

Character – matches specified case

P'n…'

Packed decimal

T'x…'

Text – matches both lower and uppercase alphabetic characters. Alphanumeric data is permitted.

X'hh'

Hexadecimal

Apostrophes (') and quotes (") are not interchangeable.

Character data within apostrophes and quotes are always treated as text.

When the text contains an apostrophe, the text needs to be enclosed in quotes.

When the text contains a quote, the text needs to be enclosed in apostrophes.

To Value

Type the to string value to be used as a replacement string for the from string value. If the scan operation is evaluated to be true, the data beginning at the first byte of the from string value will be REPLACED by the to string value.

Valid syntax is as follows:

'c…'

Text – matches both lower and uppercase alphabetic characters.

C'c…'

Character – matches specified case

P'n…'

Packed decimal

T'x…'

Text – matches both lower and uppercase alphabetic characters. Alphanumeric data is permitted.

X'hh'

Hexadecimal

Apostrophes (') and quotes (") are not interchangeable.

Character data within apostrophes and quotes are always treated as character.

When the text contains an apostrophe, the text needs to be enclosed in quotes.

When the text contains a quote, the text needs to be enclosed in apostrophes.

All

Type a Y to replace every occurrence of the from string found in a record within the scan-length. Type N to replace the first occurrence only of the from string found in a record within the scan-length.