Displaying tape drive status

Use the MVS LIBRARY DISPDRV command to display the status of any of the following combination of drives:

All tape drives in a tape library
A single tape drive
A number of tape drives
A range of tape drives

You can also use the MVS DISPLAY UNIT command, the MVS DEVSERV command or the JES3 *I,D command to display the status of tape drives within a tape library. See z/OS MVS System Commands for additional information on the specific MVS command.

The syntax of the LIBRARY DISPDRV command to display tape drive status is as follows:


>>-+-LIBRARY-+--+-DISPDRV-+--,---------------------------------->
   '-LI------'  '-DD------'      

>--+-library_name--------------------+--+----------------+-----><
   +-device_number-------------------+  '-,L=-+-a------+-'   
   +-device_number,number_of_devices-+        +-name---+     
   '-device_number1-device_number2---'        '-name-a-'

DISPDRV | DD: Specifies a request to display tape drive status.
library_name: Specifies the name of the tape library whose tape drives are to be displayed. However, the maximum number of tape drives that is displayed does not exceed 4096.
device_number: Specifies the MVS tape device number to be displayed.
number_of_devices: Specifies the number of devices to be displayed. However, the maximum number of tape drives that is displayed does not exceed 4096.
device_number1: Specifies the first MVS tape device number to be displayed.
device_number2: Specifies the last MVS tape device number to be displayed. However, the maximum number of tape drives that is displayed does not exceed 4096.
,L={a | name | name-a}: Specifies where to display the results of the inquiry: the display area (L=a), the console name (L=name), or both the console name and the display area (L=name-a). The name parameter can be an alphanumeric character string.

To display tape drive status, enter the following command:

     LIBRARY DISPDRV,(library_name)

The following information is displayed:

CBR1220I Tape drive status:
DRIVE     DEVICE  LIBRARY  ON   OFFREASN     LM   ICL      ICL   MOUNT
NUM       TYPE    NAME          LI  OP  PT   AV   CATEGRY  LOAD  VOLUME
devnum   devtyp  libname    b    c   d   e    f   ggggggg     h  mntvol

The fields in the data line are defined as follows:

devnum

The tape device number.

devtyp

Name of the tape device type as follows:

