IBM Tivoli Storage Manager, Version 7.1

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 so that the same names can be used on a configuration manager and its managed servers.

When you change a storage pool name, any administrators with restricted storage privilege for the old storage pool are automatically given restricted storage privilege for the renamed storage pool. However, if a management class or copy group specifies the existing storage pool as the destination for files, the destination is not changed to the new storage pool name.

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

Privilege class

To issue this command, you must have system privilege.

Syntax


>>-REName STGpool--current_pool_name--new_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.

Feedback