IBM Tivoli Storage Manager, Version 7.1

DELETE STGPOOL (Delete a storage pool)

Use this command to delete a storage pool. To delete a storage pool, you must first delete all volumes assigned to the storage pool.

You cannot delete a storage pool that is identified as the next storage pool for another storage pool. For more information on storage pool hierarchy, see the NEXTSTGPOOL parameter in the DEFINE STGPOOL command.

Important:
  • Do not delete a storage pool that is specified as a destination for a management class or copy group in the ACTIVE policy set. Client operations might fail as a result.
  • When deleting a copy storage pool that has been previously included in a primary storage-pool definition (specifically in the COPYSTGPOOLS list), you must remove the copy storage pool from the list prior to deletion. Otherwise, the DELETE STGPOOL command fails until all references to that copy pool have been removed. For each primary storage pool with a reference to the copy storage pool to be deleted, remove the reference by entering the UPDATE STGPOOL command with the COPYSTGPOOLS parameter with all previous copy storage pools except the copy storage pool to be deleted.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-DELete STGpool--pool_name-----------------------------------><

Parameters

pool_name (Required)
Specifies the storage pool to delete.

Example: Delete a storage pool

Delete the storage pool named POOLA.
delete stgpool poola

Related commands

Table 1. Commands related to DELETE 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.
QUERY STGPOOL Displays information about storage pools.
AIX operating systems HP-UX operating systems Sun Solaris operating systems Windows operating systems SET DRMCOPYSTGPOOL Specifies that copy storage pools are managed by DRM.
UPDATE STGPOOL Changes the attributes of a storage pool.


Feedback