Administrator's Reference

QUERY VOLUME (Query Storage Pool Volumes)

Use this command to display information about storage pool volumes.

Privilege Class

Any administrator can issue this command.

Syntax

                   .-*------------.
>>-Query Volume----+--------------+----------------------------->
                   '-volume_name--'
 
>-----+---------------------------------+----------------------->
      |            .-,----------------. |
      |            V                  | |
      '-ACCess--=----+-READWrite---+--+-'
                     +-READOnly----+
                     +-UNAVailable-+
                     +-OFfsite-----+
                     '-DEStroyed---'
 
>-----+-----------------------------+--------------------------->
      |            .-,------------. |
      |            V              | |
      '-STatus--=----+-ONline--+--+-'
                     +-OFfline-+
                     +-EMPty---+
                     +-PENding-+
                     +-FILling-+
                     '-FULl----'
 
      .-STGpool--=--*----------.
>-----+------------------------+-------------------------------->
      '-STGpool--=--pool_name--'
 
      .-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.

READOnly
Display volumes with an access mode of READONLY.

UNAVailable
Display volumes with an access mode of UNAVAILABLE.

OFFsite
Display volumes with an access mode of OFFSITE.

DEStroyed
Display volumes with an access mode of DESTROYED.

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 volumes with a status of ONLINE.

OFfline
Display volumes with a status of OFFLINE.

EMPty
Display volumes with a status of EMPTY.

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 volumes with a status of FILLING.

FULl
Display volumes with a status of FULL.

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 with the device class of FILE.

Command:
query volume devclass=file

Output:
 
+--------------------------------------------------------------------------------+
|Volume Name             Storage     Device     Estimated  Pct   Volume          |
|                        Pool Name   Class Name  Capacity  Util  Status          |
|                                                    (MB)                        |
|----------------------- ----------- ---------- --------  ----- -------          |
|/fct/server/covol1      COPYSTG      FILE           0.0   0.0  Pending          |
|/fct/server/covol2      COPYSTG      FILE           0.0   0.0   Empty           |
|/fct/server/covol3      COPYSTG      FILE           0.0   0.0   Empty           |
|/fct/server/prvol1      PRIMESTG     FILE           0.0   0.0   Empty           |
|/fct/server/prvol2      PRIMESTG     FILE           0.0   0.0   Empty           |
+--------------------------------------------------------------------------------+

See Task 2 for parameter definitions.

Task 2

Display details about the storage pool volume named /fct/server/covol1.

Command:
query volume covol1 format=detailed

Output:
 
+--------------------------------------------------------------------------------+
|                   Volume Name: /fct/server/covol1                              |
|             Storage Pool Name: COPYSTG                                         |
|             Device Class Name: DISK                                            |
|       Estimated Capacity (MB): 10.0                                            |
|                      Pct Util: 6.7                                             |
|                 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 206. 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 ]