Displaying library detail status

To display detailed status for all libraries, enter the following command:

     DISPLAY SMS,LIBRARY(ALL),DETAIL

The following information is displayed:

CBR1110I OAM library status:
TAPE     LIB   DEVICE   TOT    ONL     AVL    TOTAL    EMPTY   SCRTCH   ON OP
LIBRARY  TYP   TYPE     DRV    DRV     DRV    SLOTS    SLOTS   VOLS
tlibname typ   tdevtype llll   mmmm    nnnn  ooooooo  ppppppp  qqqqqqq  r  s

The fields in the data line are defined as follows:

tlibname

The name of the tape library.

typ

The tape library type, as follows:

AL: Automated tape library
ML: Manual tape library
VL: Virtual Tape Server
VCL: Peer-to-Peer VTS or Virtualization Engine Composite Library
VDL: Peer-to-Peer VTS or Virtualization Engine Distributed Library
UNK: Software was unable to communicate with the tape library to obtain the tape library type.

tdevtyp

For an automated tape library (including a virtual tape library), the tape library device type is displayed as DDDD-MMM, where DDDD is the device type of the library, and MMM is the model. For a composite library that is part of a multi-cluster grid, the distributed libraries should be displayed for the underlying machine and model types. “GRID” may be displayed for the composite library’s device type. For a manual tape library, “MANUAL” is displayed.

llll

Total number of tape drives, known to the current system, residing in the tape library.

mmmm

Total number of tape drives, known to the current system and residing in the tape library, that are online.

nnnn

Total number of tape drives, known to the current system and residing in the tape library, that are online and not allocated.

ooooooo

Total number of storage slots in the tape library dataserver. For a library that resides in a 3584 tape library, the storage slot count is associated with a particular logical library. For other tape libraries, the storage slot count reflects the number of storage slots in the entire physical library. Also, starting with Release 1.5 of the Start of change

TS7700, when the TS7700 (with physical tape attached) End of change

is installed in a 3584 tape library (with ALMS), the distributed library no longer surfaces the physical slot information and instead surfaces virtual slot information. For a TS7680, this count displays the maximum number of logical volumes that can be defined to the library.

ppppppp

Total number of empty slots in the tape library dataserver. For a TS7680, this count displays the number of logical volumes that can still be defined to the library.

qqqqqqq

Total number of scratch volumes of all media types in the tape library.

r

The tape library online status, as follows:

Y: Online
N: Offline
P: Pending offline

s

The tape library operational status, as follows:

Y: Operational
N: Not operational

If ALL and DETAIL are specified with the LIBRARY keyword and both optical libraries and tape libraries are defined in the SMS configuration, two messages are displayed. The first display contains optical library information. The second display contains the tape library information similar to that shown below.

The following is a sample of DISPLAY SMS,LIBRARY(ALL),DETAIL command where only tape libraries are defined:

CBR1110I OAM library status:
TAPE       LIB  DEVICE   TOT  ONL   AVL   TOTAL   EMPTY   SCRTCH  ON  OP
LIBRARY    TYP  TYPE     DRV  DRV   DRV   SLOTS   SLOTS     VOLS
ATL1000L   AL   3494-L10   6    6     6     621      12      234   Y   Y
ATL1001L   AL   3495-L50  64   52    12   13580    6459     5266   P   Y
MTL1002L   ML   MANUAL    16   10     6       0       0      243   Y   Y
ATL20003   VCL  3494-L10  64   60    48       0       0       19   Y   Y
ATL20004   VDL  3494-L10   0    0     0     416     223        0   Y   Y
ATL20005   VDL  3494-L10   0    0     0     416     253        0   Y   Y
VTSBA008   VL   3494-L10   4    4     4    1443      31      146   Y   Y

To display detailed status for a particular tape library, enter the following command:

     DISPLAY SMS,LIBRARY(library_name),DETAIL

The following additional information appears concerning the requested library:

------------------------------------------------------------------------
MEDIA       SCRATCH       SCRATCH       SCRATCH
TYPE          COUNT     THRESHOLD      CATEGORY
------------------------------------------------------------------------
DISTRIBUTED LIBRARIES: 
COMPOSITE LIBRARY: 
------------------------------------------------------------------------
LIBRARY ID:
CACHE PERCENTAGE USED: 
OPERATIONAL STATE:  {AUTOMATED | PAUSED | MANUAL MODE}
ERROR CATEGORY SCRATCH COUNT:
SCRATCH STACKED VOLUME COUNT:
PRIVATE STACKED VOLUME COUNT:
CORRUPTED TOKEN VOLUME COUNT:
HIGH CAPACITY INPUT STATION CAPACITY:
HIGH CAPACITY OUTPUT STATION CAPACITY:
-------------------------------------------------------------------
[statuslines]

The media type, scratch count, scratch threshold, and scratch category lines are displayed only for media that have a threshold value or a scratch count greater than zero. The scratch category counts displayed are returned from the library and reflect the number of usable scratch volumes. The counts displayed do not include volumes assigned to the software error category or volumes in the VTS that are in a delete-expire-hold state. Therefore, the scratch category counts displayed may be less than the scratch counts that appear elsewhere (for example, through ISMF).

