gtpc2m56C/C++ Language Support User's Guide

numbc-Query Number of Storage Blocks Available

This function returns the number of blocks currently available for a specified physical block type.

Format

#include   <sysapi.h>
int        numbc(enum p_blktype block_type);

block_type
One of possible values representing a valid physical block type: LIOCB, L3, LECB, LSWB, LCOMMON, LFRAME or LMAX.

Normal Return

Integer value representing the number of available storage blocks for this block type.

Error Return

Not applicable.

Programming Considerations

Authorization to issue a restricted macro is required.

Examples

The following example obtains the number of available IOB blocks.

#include <sysapi.h>
int  iobs;

  ·
  ·
  ·
iobs = numbc(LIOCB);

Related Information

None.