gtpg2m25General Macros

FILUC-File and Unhold a Record

This general macro writes a record to a file from storage and releases it from the exclusive control of the entry control block (ECB). The block of storage referred to at the specified ECB data level or data event control block (DECB) is removed from the ECB. The control program writes the record on the primary copy and the duplicate copy if one exists. This macro can be used to file a record that resides in either a virtual file access (VFA) or on an external device, depending on the system configuration. (See virtual file access information in TPF Database Reference for details of how FILUC processes a VFA record.)

The file address contained in the specified file address reference word (FARW) is released. Sometimes in TPF documentation the word unhold is used to mean released.

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.

TAG
Specify one of the following:

Y
The name of the segment that issued the FILUC is put into the storage block to be filed.

N
This field is not set.

The default is Y.

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.