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 TS7740 (3957-V0x), when the TS7740 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.
The cache percentage used will only be
displayed for a TS7720 (3957-VEx) distributed library or for a TS7680
(3958-DE2); it indicates what percentage of cache the library has
utilized.
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 logical WORM
- Copy operations disabled by operator command
- Library enabled for scratch allocation assistance
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.