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