gtpg2m2bGeneral Macros

FIWHC-Find and Hold a File Record, and Wait

This general macro reads a record from file into storage and holds it. A block of storage is obtained by the control program and reference to it is stored in the core block reference word (CBRW) at the specified entry control block (ECB) data level or data event control block (DECB).

The requested record may be contained in virtual file access (VFA).

The control program will queue this request if the record is being held by another ECB. All succeeding requests to hold this record are queued until the existing record hold is released.

Format




label
A symbolic name can be assigned to the macro statement.

datalevel
An ECB data level (D0-DF) that identifies the file address and core block information for the I/O request.

DECB=(reg)|label1
The label or general register (R0-R7) containing the address of the DECB, which specifies the file address and core block information for the I/O request.

label2
The label of an operational program error routine within the current program segment must be specified.

GDS
Specify one of the following:

N
The file address in the specified ECB data level or DECB is for a record from the online database.

Y
The file address in the specified ECB data level or DECB is for a record on either a general file or a general data set.

Entry Requirements

Return Conditions

Programming Considerations

Examples

None.