gtpg2m2aGeneral Macros

FINWC-Find a File Record and Wait

This general macro reads a record from a file into storage and waits for completion. 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 can be contained in the virtual file access (VFA).

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.