gtpc2m2qC/C++ Language Support User's Guide

filuc-File and Unhold a Record

This function writes a working storage block from an entry control block (ECB) data level to file and releases it from exclusive control (unholds it) from the requesting ECB. The ECB must be holding a storage block on the specified level.

This service files a record to either VFA or DASD.

The filuc function returns the block of storage to the appropriate pool that is referred to in the CBRW at the specified level.

Format

#include   <tpfio.h>
void       filuc(enum t_lvl level);

level
One of 16 possible values representing a valid data level from the enumeration type t_lvl, expressed as Dx, where x represents the hexadecimal number of the level (0-F). The working storage block on this core block reference word (CBRW) level is the record to be filed.

Normal Return

Void.

Error Return

Not applicable.

Programming Considerations

Note:
If a request is waiting to hold the same record, it is serviced by the execution of a storage-to-storage move. This gives the waiting ECB faster access to the record.

Examples

The following example writes the data in the working storage block on level D4 to file and releases the block. On return, the file copy of the record is available to other ECBs.

#include <tpfio.h>

  ·
  ·
  ·
filuc(D0);

Related Information