3480: Reads and writes using 18-track recording technique on MEDIA1 cartridges. Not capable of compaction.
3480x: Reads and writes using 18-track recording technique on MEDIA1 cartridges. Capable of compaction.
3490: Reads 18-track and 36-track recording technique on MEDIA1 and MEDIA2 cartridges. Writes using 36-track recording technique on either MEDIA1 or MEDIA2 cartridges. Capable of compaction.
3590-1: Reads and writes using 128-track recording technique on MEDIA3 or MEDIA4 cartridges. Capable of compaction.
3590-E: Reads 128-track and 256-track recording technique on MEDIA3 and MEDIA4 cartridges. Writes using 256-track recording technique on either MEDIA3 or MEDIA4 cartridges. Capable of compaction. 3590-E is used in this display to represent the 3590-E1x family of 3590 tape devices and is not a system defined esoteric.
3590-H: Reads 128-track, 256-track, and 384-track recording technique on MEDIA3 and MEDIA4 cartridges. Writes using 384-track recording technique on either MEDIA3 or MEDIA4 cartridges. Capable of compaction. 3590-H is used in this display to represent the 3590-H1x family of 3590 tape devices and is not a system defined esoteric.
3592-J: Reads and writes using the enterprise format 1 (EFMT1) recording technology on MEDIA5, MEDIA6, MEDIA7, and MEDIA8 cartridges. Capable of compaction. 3592-J is used in the display to represent the 3592 Model J1A tape device and is not a system defined esoteric.
3592-2: Reads and writes Enterprise Format 1 (EFMT1) and Enterprise Format 2 (EFMT2) recording techniques on MEDIA5, MEDIA6, MEDIA7, and MEDIA8 cartridges. Reads and writes Enterprise Format 2 (EFMT2) recording technique on MEDIA9 and MEDIA10 cartridges. Capable of compaction. 3592-2 is used in this display to represent the 3592 Model E05 devices and is not a system defined esoteric.
3592-2E: Reads and writes Enterprise Format 1 (EFMT1), Enterprise Format 2 (EFMT2), and Enterprise Encrypted Format 2 (EEFMT2) recording techniques on MEDIA5, MEDIA6, MEDIA7, and MEDIA8 cartridges. Reads and writes Enterprise Format 2 (EFMT2) and Enterprise Encrypted Format 2 (EEFMT2) recording techniques on MEDIA9 and MEDIA10 cartridges. Capable of compaction. 3592-2E is used in this display to represent the encryption-capable 3592 Model E05 devices and is not a system defined esoteric.
3592-3E: Reads and writes Enterprise Format 2 (EFMT2), Enterprise Encrypted Format 2 (EEFMT2), Enterprise Format 3 (EFMT3), and Enterprise Encrypted Format 3 (EEFMT3) recording techniques on MEDIA5, MEDIA6, MEDIA7, MEDIA8, MEDIA9, and MEDIA10 cartridges. Also reads Enterprise Format 1 (EFMT1) formatted cartridges on MEDIA5, MEDIA6, MEDIA7, and MEDIA8 cartridges. Capable of compaction. 3592-3E is used in this display to represent the 3592 Model E06 devices and is not a system-defined esoteric.
3592-4E: Reads and writes Enterprise Format 3 (EFMT3) and Enterprise Encrypted Format 3 (EEFMT3) formatted cartridges on MEDIA9 and MEDIA10 cartridges and Enterprise Format 4 (EFMT4) and Enterprise Encrypted Format 4 (EEFMT4) formatted cartridges on MEDIA9, MEDIA10, MEDIA11, MEDIA12, and MEDIA13 cartridges. Also, capable of reading Enterprise Format 2 (EFMT2) and Enterprise Encrypted Format 2 (EEFMT2) formatted cartridges MEDIA9 and MEDIA10 cartridges and media types MEDIA5 through MEDIA8 (EFMT1, EFMT2, EEFMT2, EFMT3, and EEFMT3). Capable of compaction. 3592-4E is used in this display to represent the 3592 Model E07 devices and is not a system-defined esoteric.
3400: This is a 3400 magnetic tape drive.
UNKNOWN: Tape device is not recognized.

Whether a device defined through HCD is real or emulated is not determined until successful communication to the device has been made. Until successful communication has been made, the device type displayed will reflect the device type defined through HCD. Thus for emulated devices, beginning with the 3590 Model E, the device type displayed reflects the emulated device type defined through HCD rather than the real underlying device type (3590-E, 3590-H, 3592-J, 3592-2, 3592-2E 3592-3E, and 3592-4E). Once successful communication to the device has been established, the device type displayed will reflect the real underlying device type.

Also, on system levels that support the emulated device type defined through HCD, but do not support the real underlying device type (such as the 3590 Model E, 3590 Model H, 3592 Model J, 3592 Model E05, 3592 Model E06, or 3592 Model E07), the device type displayed reflects the emulated device type that is defined through HCD.

libname

Name or ID of the library in which the tape drive resides. For a stand-alone tape drive (nonlibrary-resident drive), this field contains ‘--N/A--’.

The library name is stored during OAM initialization (or during library VARY processing) for those devices in the library returned by device services. If, after this process, devices in a subsystem are subsequently varied online, the library name displayed may reflect the LIBRARY-ID. As long as the correct library name or library ID is displayed, having the LIBRARY-ID appear in the display should not pose a problem. See Creating the hardware configuration for more information.

b

Tape drive status.

Y: Online.
N: Offline.
P: Pending Offline.

Note: A device can be offline with none of the reason indicators below being set. For example, if a device goes through IOS recovery and the device ends up getting boxed, the reason indicator may not be set.

c

Tape drive is offline for library reasons:

Y: The library in which the tape drive resides is offline.
N: The library in which the tape drive resides is online.
—: The tape drive does not reside in a tape library.

d

Tape drive is offline for operator reasons:

Y: You have varied the tape drive offline, or you have defined the device offline at initialization.
N: You have varied the tape drive online.

e

Tape drive is offline for path reasons:

Y: All channel paths to the tape drive are offline.
N: At least one channel path to the drive is online.

f

Library Manager device availability status:

