gtpc2m5r | C/C++ Language Support User's Guide |
This function returns a working storage block to the system.
Format
#include <tpfapi.h>
void relcc(enum t_lvl level);
or
#include <tpfapi.h>
void relcc(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 core block reference word
(CBRW) containing the address of the working storage block to be returned to
the system.
- decb
- A pointer to a data event control block (DECB). This parameter
identifies the CBRW containing the address of the working storage block to be
returned to the TPF system.
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 other control information when the function is
called; otherwise, a system error with exit results.
- 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.
- 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 tests for, then releases, a working storage block on
level DB.
#include <tpfapi.h>
·
·
·
if (levtest(DB))
relcc(DB);
The following example tests for, and then releases, a working storage block
held in a DECB.
#include <tpfapi.h>
·
·
·
TPF_DECB *decb;
·
·
·
if (levtest(decb))
relcc(decb);
Related Information
See TPF Application Programming for more
information about DECBs.