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 Tivoli® Storage Manager server.

Privilege class

Any administrator can issue this command.

Syntax


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

   .-Format--=--Standard-----.   
>--+-------------------------+---------------------------------><
   '-Format--=--+-Standard-+-'   
                '-Detailed-'

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.

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.
Detailed: Specifies that complete information is displayed.

Example: List checked in volumes for a specific library

Display information about all of the volumes that are checked into the library named TAPE. See Field descriptions for field descriptions.

query libvolume tape

Library Name  Volume Name  Status   Owner   Last Use   Home     Device
                                                       Element  Type
------------  -----------  -------- ------- --------   ------  ------
TAPE          000114       Scratch                     1,000    LTO
TAPE          NY1602       Scratch                     1,001    DLT

Example: Display detailed information for a specific library

Display detailed information about a volume named JJY008. See Field descriptions for field descriptions.

query libvolume jjy008 format=detailed

                            Library Name: HPW3494
                             Volume Name: JJY008
                                  Status: Private
                                   Owner: SUNSET
                                Last Use: Data
                            Home Element: 
                             Device Type: 
                          Cleanings Left: 
                              Media Type:

Field descriptions

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.
Owner: The owner server of the volume, if the volume is private.
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.
Device Type: The type of device that the volume is used on. This field will display a value only for volumes checked into a library that has mixed media capabilities.
Cleanings Left: For cleaner cartridges, the number of cleanings left.
Media Type: The type of media the volume represents (for example, 8mm tape).

Related commands

Table 1. 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 VOLUME	Assigns a volume to be used for storage within a specified storage pool.
LABEL LIBVOLUME	Labels volumes in manual or automated libraries.
QUERY LIBRARY	Displays information about one or more libraries.
UPDATE LIBVOLUME	Changes the status of a storage volume.