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
- The routine invoking the FLVFC macro must build a parameter list as
defined by the IDSFLV macro and pass the parameter list address in the
register specified by the REG parameter.
- If MCHR=YES is specified, the TYPE parameter is ignored because the record
is specified in the hardware address format and must be present in fields
IFLVMOD and IFLVCHR as defined in the IDSFLV macro.
Return Conditions
Programming Considerations
Examples
None.