RENAME STGPOOL (Change the name of a storage pool)

Use this command to change the name of a storage pool. You can change storage pool names to use the same names on a configuration manager and its managed servers.

When you rename a storage pool, any administrators with restricted storage privilege for the old storage pool automatically retain restricted storage privilege for the renamed storage pool. If the renamed storage pool is in a storage pool hierarchy, the hierarchy is preserved. You must update the management class or copy group to specify the new storage pool name as the destination for files.

If processes are active when a storage pool is renamed, the old name might still be displayed in messages or queries for those processes.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagramREName STGpoolcurrent_pool_namenew_pool_name

Parameters

current_pool_name (Required)
Specifies the storage pool to rename.
new_pool_name (Required)
Specifies the new name of the storage pool. The maximum length of the name is 30 characters.

Example: Change the name of a storage pool

Rename storage pool STGPOOLA to STGPOOLB:
rename stgpool stgpoola stgpoolb

Related commands

Table 1. Commands related to RENAME STGPOOL
Command Description
BACKUP STGPOOL Backs up a primary storage pool to a copy storage pool.
DEFINE STGPOOL Defines a storage pool as a named collection of server storage media.
DELETE STGPOOL Deletes a storage pool from server storage.
QUERY STGPOOL Displays information about storage pools.
RESTORE STGPOOL Restores files to a primary storage pool from copy storage pools.
UPDATE STGPOOL Changes the attributes of a storage pool.