Previous Topic: SyntaxNext Topic: Keywords


Parameters

IF 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 all retrieved from the field-name definition, and are used to validate the from-data and to-data's formats.

position

Specifies the starting field positioning the record. Valid values are the following:

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 compare. If you specify 0, scanning starts at the position value to the record length. Valid values are 0 - 32760. No scanning is done if the scan-length is omitted.

operator

Specify one of the following values:

CO

Contains—If a field-name is supplied, 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 supplied, 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 to

LE

Less than or equal to

LT

Less than

data:
C'c…'

Character—matches the 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'x…'

Text—matches both lower and uppercase alphabetic characters. Alphanumeric characters are permitted.

X'hh…'

Hexadecimal

data–type:
EQP

Valid packed decimal data

NEP

Not valid packed decimal data

EQN

Valid numeric data

NEN

Not valid numeric data