UPDATE STGPOOL (Update a container-copy storage pool)
Use this command to update a container-copy storage pool.
Privilege class
To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the storage pool to be updated.
Syntax
>>-UPDate STGpool--pool_name--+-----------------------+---------> '-MAXSCRatch--=--number-' >--+-----------------------------+------------------------------> '-DESCription--=--description-' >--+----------------------------+-------------------------------> '-ACCess--=--+-READWrite---+-' +-READOnly----+ '-UNAVailable-' >--+---------------------------+--+---------------------+-------> '-PROTECTPRocess--=--number-' '-REClaim--=--percent-' >--+---------------------+------------------------------------->< '-REUsedelay--=--days-'
Parameters
- pool_name (Required)
- Specifies the name of the storage pool to be updated.
- MAXSCRatch
- Specifies the maximum number of scratch volumes that the server can request for this storage
pool. You can specify an integer in the range 0 - 100000000. If the server can request scratch
volumes as needed, you do not have to define each volume to be used.
The value of this parameter is used to estimate the total number of volumes that are available in the storage pool and the corresponding estimated capacity for the storage pool.
- DESCription
- Specifies a description of the storage pool. This parameter is optional. The maximum length of the description is 255 characters. Enclose the description in quotation marks if it contains any blank characters. To remove an existing description, specify a null string ("").
- ACCess
- Specifies how server processes such as storage-pool protection and repair can access data in the
storage pool. This parameter is optional. You can specify one of the following values:
- READWrite
- Specifies that the server can read and write to volumes in the storage pool.
- READOnly
- Specifies that the server can only read volumes in the storage pool. The server can use data in the storage pool to restore extents to directory-container storage pools. No operations that write to the container-copy storage pool are allowed.
- UNAVailable
- Specifies that the server cannot access data that is stored on volumes in the storage pool.
- PROTECTPRocess
- Specifies the maximum number of parallel processes that are used when you issue the
PROTECT STGPOOL command to copy data to this pool from a directory-container
storage pool. This parameter is optional. Enter a value in the range 1 - 20.
The time that is required to complete the copy operation might be decreased by using multiple, parallel processes. However, in some cases when multiple processes are running, one or more of the processes must wait to use a volume that is already in use by a different process.
When you select this value, consider the number of logical and physical drives that can be dedicated to this operation. To access a tape volume, the server uses a mount point and a drive. The number of available mount points and drives depends on the mount limit of the device class for the storage pool, and on other server and system activity.
If you use the preview option on the PROTECT STGPOOL command, only one process is used and no mount points or drives are needed.
- REClaim
- Specifies when a volume becomes eligible for reclamation and reuse. Specify eligibility as the
percentage of a volume's space that is occupied by extents that are no longer stored in the
associated directory-container storage pool. Reclamation moves any extents that are still stored in
the associated directory-container storage pool from eligible volumes to other volumes. Reclamation
occurs only when a PROTECT STGPOOL command stores data into this storage
pool.
This parameter is optional. You can specify an integer in the range 1 - 100. The value 100 specifies that volumes in this storage pool are not reclaimed.
The server determines that the volume is a candidate for reclamation if the percentage of reclaimable space on a volume is greater than the reclamation threshold of the storage pool.
By setting the reclaim value to 50 percent or greater, data that is moved from two reclaimed volumes uses no more than the equivalent of one new volume. The preferred method is to set a reclamation value in the range 90 - 100.
- REUsedelay
- Specifies the number of days that must elapse after all extents are deleted from a volume before
the volume can be rewritten or returned to scratch status. This parameter is optional. You can
specify an integer in the range 0 - 9999. A value of 0 means that a volume can be rewritten or
returned to scratch status as soon as all the extents are deleted from the volume. Tip: Use this parameter to ensure that when you restore the database to an earlier level, database references to extents in the storage pool are still valid. You must set this parameter to a value greater than the number of days you plan to retain the oldest database backup. If you use disaster recovery manager, the number of days that are specified for this parameter must be the same as the number specified for the SET DRMDBBACKUPEXPIREDAYS command.
Example: Update a container-copy storage pool to delay volume reuse for 30 days
Update the storage pool that is named CONTAINER1_COPY2 to change the delay for volume reuse to 30 days.update stgpool container1_copy2 reusedelay=30
Command | Description |
---|---|
DEFINE STGPOOL (container-copy) | Define a container-copy storage pool that stores copies of data from a directory-container storage pool. |
PROTECT STGPOOL | Protects a directory-container storage pool. |
QUERY STGPOOL | Displays information about storage pools. |
REPAIR STGPOOL | Repairs a directory-container storage pool. |
UPDATE STGPOOL (directory-container) | Update a directory-container storage pool. |