IBM Tivoli Storage Manager, Version 7.1

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:

AIX operating systems

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

Table 1. Commands related to QUERY LIBRARY
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.

Feedback