Displaying tape volume status

Use the DISPLAY command to display tape volume status. The syntax of the DISPLAY command follows:


>>-+-DISPLAY-+--SMS,--+-VOLUME-+--(volser)---------------------->
   '-D-------'        '-VOL----'             

>--+----------------+------------------------------------------><
   '-,L=-+-a------+-'   
         +-name---+     
         '-name-a-'

VOLUME | VOL(volser): Displays the status of the requested tape volume. There is no option to display all tape volumes known to the system; however, you may use ISMF panels to display a list of tape volumes.
Specifying volser displays the status of the requested tape volume.
,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 volume status, enter the following command:

     DISPLAY SMS,VOLUME(volser)

The following information is displayed:

CBR1180I OAM tape volume status:
VOLUME    MEDIA     STORAGE   LIBRARY   USE  W   C   SOFTWARE  LIBRARY 
          TYPE      GROUP     NAME      ATR  P   P   ERR STAT  CATEGORY
volser    medtype   sgname    libname   u    x   y   errstat   category
-----------------------------------------------------------------------
RECORDING TECH:     aaaaaaaaaa         COMPACTION:         bbbbbbbbbb
SPECIAL ATTRIBUTE:  cccccccccc         ENTER/EJECT DATE:   hhhhhhhhhh
CREATION DATE:      dddddddddd         EXPIRATION DATE:    eeeeeeeeee
LAST MOUNTED DATE:  ffffffffff         LAST WRITTEN DATE:  gggggggggg
SHELF LOCATION:     shelfloc                                                 
OWNER:  owner information                                                    
LM SG:  iiiiiiii  LM SC:  jjjjjjjj  LM MC:  kkkkkkkk  LM DC:  llllllll
-----------------------------------------------------------------------
[statuslines]

The fields displayed in each data line are as follows:

volser

Volume serial number of the requested tape volume.

medtype

Media type of the tape volume, as follows:

MEDIA1: IBM Cartridge System Tape
MEDIA2: IBM Enhanced Capacity Cartridge System Tape
MEDIA3: IBM High Performance Cartridge Tape
MEDIA4: IBM Extended High Performance Cartridge Tape
MEDIA5: IBM Enterprise Tape Cartridge
MEDIA6: IBM Enterprise WORM Tape Cartridge
MEDIA7: IBM Enterprise Economy Tape Cartridge
MEDIA8: IBM Enterprise Economy WORM Tape Cartridge
MEDIA9: IBM Enterprise Extended Tape Cartridge
MEDIA10: IBM Enterprise Extended WORM Tape Cartridge
MEDIA11: IBM Enterprise Advanced Tape Cartridge
MEDIA12: IBM Enterprise Advanced WORM Tape Cartridge
MEDIA13: IBM Enterprise Advanced Economy Tape Cartridge
UNKNOWN: No media type specified
INVALID: Media type specified is not valid

sgname

Name of the storage group to which the tape volume belongs.

libname

Name of the library in which the tape volume resides. If the volume resides outside a library, this field contains SHELF.

u

Tape volume use attribute, as follows:

P: Private use attribute
S: Scratch use attribute

x

Tape volume write protection status, as follows:

Y: Write protected
N: Not write protected
blank: Write protection status unknown

y

Tape volume checkpoint status, as follows:

Y: Secure checkpoint volume
N: Not a secure checkpoint volume
blank: Checkpoint status unknown

errstat

The software recorded volume error status, as follows (the longer names are displayed through the ISMF Mountable Volume Application):

