Administrator's Reference

QUERY LIBVOLUME (Query a Library Volume)

Use this command to display information about one or more volumes that are checked into an automated library for use by the TSM server.

Privilege Class

Any administrator can issue this command.

Syntax

                      .-*------------.   .-*-----------.
>>-Query LIBVolume----+--------------+---+-------------+-------><
                      '-library_name-'   '-volume_name-'
 

Parameters

library_name
Specifies the name of the library. You can use wildcard characters to specify this name. This parameter is optional. The default is all libraries.

volume_name
Specifies the volume name. You can use wildcard characters to specify this name. This parameter is optional. The default is all volumes.

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      Home Element         |
|------------     -----------     -------     ---------     ------------         |
|AUTO             154VAM          Private                   42                   |
|AUTO             154VEB          Private     Data          43                   |
|AUTO             154VTG          Private                   36                   |
|                                                                                |
|                                                                                |
+--------------------------------------------------------------------------------+

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. If the status is Private, the volume is being used by TSM. If the status is Scratch, the volume is available for use.

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

Home Element
Specifies the element address of the drive. The element address is a number that indicates the physical location of a drive within an automated library.

Related Commands

Table 172. 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.


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