gtpc2m95 | C/C++ Language Support User's Guide |
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
- The record address residing on the FARW specified by the level
or decb parameter must have been placed in the RHT by the calling
ECB. Control is transferred to the system error routine (with exit) if
the address is not in the RHT or the RHT references a different ECB.
- When the file address returns from the unfrc_ext call, it
appears to be unheld from the point of view of the program. For
requests from outside the commit scope, the file address still appears to be
held. When the commit is completed successfully, the file address will
be unheld and any waiting requests will be serviced.
- Applications that call the function using DECBs instead of ECB data levels
must be compiled with the C++ compiler because this function has been
overloaded.
- This function is implemented in dynamic link library (DLL)
CTAD. You must use the definition side-deck for DLL CTAD to link-edit
an application that uses this function.
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