Keywords › Keyword Descriptions › MOVE › Parameters

Parameters

MOVE supports the following parameters:

to-field-name

Use to-field-name when referencing a data field that is defined in the record's layout. The use of to-field-name requires that the record's layout be available to the CA File Master Plus job step. For more information on how to make the record's layout available, see the keyword LAYOUTFILE.

Note: When this parameter is supplied, the keyword's position is retrieved from the to-field-name definition, and is used to validate the to-data's format.

to‑position

The position to store data. Valid choices are as follows:

1–32760

The actual position number

+nnn or –nnn

The relative position to the record's current location

to-data

Valid choices include the following:

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 it 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

length

Amount of data to move. A value of zero means that the data to move begins at the from-position and goes to the length of the input record. Valid values are 0 – 32760.

from-field-name

Use from-field-name when referencing a data field that is defined in the record's layout. The use of from-field-name requires that the record's layout be available to the CA File Master Plus job step. For more information on how to make the record's layout available, see the keyword LAYOUTFILE.

Note: When this parameter is supplied, the keyword's from-position and physical length are both retrieved from the from-field-name definition.

from‑position

Starting position in the record. This value cannot reference data that is greater than the record's length. Valid choices are:

1–32760

The actual position number

+nnn or –nnn

The relative position to the record's current location

CLEAR

This parameter value initializes the move buffer to the current PADCHAR value and resets the move buffer length for variable output records to zero.

0

Repeat the to data literal, starting at the to position, for the length of the output record. For variable record output files, this length is the input record's length.