gtps1m2oSystem Macros

FLVFC-Flush a Record from VFA Buffers

Use this system macro to flush a record from virtual file access (VFA). The next request for this record may force a read from file depending on the options used.

Required Authorizations
Key0 Restricted System Common Storage

X

Format




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

FILE
Specify one of the following:

YES
Requests that the flushed record be filed out to DASD if the record is delayed file pending before it is deleted from VFA. This is a purge with file down.

NO
Requests the record not be filed out to DASD even if it is delayed file pending. This is a purge without file down.

ONLY
Requests the flushed record be filed out to DASD if the record is delayed file pending. Otherwise no change is to be made to the record's VFA residence. It will be left as available in VFA. This is only a file down if delayed filing is pending.

RECORD
Requests a copy of the record, if the record is delay file pending, be passed to the exception recording routines to be exception recorded. The record will remain in VFA in delay file pending status.

If the FILE parameter is omitted, the YES option is assumed.

MCHR
Specify one of the following:

YES
Requests the flushed record be located using the specified hardware address.

NO
Requests the record be located using the supplied FARF address with its associated DBI and SSU values.

When the MCHR parameter is omitted, NO is assumed.

GDS=NO|YES|ALLBLKS
This parameter specifies that the file address that is passed is for a general file (GF) or general data set (GDS) record. The ALLBLKS option specifies that all blocks for the data set will be flushed.

When the GDS parameter is omitted, NO is the default.

REG=R14|Rx
A general register, one of R0 through R7 or R14 through R15, containing the address of the parameter list defined by the IDSFLV macro.

TYPE
Indicates the length of the file address to be flushed. Specify one of the following:

FA4
Indicates that the address of the file record to be flushed is a 4-byte file address. The address is located in field IFLVFARF of the parameter list defined by the IDSFLV macro.

FA8
Indicates that the address of the file record to be flushed is an 8-byte file address. The address is located in field IFLVFA8 of the parameter list defined by the IDSFLV macro.

Entry Requirements

Return Conditions

Programming Considerations

Examples

None.