ANSILAB (ANSI LABEL VOLUME): ANSI label not supported.
CHECKPT (CHCKPOINT CONFLICT): Attempt to access secure checkpoint volume.
DAMAGED (CARTRIDGE DAMAGED): Cartridge is physically damaged and leader block may be missing.
DUPMOUNT (DUPLICATE VOLSER): Volume with same volser already mounted.
EXTLABEL (EXTERNAL LABEL ERR): External label missing or unreadable.
INACCESS (INACCESSIBLE): Volume inaccessible in library.
INTLABEL (I/O ERROR): Volume label cannot be read.
LABTYPE (INVALID LABEL TYPE): Invalid volume label type, neither standard nor ANSI.
LNGTHERR (TAPE TOO LONG): Cartridge length exceeds IBM supported maximum.
MEDIAMNT (MEDIA TYP MISMATCH): Mounted media does not match the type specified for a scratch volume mount request.
MED2MNT (MEDIA2 ON 3480X): MEDIA2 cartridge mounted on a non-MEDIA2 capable device.
MISSING (VOLUME MISPLACED): Volume not in assigned location in library.
NOERROR (NO ERROR): No errors detected.
NOMATCH (VOLSER MISMATCH): Internal and external labels do not match.
NOTINLIB (NOT IN LIBRARY): Volume not in library manager inventory.
PASSPROT (PASSWORD CONFLICT): Attempt to access password-protected volume.
RACFPROT (SECURITY CONFLICT): Attempt to access SAF/RACF-protected volume.
REJTMS (REJ BY TAP MGT SYS): Volume rejected by the tape management system.
REJUSER (REJECTED BY USER): Volume rejected by the user’s DCB exit or label editing routine.
TRKCMPAT (INCMPAT_TRK_MOUNT): Media was mounted whose recording technology is incompatible with the device.
UNEXPIR (UNEXPIRED SCRATCH): Attempt to write over unexpired data.
UNFORMAT (UNFORMATTED MEDIA): Volume has not been formatted with servo tracks and should be returned to the media manufacturer.
UNKNOWN (??????????????????): Volume error status unknown.
WRITPROT (WRITE CONFLICT): Attempt to write on write-protected volume.
WRONGVOL (WRONG VOLUME): Library mounted different volume when this volume was requested.

category

Library category to which the volume is assigned, as follows:

BADTOKEN: The library has determined that the tokens associated with this volume have been corrupted.
BLKEJECT: Volume is to be ejected to the bulk output station.
CONVEJCT: Volume is to be ejected to a convenience output station.
ERROR: An error has been detected by software during an attempt to mount this scratch volume.
EXPORTED: The logical volume has been exported onto a stacked volume, but export completion processing has not occurred at the host.
EXPPEND: The export of the logical volume is pending in the library.
INSERT: Volume has been put into the library, but has not yet been processed by software cartridge entry.
MANEJECT: Volume has been manually removed from the library. Volumes in this category are not processed by the host and remain in this category.
NONE: The volume does not reside in an automated tape library.
NOTAVAIL: OAM display processor was unable to obtain the volume data record from the tape library.
PRIVATE: Volume contains useful data and may be requested only by specific volser reference.
SCRMED1: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library category for scratch volumes of media type MEDIA1.
SCRMED2: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library category for scratch volumes of media type MEDIA2.
SCRMED3: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA3.
SCRMED4: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA4.
SCRMED5: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA5.
SCRMED6: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA6.
SCRMED7: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA7.
SCRMED8: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA8.
SCRMED9: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA9.
SCRMED10: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA10.
SCRMED11: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA11.
SCRMED12: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA12.
SCRMED13: Volume contains no useful data and may be requested only by nonspecific volser reference. The volume resides in the library manager category for scratch volumes of media type MEDIA13.
UNKNOWN: Hardware category is not recognized by software.

aaaaaaaaaa

Recording technology used to record the tape:

18 TRACK: 18-track recording mode
36 TRACK: 36-track recording mode
128 TRACK: 128-track recording mode
256 TRACK: 256-track recording mode
384 TRACK: 384-track recording mode
EFMT1: Enterprise Format 1 recording mode
EFMT2: Enterprise Format 2 recording mode
EEFMT2: Enterprise Encrypted Format 2 recording mode
EFMT3: Enterprise Format 3 recording mode
EEFMT3: Enterprise Encrypted Format 3 recording mode
EFMT4: Enterprise Format 4 recording mode
EEFMT4: Enterprise Encrypted Format 4 recording mode
UNKNOWN: Recording mode not specified
INVALID: Recording technology specified is invalid

