gtpc2m1aC/C++ Language Support User's Guide

crusa-Free Core Storage Block If Held

This function tests the state of one or more entry control block (ECB) data levels or data event control blocks (DECBs) and releases the core block from any that are occupied.

Format

#include   <tpfapi.h>
void       crusa(int count, enum t_lvl level, ...);

or

#include   <tpfapi.h>
void	  crusa(int count, TPF_DECB *decb, ...);

count
An integer containing the number of ECB data level or DECB parameters included in the parameter list.

level
One of 16 possible values representing a valid ECB data level from the enumeration type t_lvl, expressed as Dx, where x represents the hexadecimal number of the level (0-F).

decb
A pointer to a DECB.

Normal Return

Void.

Error Return

Not applicable.

Programming Considerations

Examples

The following example tests ECB data levels D0, D4, DA, and any specified DECBs for working storage blocks, and releases the blocks if present.

#include <tpfapi.h>

  ·
  ·
  ·
TPF_DECB *decb1, *decb2, *decb3;
  ·
  ·
  ·
crusa(3,DA,D0,D4); /* Clear levels D0, D4, DA */
  ·
  ·
  ·
crusa(3, decb1, decb2, decb3); /* release storage block if held by DECB*/

Related Information

See TPF Application Programming for more information about DECBs.