Tivoli Storage Manager for Sun Solaris Administrator's Reference

QUERY STGPOOL (Query Storage Pools)

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 205. 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 ]