Tivoli Header

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
The name of the library where the storage volume is located.

Volume Name
The name of the storage volume.

Status
The status of the storage volume according to the library inventory. If the status is Private, the volume is being used by Tivoli Storage Manager. If the status is Scratch, the volume is available for use.

Last Use
The type of data on the volume. This field applies only to volumes in Private status. For storage pool volumes, this field shows Data. For database backup volumes (full, incremental, or snapshot), this field shows DbBackup.

Home Element
The element address of the library slot containing the volume.

Related Commands

Table 186. Commands Related to QUERY LIBVOLUME

Command Description
AUDIT LIBRARY Ensures that an automated library is in a consistent state.
CANCEL PROCESS Cancels a background server process.
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.
DEFINE VOLUME Assigns a volume to be used for storage within a specified storage pool.
LABEL LIBVOLUME Labels a library volume.
QUERY LIBRARY Displays information about one or more libraries.
QUERY PROCESS Displays information about background processes.
UPDATE LIBVOLUME Changes the status of a storage volume.


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