Keywords › Keyword Descriptions › NEWRID › Parameters

Parameters

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

ESDS

Relative byte address (RBA), expressed in a four-byte hexadecimal format:

X'hh…'

Hexadecimal

KSDS

The record key, expressed in either:

C'c…'

Character—matches specified case

X'hh…'

Hexadecimal

RRDS

Relative record number (RRN)

Sequential

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)