gtpc2m2rC/C++ Language Support User's Guide

filuc_ext-File and Unhold a Record with Extended Options

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_ext 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_ext(enum t_lvl level, unsigned int ext);

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.

ext
Sum of the following bit flags, that are defined in tpfio.h.

FILE_GDS
Use FILE_GDS to specify that the record to be filed and unheld resides in a general file or general data set. If FILE_GDS is not specified, filuc_ext accesses the record on the online database.

FILE_NOTAG
The TPF system code that places the program identification in the record header is bypassed. This flag should only be used when the application updating the record has placed the required program identification in the header directly.
Note:
If neither of the above flags are needed the default extended options flag, FILE_DEFEXT, should be coded. Consider using the filuc function.

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 D7 to a general data set, bypasses the record header update, and releases the block.

#include <tpfio.h>

  ·
  ·
  ·
filuc_ext(D7,FILE_GDS|FILE_NOTAG);

Related Information