Administrator's Reference

QUERY LIBVOLUME (Query a Library Volume)

Use the QUERY LIBVOLUME command to display information about one or more volumes that have been previously checked into an automated library for use by the ADSM server.

Privilege Class

Any administrator can issue this command.

Syntax

>>-Query LIBVolume---+--------------+--+----------+------------><
                     '-libraryname--'  '-volname--'
 

Parameters

libraryname

Specifies the name of the library where the storage volume is located. You can use a pattern-matching expression to specify this name. This parameter is optional.

volname

Specifies the volume name of the storage volume. You can use a pattern-matching expression to specify this name. This parameter is optional.

Examples

Task

Display information about all of the volumes that are checked into the library named AUTO.

Command:

query libvolume auto

Output:

+--------------------------------------------------------------------------------+
|Library Name     Volume Name     Status            Last Use                     |
|------------     -----------     -------           --------                     |
|AUTO             WPD001          Private           Data                         |
|AUTO             WPD002          Private           Export                       |
|AUTOLIB          OPTVOL1         Private(Optical)  Data                         |
|AUTOLIB          OPTVOL2         Scratch(Worm)                                  |
|AUTO             WPDV00          Scratch                                        |
|AUTO             WPD003          Private           DbBackup                     |
+--------------------------------------------------------------------------------+

Library Name

Specifies the name of the library where the storage volume is located.

Volume Name

Specifies the name of the storage volume.

Status

Specifies the status of the storage volume in the inventory that ADSM tracks for the library. If the status is Private, the volume is being used by ADSM. If the status is Scratch, the volume is available for use. When ADSM begins using a volume with scratch status, the status is changed to private.

Last Use

Specifies the type of data on the storage volume. This field only applies to storage volumes with the Private status.

Related Commands

Table 139. Commands Related to QUERY LIBVOLUME

Command	Description
AUDIT LIBRARY	Ensures that an automated library is in a consistent state.
CHECKIN LIBVOLUME	Checks a storage volume into an automated library.
CHECKOUT LIBVOLUME	Checks a storage volume out of an automated library.
DEFINE LIBRARY	Defines an automated or manual library.
QUERY LIBRARY	Displays information about one or more libraries.
UPDATE LIBVOLUME	Changes the status of a storage volume.