In an MTL, the scratch counts that are displayed reflect the current counts that are maintained in the TCDB library record. This is meant to be an approximation. Without having an external source to derive the count, the scratch count from that point forward may be inaccurate if an update of this count in the catalog fails. Periodically check the scratch counts against your tape management system or the TCDB volume records. Also, for an MTL, the scratch category is not applicable and is displayed as zeros for all media types.

For a VTS composite or distributed library, the appropriate composite or distributed line will be displayed, mapping the association of the VTS to the appropriate library.

The library ID line displays the five-character ID assigned to the library.

Start of change The cache percentage used will be displayed only for a TS7720 (3957-VEx) distributed library or for a TS7680 (3958-DE2); it indicates what percentage of cache the library has utilized. End of change

For an ATLDS, the error category displays the total number of scratch volumes that have a software error associated with them. Scratch volumes in this category will still have a use attribute of scratch; however, they are not eligible to be mounted.

The scratch stacked volume count is only displayed for a virtual tape server (VTS) library and indicates the number of available physical scratch volumes. For a Peer-to-Peer VTS subsystem, this information can be obtained by displaying the distributed libraries associated with the composite library. This count is suppressed when the library being displayed is a TS7720 (3957-VEx).

The private stacked volume count will only be displayed for a VTS library. This count indicates the number of physical stacked private volumes. For a Peer-to-Peer VTS subsystem, this information can be obtained by displaying the distributed libraries associated with the composite library. This count is suppressed when the library being displayed is a TS7720 (3957-VEx).

For a VTS library with outboard policy management support, the scratch stacked volume count and the private stacked volume count will reflect the cumulative count from all physical volume storage pools. See Physical volume pooling for more information on physical volume pooling.

The corrupted token volume count will only be displayed for a Peer-to-Peer VTS library and indicates the number of volumes in the corrupted token category. For a Peer-to-Peer VTS subsystem, this information can be obtained by displaying the composite library. For corrective action, contact your hardware service representative.

For a VTS composite library, the operational state that is returned to the host is determined by examining the states of the underlying distributed libraries with much of the other status (for instance, I/O station-related status), being provided from the designated user interface (U/I) library. Also, since all of the drives and volumes are defined to and associated with the composite library, the display of a distributed library will show that, from a host perspective, there are no volumes and drives associated with that library. The distributed libraries should be displayed for an accurate picture of the total and empty slot counts (the slot counts associated with the composite library are zero).

The high capacity input and output station lines are only displayed for an ATLDS and only if the station has been configured.

In an ATLDS, the following status lines may appear:

Operation degraded due to unavailable hardware resource
Safety enclosure interlock open
Vision system not operational
Library manager offline
Operator intervention required
Library manager check 1 condition
All storage slots full
Out of cleaner volumes
Dual write disabled
Environmental alert
Library manager switchover in progress
Copy operations disabled
VTS operations degraded
Immediate mode copy operations deferred
Synchronous mode copy operations deferred
Service preparation occurring in distributed library library_name
All convenience input stations empty
All convenience output stations empty
All convenience output stations full
Bulk output configured
Bulk output not configured
Bulk input/output configured
Bulk input/output not configured
High capacity output station full
Input door open
Output door open
Convenience I/O station installed
Convenience I/O station Input | Output | Import mode
Convenience I/O station empty
Convenience I/O station full
Single cell output facility in use for eject
Host initiated import in process
Host initiated export in process
Library initiated single volume import in process
Library is out of empty stacked volumes
Library has insufficient resources to continue mount processing
Library supports import/export
Library supports outboard policy management
Forced Pause Occurred
Grid Links Degraded
Limited Cache Free Space - Warning State
Out of Cache Resources - Critical State
Library supports physical tape

Note: The "Library supports outboard policy management" and "Library enabled for scratch allocation assistance" status lines are displayed only if both the library and the host are enabled for that function.

The following is sample output of the DISPLAY SMS,LIBRARY(LIBVTS1),DETAIL command:

CBR1110I OAM library status:
TAPE      LIB  DEVICE     TOT   ONL   AVL    TOTAL    EMPTY   SCRTCH   ON  OP
LIBRARY   TYP  TYPE       DRV   DRV   DRV    SLOTS    SLOTS     VOLS         
LIBVTS1   VL   3494-L10   128    100   50     1443      800      146   Y   Y 
---------------------------------------------------------------------------
MEDIA       SCRATCH          SCRATCH          SCRATCH                       
TYPE          COUNT        THRESHOLD         CATEGORY                       
MEDIA1           16               25             0011                       
MEDIA2          130               25             0012                       
---------------------------------------------------------------------------
LIBRARY ID:  22222
OPERATIONAL STATE: AUTOMATED
ERROR CATEGORY SCRATCH COUNT:                  12
SCRATCH STACKED VOLUME COUNT:                 243
PRIVATE STACKED VOLUME COUNT:                 400
----------------------------------------------------------------------
Library supports import/export.
Library supports outboard policy management.