A: The tape drive is available at the Library Manager.
U: The tape drive is unavailable at the Library Manager.
—: The tape drive does not reside in an automated tape library, or the library manager drive status is unknown.

ggggggg

Cartridge loader scratch media category:

MEDIA1: The cartridge loader of the tape drive is set to load with MEDIA1 scratch tapes if available.
MEDIA2: The cartridge loader of the tape drive is set to load with MEDIA2 scratch tapes if available.
MEDIA3: The cartridge loader of the tape drive is set to load with MEDIA3 scratch tapes if available.
MEDIA4: The cartridge loader of the tape drive is set to load with MEDIA4 scratch tapes if available.
MEDIA5: The cartridge loader of the tape drive is set to load with MEDIA5 scratch tapes if available.
MEDIA6: The cartridge loader of the tape drive is set to load with MEDIA6 scratch tapes if available.
MEDIA7: The cartridge loader of the tape drive is set to load with MEDIA7 scratch tapes if available.
MEDIA8: The cartridge loader of the tape drive is set to load with MEDIA8 scratch tapes if available.
MEDIA9: The cartridge loader of the tape drive is set to load with MEDIA9 scratch tapes if available.
MEDIA10: The cartridge loader of the tape drive is set to load with MEDIA10 scratch tapes if available.
MEDIA11: The cartridge loader of the tape drive is set to load with MEDIA11 scratch tapes if available.
MEDIA12: The cartridge loader of the tape drive is set to load with MEDIA12 scratch tapes if available.
MEDIA13: The cartridge loader of the tape drive is set to load with MEDIA13 scratch tapes if available.
X'xxxx': The hexadecimal value of the assigned category is not recognized by this system.
NONE: For devices in an ATLDS, no category is assigned to the cartridge loader, and the cartridge loader is emptied. For devices in an MTL, indexing does not occur on this system; however, indexing may occur on other systems that own the volumes in the cartridge loader.
ANY: The cartridge loader may be loaded with any valid media type. This is only applicable for devices that reside in an MTL.
--N/A--: The tape drive does not reside in an automated tape library, or the library manager drive status is unknown.

h

Volume loaded in the cartridge loader.

Y: At least one volume has been loaded in the cartridge loader.
N: No volume has been loaded in the cartridge loader.
—: The tape drive does not reside in an automated tape library dataserver, or the library manager drive status is unknown.

mntvol

If there is no mounted volume, or this is not a library-resident drive, or the library manager drive status is unknown, then this field is left blank.

Additional information may appear containing one or more of the following messages:

Starting device number is not a tape device.
Number of tape devices requested exceeds 4096; 4096 displayed.
Number of tape devices requested exceeds the number available.
No tape devices within display criteria.

The following is a sample display of the LIBRARY DISPDRV,(ATLF4017) command:

CBR1220I Tape drive status:
DRIVE  DEVICE   LIBRARY ON  OFFREASN  LM  ICL      ICL   MOUNT
NUM    TYPE     NAME        LI OP PT  AV  CATEGRY  LOAD  VOLUME
0FC0   3490     ATLF4017 Y  N  N  N   A   NONE     N     TST211
0FC1   3490     ATLF4017 N  N  Y  N   A   NONE     N
0FD0   3590-E   ATLF4017 Y  N  N  N   A   NONE     N     TST256
0FD1   3590-E   ATLF4017 Y  N  N  N   A   NONE     N     
0FD2   3590-E   ATLF4017 Y  N  N  N   A   NONE     N     
0FD3   3590-E   ATLF4017 Y  N  N  N   A   NONE     N     
0FF0   3590-H   ATLF4017 Y  N  N  N   A   NONE     N     TST384
0FF1   3590-H   ATLF4017 Y  N  N  N   A   NONE     N     
0FF2   3590-H   ATLF4017 Y  N  N  N   A   NONE     N     
0FF3   3590-H   ATLF4017 Y  N  N  N   A   NONE     N     
0FE0   3590-1   ATLF4017 Y  N  N  N   A   NONE     N     TST500
0FE1   3590-1   ATLF4017 Y  N  N  N   A   NONE     N
0FE2   3590-1   ATLF4017 Y  N  N  N   A   NONE     N
0FE3   3590-1   ATLF4017 Y  N  N  N   A   NONE     N