gtpc2m5lC/C++ Language Support User's Guide

rcunc-Release Core Block and Unhold File Record

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

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.