Input Modules › Selective Retrieval of VSAM files (CULLVSAM) › Coding the ADR Control Statement for a Pointed Start

Coding the ADR Control Statement for a Pointed Start

To access entry-sequenced files at a specific place in the file, code the following control statements:

Pointed Start for z/VSE

For z/VSE, assign the external file name VSAMCTRL for the control statements:

//VSAMCTRL DD *
 ADR H hexadecimal-position-qx

• H is a 1-character keyword, coded in column 6, that formats the key field.
• Hexadecimal-position-qx specifies a fullword hexadecimal value (8 digits) that identifies the starting byte of the targeted record within the file. The first byte of the file is always '00000000'. Hexadecimal-position-qx starts in column 7 and is enclosed in single quotation marks.

Pointed Start for z/OS

For z/OS, read the control statement(s) in from SYSIPT:

5-step JCL:
     // ASSGN SYSIPT,X'device'
     // EXEC CULL,SIZE=300K
      ADR H hexadecimal-position-qx

1-step JCL:
     // EXEC CULPRIT,SIZE=300K
        CULPRIT PARAMETERS
     /*
      ADR H hexadecimal-position-qx
     /*

The size specification must be small enough to allow space allocation for VSAM modules in the GETVIS area.

Notes

• The input buffer size should include two additional bytes for the RDW to avoid any loss of data.
• To read a VSAM file from the beginning, use the VS option of the INPUT parameter. VS allows retrieval from all types of VSAM files.
• Valid control statements must be used in CA Culprit JCL. If CULLVSAM encounters a blank card (z/VSE) or if VSAMCTRL is DUMMY (z/OS) the read will start at the beginning of the file.
• If a file is password protected and the PW= control statement is omitted, the console operator must supply the password for the file to be opened.
• Partial keys, starting with the leftmost character, can be used for accessing key-sequenced files.