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 that are 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 about storage pool hierarchy, see the NEXTSTGPOOL parameter in the DEFINE STGPOOL command.

Restrictions:
  • AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsFor container storage pools, delete all storage pool directories before you delete the storage pool.
  • 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 you delete a copy storage pool that was previously included in a primary storage-pool definition (specifically in the COPYSTGPOOLS list), you must remove the copy storage pool from the list before deletion. Otherwise, the DELETE STGPOOL command fails until all references to that copy pool are 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.
AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsDEFINE STGPOOLDIRECTORY Defines a storage pool directory to a directory-container or cloud-container storage pool.
AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsDELETE STGPOOLDIRECTORY Deletes a storage pool directory from a directory-container or cloud-container storage pool.
QUERY STGPOOL Displays information about storage pools.
AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsQUERY STGPOOLDIRECTORY Displays information about storage pool directories.
AIX operating systemsHP-UX operating systemsOracle Solaris operating systemsWindows operating systemsSET DRMCOPYSTGPOOL AIX operating systemsHP-UX operating systemsOracle Solaris operating systemsWindows operating systemsSpecifies that copy storage pools are managed by DRM.
UPDATE STGPOOL Changes the attributes of a storage pool.
AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsUPDATE STGPOOLDIRECTORY Changes the attributes of a storage pool directory.