gtpc2m5zC/C++ Language Support User's Guide

rlcha-Release Chained File Records

This function releases chained pool record addresses from the record first specified through the end of chain using standard TPF record headers. The input argument hdr may point at any standard header. The record ID and the record code check for all records in the chain must match the header pointed to by hdr.

Format

#include   <tpfapi.h>
void       rlcha(struct stdhdr *hdr);

or

#include   <tpfapi.h>
#include   <c$std8.h>
void       rlcha(struct istd8 *hdr);

hdr
This argument is a pointer to struct stdhdr (see tpfapi.h) or struct istd8 (see c$std8.h), which describe the TPF standard record header.

Normal Return

Void.

Error Return

Not applicable.

Programming Considerations

Examples

The following example starts the release of the chain of pool record addresses beginning with the address found in the standard header on level D5.

#include <tpfapi.h>
struct stdhdr *cp0hdr;

  ·
  ·
  ·
cp0hdr = ecbptr()->ce1cr5; rlcha(cp0hdr);

The following example starts the release of the chain of pool record addresses beginning with the address found in the 8-byte standard header on the DECB pointed to by decb_ptr.

#include <tpfapi.h>
#include <istd8.h>
#include <i$decb.h>
 
TPF_DECB *decb_ptr;
DECBC_RC rc;
struct istd8* block_header
 
decb_ptr = tpf_decb_create( NULL, &rc );

·
·
·
block_header = (istd8 *)decb_ptr->idecdad; rlcha( block_header );

Related Information