gtpg2m27General Macros

FINHC-Find and Hold a File Record

This general macro assigns the entry control block (ECB) exclusive control of the specified record and then reads the record from the file into storage. 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 ECB data level or data event control block (DECB).

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

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

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.

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. N is the default.

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.