Administrator's Reference
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
- pool_name
- Specifies the storage pool to query. This parameter is
optional. You can use wildcard characters to specify this name.
If you do not specify a value for this parameter, all storage pools are
displayed.
- 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.
- POoltype
- Specifies the type of storage pool to query. This parameter is
optional. The default value is ANY. Possible values are:
- ANY
- Query primary and copy storage pools.
- PRimary
- Query only primary storage pools.
- COpy
- Query only copy storage pools.
Examples
Task 1
Display information for the storage pool named POOL1.
- Command:
- query stgpool pool1
- Output:
-
+--------------------------------------------------------------------------------+
|Storage Device Estimated Pct Pct High Low Next |
|Pool Name Class Name Capacity Util Migr Mig Mig Storage |
| (MB) Pct Pct Pool |
|---------- ---------- --------- ----- ----- ---- ---- -------- |
|POOL1 DISK 58.5 0.8 0.7 90 70 POOL2 |
+--------------------------------------------------------------------------------+
See Task 2 for parameter definitions.
Task 2
Display details for the storage pool named 8MMPOOL.
- Command:
- query stgpool 8mmpool format=detailed
- Output:
-
+--------------------------------------------------------------------------------+
| Storage Pool Name: 8MMPOOL |
| Storage Pool Type: Primary |
| Device Class Name: 8MMTAPE |
| Estimated Capacity (MB): 0.0 |
| 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: POOL1 |
| Reclaim Storage Pool: |
| Maximum Size Threshold: 5 M |
| Access: Read/Write |
| Description: Main storage pool |
| Overflow Location: Room1234/Bldg31 |
| 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:
- Storage Pool Name
- The name of the storage pool.
- Storage Pool Type
- The type of storage pool.
- Device Class Name
- The name of the device class assigned to the storage pool.
- Estimated Capacity (MB)
- The estimated capacity of the storage pool, in megabytes.
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.
- Pct Util
- An estimate of the utilization of the storage pool, as a
percentage.
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.
- Pct Migr (primary storage pools only)
- An estimate of the percentage of data in the storage pool that can be
migrated. The server uses this value and the high and low migration
thresholds to determine when to start and stop migration.
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.
- Pct Logical
- The logical occupancy of the storage pool as a percentage of the total
occupancy. Logical occupancy is space occupied by client files that may
or may not be part of an aggregate. A Pct Logical value less than 100%
indicates that there is vacant space within aggregates in the storage
pool.
- High Mig Pct (primary storage pools only)
- The high migration threshold, which specifies when the server can begin
migration for the storage pool. The server starts migration processes
when the percentage of data that can be migrated reaches this
threshold.
- Low Mig Pct (primary storage pools only)
- The low migration threshold, which specifies when the server can stop
migration for the storage pool. The server stops migration processes
when the percentage of data that can be migrated reaches this
threshold.
- Migration Delay (primary storage pools only)
- The minimum number of days that a file must remain in a storage pool
before the server can migrate the file to the next storage pool. For a
disk storage pool, the days are counted from the time that the file was stored
in the storage pool or last retrieved by a client. For a sequential
access storage pool, the days are counted from the time that the file was
stored in the storage pool.
- Migration Continue (primary storage pools only)
- Whether the server continues to migrate files to the next storage pool
even if the files have not been in the pool for the number of days specified
by the migration delay.
- Migration Processes (random access storage pools only)
- The number of processes that are used for migrating files from a storage
pool. When files are migrated from this storage pool to a storage pool
that uses physical drives, each migration process uses a drive.
Therefore, the number of migration processes should not exceed the number of
drives that can be dedicated to migration processing.
- Next Storage Pool (primary storage pools only)
- The storage pool that is the destination for data that is migrated from
this storage pool.
- Reclaim Storage Pool (primary, sequential access storage
pools only)
- If specified, the storage pool that is the destination for data moved from
volumes during reclamation processing. If no pool is specified, by
default reclamation processing moves data only among volumes within the same
storage pool.
- Maximum Size Threshold (primary storage pools only)
- The maximum size of files that may be stored in the storage pool during a
session with a client.
- Access
- How the data in the storage pool can be accessed.
- Description
- The description of the storage pool.
- Overflow Location (sequential access storage pools
only)
- The location where volumes in the storage pool are stored when they are
ejected from an automated library with the MOVE MEDIA command.
- Cache Migrated Files? (random access storage pools
only)
- Whether caching is enabled for files migrated to the next storage
pool.
- Collocate? (sequential access storage pools only)
- Whether collocation is enabled.
- Reclamation Threshold (sequential access storage pools
only)
- The threshold that determines when volumes in a storage pool are
reclaimed. The server compares the percentage of reclaimable space on a
volume to this value to determine if reclamation is necessary.
- Maximum Scratch Volumes Allowed (sequential access storage
pools only)
- The maximum number of scratch volumes that the server can request for the
storage pool.
- Delay Period for Volume Reuse (sequential access storage
pools only)
- The number of days that must elapse after all files have been deleted from
a volume, before the server returns the volume to scratch or reuses the
volume.
- Migration in Progress? (primary storage pools only)
- Whether at least one migration process is active for the storage
pool.
- Amount Migrated (MB) (primary storage pools only)
- The amount of data, in megabytes, that has been migrated, if migration is
in progress. If migration is not in progress, this value indicates the
amount of data migrated during the last migration. When multiple,
parallel migration processes are used for the storage pool, this value
indicates the total amount of data migrated by all processes.
- Elapsed Migration Time (seconds) (primary storage pools
only)
- The amount of time that has elapsed since migration began, if migration is
active. If migration is not active, this value indicates the amount of
time required to complete the last migration. When multiple, parallel
migration processes are used for the storage pool, this value indicates the
total time from the beginning of the first process until the completion of the
last process.
- Reclamation in Progress? (sequential access storage pools
only)
- Whether a reclamation process is active for the storage pool.
- Volume Being Migrated/Reclaimed (sequential access storage
pools only)
- The name of a volume for which migration or reclamation processing is
active. If no migration or reclamation processes are active, this field
is blank.
- Last Update by (administrator)
- The name of the administrator that has defined or most recently updated
the storage pool.
- Last Update Date/Time
- The date and time that an administrator defined or most recently updated
the storage pool.
Related Commands
Table 199. 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.
|
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]