QUERY LIBRARY (Query a library)
Use this command to display information about libraries.
Privilege class
Any administrator can issue this command.
Syntax
.-*------------. >>-Query LIBRary--+--------------+------------------------------> '-library_name-' .-Format--=--Standard-----. >--+-------------------------+--------------------------------->< '-Format--=--+-Standard-+-' '-Detailed-'
Parameters
- library_name
- Specifies the name of the library to be queried. You can use wildcards to specify names. This parameter is optional.
- Format
- Specifies how the information is displayed. This parameter is
optional. The default value is STANDARD. Possible values are:
- Standard
- Specifies that partial information is displayed for the library.
- Detailed
- Specifies that complete information is displayed for the library.
Example: Display summary information about a specific library
Display information about the library named AUTO. Issue the command:query library auto
Library Name: AUTO
Library Type: SCSI
ACS Id:
Private Category:
Scratch Category:
WORM Scratch Category:
External Manager:
Shared: No
LanFree:
ObeyMountRetention:
See Field descriptions for field descriptions.Example: Display detailed library information about a specific library
Display information in full detail about the library named EZLIFE. Issue the command:query library ezlife format=detailed
Library Name: EZLIFE
Library Type: SCSI
ACS Id:
Private Category:
Scratch Category:
WORM Scratch Category:
External Manager:
Shared: Yes
LanFree:
ObeyMountRetention:
Primary Library Manager: EZSERVER
WWN:
Serial Number:
AutoLabel: OVERWRITE
Relabel Scratch: Yes
Last Update by (administrator): DOCTOR_MIKE
Last Update Date/Time: 2002-12-05 15:24:53
Library Name: EZLIFE
Library Type: SCSI
ACS Id:
Private Category:
Scratch Category:
WORM Scratch Category:
External Manager:
Shared: YES
LanFree:
ObeyMountRetention:
Primary Library Manager: EZSERVER
WWN:
Serial Number:
AutoLabel: OVERWRITE
Reset Drives: No
Relabel Scratch: Yes
Last Update by (administrator): DOCTOR_MIKE
Last Update Date/Time: 2000-12-05 15:24:53
See Field descriptions for field descriptions.Field descriptions
- Library Name
- The name of the library.
- Library Type
- The type of library.
- ACS Id
- Specifies that the library is a StorageTek library that is controlled by StorageTek Automated Cartridge System Library Software (ACSLS).
- Private Category
- The category number for private volumes that must be mounted by
name.
The information that is displayed in this field applies only to an IBM® 3494 or 3495 Tape Library Dataserver.
- Scratch Category
- The category number to use for scratch volumes in the library.
The information that is displayed in this field applies only to an IBM 3494 or 3495 Tape Library Dataserver.
- WORM Scratch Category
- The category number that is used for WORM scratch volumes in the
library.
The information that is displayed in this field applies only to an IBM 3494 or 3495 Tape Library Dataserver.
- External Manager
- The location of the external library manager where the server can send media access requests.
- Shared
- Whether this library is shared with other Tivoli® Storage Manager servers in a storage area network (SAN).
- LanFree
- Whether an external library is used for LAN-free operations.
- ObeyMountRetention
- Whether the server uses the value that is set for mount retention in the device class that is associated with this external library.
- Primary Library Manager
- The name of the server that is responsible for controlling access to library resources.
- WWN
- The Fibre Channel worldwide name for the library.
- Serial Number
- Specifies the serial number for the library that is being queried.
- AutoLabel
- Specifies whether the server attempts to automatically label tape volumes.
- Reset Drives
- Specifies whether the server completes a target reset when the server is restarted or when a library client or storage agent re-connection is established.
- Relabel Scratch
- Specifies whether the server relabels volumes that were deleted and returned to scratch.
- Last Update by (administrator)
- Who completed the last update to the library.
- Last Update Date/Time
- The date and time when the last update occurred.
Related commands
Command | Description |
---|---|
AUDIT LIBRARY | Ensures that an automated library is in a consistent state. |
DEFINE LIBRARY | Defines an automated or manual library. |
DEFINE PATH | Defines a path from a source to a destination. |
DELETE LIBRARY | Deletes a library. |
QUERY PATH | Displays information about the path from a source to a destination. |
UPDATE LIBRARY | Changes the attributes of a library. |
UPDATE PATH | Changes the attributes associated with a path. |