bbbbbbbbbb

Compaction mode set during recording:

YES: Compaction
NO: No compaction
UNKNOWN: Compaction not specified
INVALID: Compaction specified is invalid

cccccccccc

Volume special attribute:

RDCOMPAT: Volume used for read-only. All read-compatible devices are eligible.
NONE: Volume has no special attribute.
INVALID: Special attribute specified is invalid.

dddddddddd

Date the volume record in the TCDB catalog was initially created, in ISO date format YYYY-MM-DD.

eeeeeeeeee

Expiration date of the tape volume, in ISO date format YYYY-MM-DD.

ffffffffff

Date the volume was last mounted, in ISO date format YYYY-MM-DD.

gggggggggg

Date a data set was last opened for output on the volume, in ISO date format YYYY-MM-DD.

hhhhhhhhhh

Date the volume was last entered into or ejected from a tape library, in ISO date format YYYY-MM-DD.

shelfloc

Shelf location where the tape volume is stored if the volume resides outside a library; otherwise, this is the shelf location where the volume is stored when it is ejected from the library.

owner information

Owner information associated with the tape volume.

OAM displays the following four fields only if the library supports outboard policy management. These fields display the library manager policy names. If any of the storage group, storage class, management class, or data class constructs are set to the default policy names, then blanks appear for the policy names. If an error occurs and the library manager policy names cannot be obtained for the volume, NOTAVAIL shows in the library manager policy name fields.

iiiiiiii

Library manager storage group name.

jjjjjjjj

Library manager storage class name.

kkkkkkkk

Library manager management class name.

llllllll

Library manager data class name.

status lines

Additional tape volume status messages, as follows:

Audit operation queued in host
Audit operation queued in library
Audit operation in progress in library
Eject operation queued in host
Eject/Export operation queued in library
Eject/Export operation in progress in library
Mount operation queued in library
Mount operation in progress in library
Volume mounted on library-resident drive
Demount operation queued in library
Demount operation in progress in library
Volume inaccessible in library
Volume misplaced in library
External label missing or unreadable
Volume used during manual mode
Logical volume
Volume is cache resident
Valid copy in each distributed library
Dual copy exists in the library
Volume is WORM tape
Volume is logical WORM

Note:

The “Dual copy exists in the library” status line is only displayed for the stand-alone VTS. Although a dual copy might exist in each PtP VTS distributed library, this status line will not be displayed.
To differentiate between logical and physical WORM, "Volume is WORM tape" will be displayed for a physical WORM volume and "Volume is logical WORM" will be displayed for a logical WORM volume. In addition to this, since a logical volume will retain its WORM state (at the library) until the volume is reused and written from load point; this status line can also be displayed for a scratch volume, reflecting the past usage of the volume.

The following is sample output of the DISPLAY SMS,VOLUME(LOG001) command:

CBR1180I OAM tape volume status:
VOLUME   MEDIA   STORAGE   LIBRARY   USE   W   C   SOFTWARE    LIBRARY 
         TYPE    GROUP     NAME      ATR   P   P   ERR  STAT   CATEGORY
LOG001   MEDIA2  TAPESG2   LIBVTS1   P     N   N   NOERROR     PRIVATE 
-----------------------------------------------------------------------
RECORDING TECH:     36 TRACK         COMPACTION:         NO            
SPECIAL ATTRIBUTE:  NONE             ENTER/EJECT  DATE:  2008-05-08    
CREATION DATE:      2008-05-08       EXPIRATION DATE:    2009-12-31    
LAST MOUNTED DATE:  2011-05-08       LAST WRITTEN DATE:  2011-05-08    
SHELF LOCATION:                                                        
OWNER:  JEAN SCHILTZ, 9032/2648, IBM CORPORATION, TUCSON, AZ           
LM SG:  TAPESG2   LM SC:  TAPESC2   LM MC:  TAPEMC2   LM DC:  MEDIA2DC 
-----------------------------------------------------------------------