Tivoli Storage Manager for Windows: Administrator's Reference

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 displays for the library.

Detailed
Specifies that complete information displays for the library.

Examples

Task 1

Display information about the library named AUTO.

Command:
query library auto

Output:

+--------------------------------------------------------------------------------+
|                                                                                |
|Library  Library  Device         Private   Scratch   External                   |
|Name              Type           Category  Category  Manager                    |
|-------  -------  -------------  --------  --------  --------                   |
|AUTO     SCSI     \\.\lb3.0.0.0                                                 |
+--------------------------------------------------------------------------------+

See Task 2 for parameter definitions.

Task 2

Display information in full detail about the library named EZLIFE.

Command:
query library ezlife format=detailed

Output:
+--------------------------------------------------------------------------------+
|                  Library Name: EZLIFE                                          |
|                  Library Type: SCSI                                            |
|                        Device: \\.\lb3.0.0.0                                   |
|              Private Category:                                                 |
|              Scratch Category:                                                 |
|              External Manager:                                                 |
|                RSM Media Type:                                                 |
|                        Shared: YES                                             |
|                       LanFree:                                                 |
|            ObeyMountRetention:                                                 |
|       Primary Library Manager: EZSERVER                                        |
|Last Update by (administrator): DOCTOR_MIKE                                     |
|         Last Update Date/Time: 2000-12-05 15:24:53                             |
+--------------------------------------------------------------------------------+

where:

Library Name
The name of the library to which the drive is assigned.

Library Type
The type of library to which the drive is assigned.

Device
The name of the device that corresponds to the drive.

Private Category
The category number for private volumes that must be mounted by name.

The information displayed in this field only applies to an IBM 3494 or 3495 Tape Library Dataserver.

Scratch Category
|The category number to use for IBM 3490 scratch volumes in the |library. To determine the category for IBM 3590 scratch volumes, add 1 |to the number displayed.

|The information displayed in this field only applies to an IBM 3494 or 3495 |Tape Library Dataserver.

External Manager
The location of the external library manager where TSM can send media access requests.

|RSM Media Type
|The media type for Windows Removable Storage Manager (RSM).

Shared
Whether this library is shared with other TSM 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 set for mount retention in the device |class associated with this external library.

Primary Library Manager
The name of the server that is responsible for controlling access to library resources.

Last Update by (administrator)
Who performed the last update to the library.

Last Update Date/Time
The date and time when the last update occurred.

Related Commands

Table 187. 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.
DELETE LIBRARY Deletes a library.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]