gtpc2m5l | C/C++ Language Support User's Guide |
This macro returns a working storage block to the system and removes a
record from the record hold table.
Format
#include <tpfio.h>
void rcunc (enum t_lvl level);
or
#include <tpfio.h>
void rcunc (TPF_DECB *decb);
- 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 level
(0-F). This parameter identifies the data level containing the
address of the working storage block to be returned and the address of the
file record to be unheld.
- decb
- A pointer to a data event control block (DECB). This parameter
identifies the DECB containing the address of the working storage block to be
returned and the address of the file record to be unheld.
Normal Return
Void.
Error Return
Not applicable.
Programming Considerations
- The specified ECB data level or DECB must be occupied with a valid working
storage block address and the record address on the specified ECB data level
or DECB must have been placed in the record hold table (RHT) by the calling
ECB.
- Applications that call this function using DECBs instead of ECB data
levels must be compiled with the C++ compiler because this function has been
overloaded.
Examples
The following example releases a core block and unholds the record from
data level 2.
#include <tpfapi.h>
#include <tpfio.h>
·
·
·
rcunc(D2); /* Release block and unhold record */
The following example releases a core block and unholds the record from a
DECB.
#include <tpfapi.h
#include <tpfio.h>
·
·
·
TPF_DECB *decb;
·
·
·
rcunc(decb); /* Release block and unhold record */
Related Information
See TPF Application Programming for more
information about DECBs.