gtpc2m95C/C++ Language Support User's Guide

unfrc_ext-Unhold a File Record with Extended Options

This function removes a record from the record hold table (RHT).

Format

#include   <tpfio.h>
void       unfrc_ext(enum t_lvl level, unsigned int ext);

or

#include   <tpfio.h>
void	     unfrc_ext(TPF_DECB *decb, unsigned int ext);

level
One of 16 possible values representing a valid entry control block (ECB) data level from enumeration type t_lvl, expressed as Dx, where x represents the hexadecimal number of the ECB data level (0-F). This argument identifies the FARW containing the file address of the record to be removed from the RHT.

decb
A pointer to a data event control block (DECB). This argument identifies the FARW containing the file address of the record to be removed from the RHT.

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

FIND_GDS
Use FIND_GDS to specify that the record to be removed from the record hold table resides on a general file or general data set. If FIND_GDS is not specified, unfrc_ext accesses the online database.
Note:
If the flag is not needed, the default extended options flag (FIND_DEFEXT) should be coded. In this case, consider using the unfrc function.

Normal Return

Void.

Error Return

Not applicable.

Programming Considerations

Examples

The following example removes the address of the general data set record on level D7 from the record hold table.

#include <tpfio.h>

  ·
  ·
  ·
unfrc_ext(D7,FIND_GDS);

The following example removes the address of the general data set record on a DECB from the record hold table.

#include <tpfio.h>

  ·
  ·
  ·
TPF_DECB *decb;
  ·
  ·
  ·
unfrc_ext(decb,FIND_GDS);

Related Information