gtpg2m46General Macros

TDSPC-Display Tape Status

The Display Tape Status macro provides the status of the specified tape or the module queue length of a specified active tape.

Format




label
A symbolic name can be assigned to the macro statement.

NAME
Specifies the symbolic general or real-time tape name. It can be:

ccc
A 3-character string representing a symbolic general or real time tape name. The first two characters must be alphabetic, and the third character must be alphabetic or numeric.

(Rn)
The number of a register containing a pointer to the symbolic real-time tape name. n must be a decimal number from 0 through 7, 14, or 15.

STATUS
Specifies status of the tape. It can be:

A
For an active tape.

S
For a standby tape. Do not code S with the option FORMAT=QUEUE.

LEVEL=Dn
A symbolic data level (D0-DF) must be specified.

FORMAT
Specifies the information returned. It can be:

TPIND
Returns the status of the tape.

QUEUE
Returns the module queue length of the tape.

The default is FORMAT=TPIND. The STATUS=S and FORMAT=QUEUE options are not allowed to be specified in the same macro call.

The following macro format is still supported:



Notes:

  1. tapename

  2. status

  3. data_level

label
A symbolic name can be assigned to the macro statement.

tapename
A 3-character symbolic tape name must be specified as the first parameter. This parameter is required. There is no default.

status
Active or standby status must be specified as the second parameter. This parameter must be coded as either A or S. This parameter is required. There is no default.

data_level
A symbolic data level (D0-DF) must be specified as the third parameter. This parameter is required. There is no default.

Entry Requirements

R9 must contain the address of the ECB being processed.

Return Conditions

Programming Considerations

  1. This macro can be executed on any I-stream.
  2. Both keyword and positional parameters may be used in the same macro call. This practice is not recommended.
  3. If the tape status table does not contain an entry for the specified tape, the FARW is set to zeroes.
  4. Any unused bits in the status indicators are set to 0.
  5. The 2 bytes of status indicators returned by the FORMAT=TPIND form of this macro are not necessarily the primary and secondary status bytes from the tape status table. The definitions of the indicators returned by this macro will remain constant, while the primary and secondary status bytes in the tape status table can be redefined.
  6. The STATUS=S and FORMAT=QUEUE options are not allowed to be specified in the same macro call.

Examples

None.