gtpg2m29General Macros

FINSC-Find a Single File Record

This general macro reads a record from a file into storage. An option provides the user with the facility to read either the primary or duplicate record.

This macro should only be used to read records from the online database. It should not be used to access records on general files or general data sets.

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).

FINSC causes VFA to be searched for the record. If the record is in VFA, it is forced out of VFA before the record is read from the specified DASD.

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.

P
Find primary record.

D
Find duplicate record.

Entry Requirements

Return Conditions

Programming Considerations

Examples

None.