Administrator's Reference
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 198. 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 ]