gtpc2m7iC/C++ Language Support User's Guide

tdspc_q-Display Tape Queue Length

This function returns the module queue length of the specified active tape.

Format

#include      <tpftape.h>
struct tpqstat *tdspc_q(const char *name, enum t_lvl level);

name
This argument is a pointer to type char, which must be a 3-character string identifying the tape whose queue length is to be obtained.

level
This argument identifies the FARW on which the queue length information is to be placed. It can be one of 16 possible values representing a valid data level from the enumeration type t_lvl, expressed as Dx, where x represents the hexadecimal number of the level (0-F).

Normal Return

Pointer to structure tpqstat (defined in tpftape.h) containing the tape queue length. The indicated tape need not be assigned to the issuing ECB.

Error Return

NULL.

Programming Considerations

None.

Examples

The following example calls the tdspc_q function to obtain the queue length of the active "VPH" tape.

#include <tpftape.h>
struct tpqstat *status;

  ·
  ·
  ·
status = tdspc_q("VPH", D0); if (0 == status.q_length) { serrc_op(SERRC_EXIT,0x1234,"VPH TAPE QUEUE EMPTY",NULL) ; }

Related Information

None.