Keywords › Keyword Descriptions › NEWRID › Parameters

Parameters

Valid rid values for each supported file format are as follows:

ESDS

Specifies a relative byte address (RBA) in a four-byte hexadecimal format:

X'hh…'

Hexadecimal

KSDS

Specifies the record key in one of the following formats:

C'c…'

Character—matches specified case

X'hh…'

Hexadecimal

RRDS

Specifies the relative record number (RRN)

Sequential

Specifies the actual record number, valid values are 1 - 999,999,999

Note: When using a hexadecimal value, you must supply an even number of hexadecimal characters.

Example 1

This example syntax is for a KSDS file. Record processing begins with the record that has the key value X'1000', or if that key does not exist, the next higher key. If there is no NEWFILE keyword, the default value SYSUT1N is positioned accordingly.

COMPARE,
  NEWRID(X'1000')

Example 2

This example syntax is for RRDS and sequential files. Processing begins with the 32nd record of the data set specified by the NEWFILE keyword, or if NEWFILE is not supplied, the data set specified by the default value SYSUT1N is positioned accordingly.

COMPARE,
  NEWRID(32)