Tivoli Storage Manager for Windows: Administrator's Reference

QUERY VOLUME (Query Storage Pool Volumes)

Use this command to display information about one or more storage pool volumes.

Privilege Class

Any administrator can issue this command.

Syntax

                 .-*-----------.
>>-Query Volume--+-------------+-------------------------------->
                 '-volume_name-'
 
>--+--------------------------------+--------------------------->
   |            .-,---------------. |
   |            V                 | |
   '-ACCess--=----+-READWrite---+-+-'
                  +-READOnly----+
                  +-UNAVailable-+
                  +-OFfsite-----+
                  '-DEStroyed---'
 
                                   .-STGpool--=--*---------.
>--+----------------------------+--+-----------------------+---->
   |            .-,-----------. |  '-STGpool--=--pool_name-'
   |            V             | |
   '-STatus--=----+-ONline--+-+-'
                  +-OFfline-+
                  +-EMPty---+
                  +-PENding-+
                  +-FILling-+
                  '-FULl----'
 
   .-DEVclass--=--*-----------------.
>--+--------------------------------+--------------------------->
   '-DEVclass--=--device_class_name-'
 
   .-Format--=--Standard-----.
>--+-------------------------+---------------------------------><
   '-Format--=--+-Standard-+-'
                '-Detailed-'
 
 

Parameters

volume_name
Specifies the volume to query. This parameter is optional. You can use wildcard characters to specify names. If you do not specify a name, all storage pool volumes are included in the query.

ACCess
Specifies that output is restricted by volume access mode. This parameter is optional. You can specify multiple access modes by separating the modes with commas and no intervening spaces. If you do not specify a value for this parameter, output is not restricted by access mode. Possible values are:

READWrite
Display volumes with an access mode of READWRITE. Client nodes and server processes can read from and write to files stored on the volumes.

READOnly
Display volumes with an access mode of READONLY. Client nodes and server processes can only read files stored on the volumes.

UNAVailable
Display volumes with an access mode of UNAVAILABLE. Neither client nodes nor server processes can access files stored on the volumes.

OFFsite
Display copy storage pool volumes with an access mode of OFFSITE. The volumes are at offsite locations from which they cannot be mounted.

DEStroyed
Display primary storage pool volumes with an access mode of DESTROYED. The volumes have been designated as permanently damaged.

STatus
Specifies that output is restricted by volume status. This parameter is optional. You can specify multiple status values by separating values with commas and no intervening spaces. If you do not specify a value for this parameter, output is not restricted by volume status. Possible values are:

ONline
Display random access volumes that are available to the server.

OFfline
Display random access volumes that are not available to the server.

EMPty
Display sequential access volumes that have no data.

PENding
Display volumes with a status of PENDING. These are volumes from which all files have been deleted, but the time specified by the REUSEDELAY parameter from the DEFINE STGPOOL command has not elapsed.

FILling
Display sequential access volumes that the server has written to but has not yet filled to capacity.

FULl
Display sequential access volumes that the server has filled.

STGPool
Specifies the storage pool to include in the query. This parameter is optional. You can use wildcard characters to specify names. If you do not specify a storage pool name, all storage pools are included in the query.

DEVclass
Specifies the device class to include in the query. This parameter is optional. You can use wildcard characaters to specify names. If you do not specify a device class name, all devices are included in the query.

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.

Examples

Task 1

Display information on all storage pool volumes prefixed with the name ATF.

Command:
query volume atf*

Output:
 
+--------------------------------------------------------------------------------+
|Volume Name             Storage     Device     Estimated  Pct   Volume          |
|                        Pool Name   Class Name  Capacity  Util  Status          |
|                                                    (MB)                        |
|----------------------- ----------- ---------- ---------  ----- -------         |
|ATF001                  8MMPOOL     8MMTAPE    4944.0     18.2  Filling         |
|ATF002                  8MMPOOL     8MMTAPE    4944.0     18.2  Filling         |
+--------------------------------------------------------------------------------+

See Task 2 for parameter definitions.

Task 2

Display details about the storage pool volume WPDV00.

Command:
query volume wpdv00 format=detailed

Output:
 
+--------------------------------------------------------------------------------+
|                   Volume Name: WPDV00                                          |
|             Storage Pool Name: TAPEPOOL                                        |
|             Device Class Name: TAPE                                            |
|       Estimated Capacity (MB): 5.8                                             |
|                      Pct Util: 0.1                                             |
|                 Volume Status: On-line                                         |
|                        Access: Read/Write                                      |
|        Pct. Reclaimable Space: 3.2                                             |
|               Scratch Volume?: Yes                                             |
|               In Error State?: No                                              |
|      Number of Writable Sides: 1                                               |
|       Number of Times Mounted: 11                                              |
|             Write Pass Number: 1                                               |
|     Approx. Date Last Written: 04/14/1998 16:17:26                             |
|        Approx. Date Last Read: 04/01/1998 13:26:18                             |
|           Date Became Pending:                                                 |
|        Number of Write Errors: 0                                               |
|         Number of Read Errors: 0                                               |
|               Volume Location:                                                 |
|Last Update by (administrator): COLLIN                                          |
|         Last Update Date/Time: 05/01/1998 14:07:27                             |
+--------------------------------------------------------------------------------+

where:

Volume Name
The name of the storage pool volume.

Storage Pool Name
The storage pool to which the volume is defined.

Device Class Name
The device class assigned to the storage pool.

Estimated Capacity (MB)
The estimated capacity of the volume, in megabytes.

For DISK devices, this value is the capacity of the volume.

For sequential access devices, this value is an estimate of the total space available on the volume, based on the device class.

Pct Util
An estimate of the utilization of the volume. The utilization includes all space occupied by both non-aggregated files and aggregates, including empty space within aggregates.

For DISK volumes, the utilization also includes space occupied by cached data.

Volume Status
The status of the volume.

Access
Whether the volume is available to the server.

Pct. Reclaimable Space (sequential access volumes only)
The amount of space on this volume that can be reclaimed because data has expired or been deleted. This value is compared to the reclamation threshold for the storage pool to determine if reclamation is necessary. Reclaimable space includes empty space within aggregates.

Scratch Volume? (sequential access volumes only)
Whether this volume was originally a scratch volume that the server acquired for its use. If the volume was a scratch volume, the server returns the volume to scratch when the volume becomes empty.

In Error State?
Whether the volume is in an error state. The server cannot write to volumes in an error state.

Number of Writable Sides
This information is reserved for TSM.

Number of Times Mounted
The number of times the volume has been mounted.

Write Pass Number (sequential access volumes only)
The number of times the volume has been written to from the beginning to the end.

Approx. Date Last Written
The approximate date on which the volume was last written.

Approx. Date Last Read
The approximate date on which the volume was last read.

Date Became Pending
The date that the status of the volume changed to pending.

Number of Write Errors
The number of writing errors that have occurred on the volume.

Number of Read Errors
The number of reading errors that have occurred on the volume.

Volume Location
The location of the volume.

Last Update by (administrator)
The administrator that defined or most recently updated the volume.

Last Update Date/Time
When the volume was defined or most recently updated.

Related Commands

Table 221. Commands Related to QUERY VOLUME

Command Description
DEFINE VOLUME Assigns a volume to be used for storage within a specified storage pool.
DELETE VOLUME Deletes a volume from a storage pool.
UPDATE VOLUME Updates the attributes of storage pool volumes.
VARY Specifies whether a disk volume is available to the server for use.


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