gtpo1m4uOperations

ZDTAP-Display the Status of Tape Devices

Use this command to display the status of tape devices.

Requirements and Restrictions

None.

Format




address
is the first 1-3 hexadecimal digits of a tape device address.

name
is the first 1-3 alphanumeric characters of a tape name.

group
is a 1- to 8-character alphanumeric tape group name.

X
displays status information about all the tape devices that are currently configured. This parameter is provided primarily for diagnostic purposes.
Note:
If no tapes are mounted on a tape device (that is, the tape device is available), the information displayed may not be valid. Tape name YYY is displayed for these available tape devices.

Y
displays only the tape devices that do not have any tapes mounted.

M
displays only the tape devices that have automatic tape mounting enabled and not suspended.

G
displays only the tape devices where active tapes are mounted.

S
displays only the tape devices where standby tapes are mounted.

I
displays only the tape devices where input tapes are mounted.

O
displays only the tape devices where output tapes are mounted.

R
displays only the tape devices where real-time tapes are mounted.

Additional Information

Examples

The following information is displayed in the examples:

 ADDRESS 
is the logical address of the tape device.

 NAME 
is the name of the tape mounted on the tape device. If no tape is mounted, AVAIL is displayed or, if you specified the X parameter, YYY is displayed.

 SSU 
is the name of the subsystem user.

 STATUS 
is the status of the tape mounted on the tape device, where:

 A 
Indicates an active tape.

 S 
Indicates a standby tape.

 I 
Indicates an input tape.

 O 
Indicates an output tape.

 * 
Indicates that the tape is being used or modified by the tape routines themselves. (This does not necessarily mean that an I/O operation is being performed.)

 TPIND 
is the contents of the primary, secondary, and tertiary status bytes in the tape status table (TSTB). When set, the status indicators have the following meaning.
Bit Primary Secondary Tertiary
0 Inhibit I/O initiation Reserved Tape write immediate mode
1 Inhibit queue restart Reserved Tape is in compacted format
2 Tape is auxiliary queued Standard user tape label on tape Tape is non-spanned variable blocked format
3 Tape is a standby tape Backward switch in progress Tape device is enabled for automatic tape mounting
4 Tape is reserved Reserved Automatic tape mounting is suspended for the tape device
5 Reserved Not first volume Reserved
6 Tape is offline Tape is an input tape Reserved
7 Tape is closed Tape is labeled Reserved

 VOLSER 
is the volume serial number.

 FORMAT 
is the format of the tape.

 #BLOCKS 
is the number of blocks read from or written to the tape.

 LDR 
indicates the presence of the automatic cartridge loader (ACL) feature. This field contains YES or NO.

The status of all the defined tape devices is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZDTAP                                                                   |
|                                                                                |
|System: COTE0002I 08.27.43 DTAP      - TAPE STATUS                              |
|                                                                                |
|        ADDRESS   NAME   SSU    STATUS   TPIND    VOLSER  FORMAT  #BLOCKS LDR   |
|                                                                                |
|         480      RTA    BSS      AO    00 01 30  A00049  38K           1 YES   |
|         481     AVAIL                                                          |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

All the available tape devices are displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZDTAP Y                                                                 |
|                                                                                |
|System: COTE0002I 10.39.40 DTAP      - TAPE STATUS                              |
|                                                                                |
|        ADDRESS   NAME   SSU    STATUS   TPIND    VOLSER  FORMAT  #BLOCKS LDR   |
|                                                                                |
|         481     AVAIL                                                          |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, status information about the specified tape device is displayed whether that tape device is available or not.

+--------------------------------------------------------------------------------+
|User:   ZDTAP 481 X                                                             |
|                                                                                |
|System: COTE0002I 10.24.48 DTAP      - TAPE STATUS                              |
|                                                                                |
|        ADDRESS   NAME   SSU    STATUS   TPIND    VOLSER  FORMAT  #BLOCKS LDR   |
|                                                                                |
|         481      YYY    BSS      AO    01 01 00  *NONE*  38K           5 YES   |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

All the tape devices where standby tapes are mounted are displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZDTAP S                                                                 |
|                                                                                |
|System: COTE0002I 08.31.44 DTAP      - TAPE STATUS                              |
|                                                                                |
|        ADDRESS   NAME   SSU    STATUS   TPIND    VOLSER  FORMAT  #BLOCKS LDR   |
|                                                                                |
|         481      RTA    BSS      SO    11 01 30  A00050  38K           0 YES   |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

All the tape devices that were assigned to the specified tape group are displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZDTAP -TEST1                                                            |
|                                                                                |
|System: COTE0002I 08.32.08 DTAP      - TAPE STATUS                              |
|                                                                                |
|        ADDRESS   NAME   SSU    STATUS   TPIND    VOLSER  FORMAT  #BLOCKS LDR   |
|                                                                                |
|         480      RTA    BSS      AO    00 01 30  A00049  38K           1 YES   |
|                                                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information

None.