gtpc2m5rC/C++ Language Support User's Guide

relcc-Release Working Storage Block

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

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.