Use this command to display information about one or more storage pools. You can also use this command to monitor migration processes for the storage pool.
Privilege Class
Any administrator can issue this command.
Syntax
.-*---------. .-Format--=--Standard-----. >>-Query STGpool----+-----------+---+-------------------------+-> '-pool_name-' '-Format--=--+-Standard-+-' '-Detailed-' .-POoltype--=--ANY---------. >-----+--------------------------+----------------------------->< '-POoltype--=--+-ANY-----+-' +-PRimary-+ '-COpy----'
Parameters
Examples
Task
Display details for the storage pool named POOL1.
+--------------------------------------------------------------------------------+ | Storage Pool Name: POOL1 | | Storage Pool Type: | | Device Class Name: DISK | | Estimated Capacity (MB): 58.5 | | Pct Util: 0.0 | | Pct Migr: 0.0 | | Pct Logical: 0.0 | | High Mig Pct: 90 | | Low Mig Pct: 70 | | Migration Delay: 0 | | Migration Continue: Yes | | Migration Processes: | | Next Storage Pool: SPOOL2 | | Reclaim Storage Pool: | | Maximum Size Threshold: No Limit | | Access: Read/Write | | Description: | | Overflow Location: | | Cache Migrated Files?: | | Collocate?: Yes | | Reclamation Threshold: 60 | | Maximum Scratch Volumes Allowed: 5 | | Delay Period for Volume Reuse: 0 Day(s) | | Migration in Progress?: No | | Amount Migrated (MB): 0.00 | |Elapsed Migration Time (seconds): 0 | | Reclamation in Progress?: No | | Volume Being Migrated/Reclaimed: | | Last Update by (administrator): ADMIN | | Last Update Date/Time: 05/22/1998 14:50:29 | +--------------------------------------------------------------------------------+
where:
For DISK devices, this is the capacity of all volumes in the storage pool, including any volumes that are varied offline.
For sequential access devices, this is an estimate of the total space of all the sequential access volumes in the storage pool, regardless of their access mode. If the storage pool has stored data on at least one scratch volume, the estimated capacity includes the maximum number of scratch volumes allowed for the pool.
For sequential access devices, this is expressed as a percentage of the number of active bytes on each sequential access volume and the estimated capacity of all volumes in the storage pool.
For disk devices, this is expressed as a percentage of the estimated capacity, including cached data and data that resides on any volumes that are varied offline. The value for Pct Util can be higher than the value for Pct Migr if you issue this command while a file creation transaction is in progress. The value for Pct Util is determined by the amount of space actually allocated (while the transaction is in progress). The value for Pct Migr represents only the space occupied by committed files. At the end of the transaction, these values become synchronized.
The Pct Util value includes cached data on disk volumes. Therefore, when cache is enabled and migration occurs, the Pct Util value remains the same because the migrated data remains on the volume as cached data. The Pct Util value decreases only when the cached data expires or when the space that cached files occupy needs to be used for noncached files.
For disk devices, this value is specified as a percentage of the value for the estimated capacity, excluding cached data, but including data on any volumes varied offline.
For sequential access devices, this value is the percentage of the total number of volumes in the pool that contain at least 1 byte of active data. The total number of volumes includes the maximum number of scratch volumes.
The Pct Util value includes cached data on a volume; the Pct Migr value excludes cached data. Therefore, when cache is enabled and migration occurs, the Pct Migr value decreases but the Pct Util value remains the same because the migrated data remains on the volume as cached data. The Pct Util value decreases only when the cached data expires or when the space that cached files occupy needs to be used for noncached files.
Related Commands
Table 179. Commands Related to QUERY STGPOOL
Command | Description |
---|---|
DEFINE STGPOOL | Defines a storage pool as a named collection of server storage media. |
DELETE STGPOOL | Deletes a storage pool from server storage. |
UPDATE STGPOOL | Changes the attributes of a storage pool. |