Keywords › Keyword Descriptions › CHANGE › Parameters

Parameters

CHANGE supports the following parameters:

field-name

Use field-name when referencing a data field that is defined in the record's layout. The layout must be available to the application's job step. For more information about how to make the record's layout available, see the keyword LAYOUTFILE.

Note: When this parameter is specified, the keyword's position, length, decimal positions, and data type are retrieved from the field-name definition and are used to validate the from-data and to-data's formats.

position

Specifies the starting field position in a record. Valid choices are:

1 - 32760—The actual position number

+nnn or –nnn—The relative position to the record's current location

scan-length

Specifies the amount of data to scan. When scan-length of set to 0, the entire record starting at the position value is scanned. Valid values are 0 - 32760. If the scan-length is omitted, no scanning is done.

operator

Specify one of the following values:

CO—Contains–If a field-name is specified, the position and scan-length values are retrieved from the field-name's defined starting position and physical length. If position and scan-length are specified, the record is scanned for the data beginning at position for a length of scan-length.

EQ—Equal

NE—Not equal

GT—Greater than

GE—Greater than or equal

LE—Less than or equal to

LT—Less than

from‑data

Specify one of the following values:

C'c…'—Character–matches specified case

N'n…'—Numeric–processes the literal as defined by the field-name parameter. The field-name parameter must be defined as a numeric field, and is only valid when a field-name parameter is supplied.

P'n…'—Packed

T'c…'—Text–matches both lower and uppercase alphabetic characters. Alphanumeric characters are permitted.

X'hh…'—Hexadecimal

to‑data

Specify one of the following values:

C'c…'—Character–matches specified case

N'n…'—Numeric–processes the literal as defined by the field-name parameter. This parameter is only valid when a field-name parameter is supplied.

P'n…'—Packed

T'c…'—Text–upper case letters are substituted for their lower case counterparts. Alphanumeric data is permitted.

X'hh…'—Hexadecimal

ALL

Changes every occurrence in the record within the scan-length. Otherwise only the first occurrence of the from-data is changed. The scan-length parameter must be present if this parameter is specified.