UPDATE STGPOOL (Update a primary storage pool for copying data to tape)

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.

Parameters

pool_name (Required)

Specifies the name of the storage pool to be updated.

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 client nodes and server processes (such as migration and reclamation) can access files in the storage pool. This parameter is optional. You can specify the following values:

READWrite

Specifies that client nodes and server processes can read and write to files stored on volumes in the storage pool.

READOnly

Specifies that client nodes can only read files from the volumes in the storage pool.

Server processes can move files within the volumes in the storage pool. However, no new write operations are permitted to volumes in the storage pool from volumes outside the storage pool.

If this storage pool was specified as a subordinate storage pool (with the NEXTSTGPOOL parameter) and the storage pool has the ACCESS=READONLY parameter setting, the storage pool is skipped when server processes attempt to write files to the storage pool.

UNAVailable

Specifies that client nodes cannot access files stored on volumes in the storage pool.

Server processes can move files within the volumes in the storage pool and can also move or copy files from this storage pool to another storage pool. However, no new write operations are permitted to volumes in the storage pool from volumes outside the storage pool.

If this storage pool was specified as a subordinate storage pool (with the NEXTSTGPOOL parameter) and the storage pool has the ACCESS=UNAVAILABLE parameter setting, the storage pool is skipped when server processes attempt to write files to the storage pool.

MIGPRocess

Specifies the number of parallel processes to use for migrating the files from the volumes in this storage pool. This parameter is optional. Enter a value in the range 1 - 999. The default value is 1.

When calculating the value for this parameter, consider the number of sequential storage pools that will be involved with the migration, and the number of logical and physical drives that can be dedicated to the operation. To access a sequential-access volume, IBM Storage Protect uses a mount point and, if the device type is not FILE, a physical drive. The number of available mount points and drives depends on other IBM Storage Protect and system activity and on the mount limits of the device classes for the sequential-access storage pools that are involved in the migration.

For example, suppose that you want to simultaneously migrate the files from volumes in two primary sequential-access storage pools and that you want to specify three processes for each of the storage pools. The storage pools have the same device class. Assuming that the storage pool to which files are being migrated has the same device class as the storage pool from which files are being migrated, each process requires two mount points and, if the device type is not FILE, two drives. (One drive is for the input volume, and the other drive is for the output volume.) To run six migration processes simultaneously, at least 12 mount points and 12 drives are required. The device class for the storage pools must have a mount limit of at least 12.

If the number of migration processes that you specify is more than the number of available mount points or drives, the processes that do not obtain mount points or drives will wait for mount points or drives to become available. If mount points or drives do not become available within the time that is specified by the MOUNTWAIT parameter, the migration processes end. For information about specifying the MOUNTWAIT parameter, see DEFINE DEVCLASS (Define a device class).

The IBM Storage Protect server will start the specified number of migration processes regardless of the number of volumes that are eligible for migration. For example, if you specify 10 migration processes and only 6 volumes are eligible for migration, the server will start 10 processes and 4 of them will finish without processing a volume.

Tip: When you specify this parameter, consider whether the simultaneous-write function is enabled for server data migration. Each migration process requires a mount point and a drive for each copy storage pool and active-data pool that is defined to the target storage pool.

REMOVERESToredcopybeforelifetimeend

Specifies that data that is restored to the cold-data-cache storage pool because of a request from IBM Storage Protect Plus can be deleted before the specified expiration date for that data. This parameter is relevant if the occupancy of the cold-data-cache storage pool is nearing capacity. This parameter is optional. The default value is NO.

Data is eligible for early deletion according to a defined time threshold, specified in days, according to the following sequence:

1. Data that was copied to the cold-data-cache storage pool and read more than a specified number of days ago. The oldest data is deleted first.
2. Data that was copied to the cold-data-cache storage pool more than a specified number of days ago. The most recently copied data is deleted first.

YES

Specifies that data that is restored to the cold-data-cache storage pool because of request from the object client can be deleted from the storage pool before the specified expiration period is reached. Only data that is eligible for early deletion according to the defined thresholds and criteria is deleted.

NO

Specifies that data that is restored to the cold-data-cache storage pool because of a request from the object client is not subject to deletion when the storage-pool occupancy nears capacity.

NEXTstgpool

Specifies a primary storage pool to which files are migrated. You cannot migrate data from a sequential-access storage pool to a random-access storage pool. This parameter is optional.

Restrictions: The following restrictions apply when you specify the NEXTSTGPOOL parameter for cold-data-cache storage pools:

• The next storage pool must use a tape-based device class.
• Data deduplication must not be enabled for the next storage pool.
• The next storage pool cannot have its own next storage pool.
• The next storage pool cannot be changed if data was already moved from the cold-data-cache storage pool to the existing next storage pool.

If the existing cold-data-cache storage pool does not have a next storage pool, the server cannot migrate files from the existing storage pool and cannot store files that exceed the maximum size for this storage pool in another storage pool.

If the next storage pool has insufficient space, data is not migrated to that storage pool. In this case, the server issues a message and the transaction fails.

Related commands