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 is displayed 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 Name  Library  Device    Private  Scratch  External                     |
|              Type               Category Category Manager                      |
|-------       -------  -------   -------- -------- --------                     |
|AUTO          SCSI     /dev/01b                                                 |
+--------------------------------------------------------------------------------+

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: /dev/01b                                        |
|              Private Category:                                                 |
|              Scratch Category:                                                 |
|              External Manager:                                                 |
|Last Update by (administrator): DOCTOR_MIKE                                     |
|         Last Update Date/Time: 1996-12-05 15:24:53                             |
|                                                                                |
|                                                                                |
+--------------------------------------------------------------------------------+

where:

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

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

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

Private Category
Specifies 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
Specifies the category number to use for scratch volumes in the library.

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

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

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

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

Related Commands

Table 173. 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 ]