DELETE STGPOOLDIRECTORY (Deleting a storage pool directory)

Use this command to delete a definition for a storage pool directory.

Privilege class

To issue this command, you must have system privilege.

You might want to delete a storage pool directory for the following reasons:

To decommission old storage.
To discontinue using the local disk before moving data to the cloud.
To no longer maintain the data in the storage pool directory because there is no requirement to do so.
After a hardware failure when you cannot verify the validity of the data in the storage pool directory.

Restrictions:

You can issue this command only when no containers are assigned to the storage pool directory. Issue the QUERY CONTAINER command to determine whether any containers are assigned to the storage pool directory.
To remove containers from a storage pool directory, you must issue the UPDATE STGPOOLDIRECTORY command and specify the ACCESS=DESTROYED parameter. Then, issue the AUDIT CONTAINER command and specify the ACTION=REMOVEDAMAGED parameter. Verify that the containers are removed.

Syntax


>>-DELete STGPOOLDIRectory--pool_name--directory---------------><

Parameters

pool_name (Required): Specifies the storage pool that contains the directory to delete. This parameter is required.
directory (Required): Specifies the file system directory of the storage pool to delete. This parameter is required.

Example: Update a storage pool directory to prepare for deletion

Update the storage pool directory that is named DIR1 in storage pool POOLA to mark as destroyed. When a storage pool is marked as destroyed, you can delete it.

update stgpooldirectory poola /storage/dir1 access=destroyed

update stgpooldirectory poola e:\storage\dir1 access=destroyed

Example: Delete a storage pool directory

Delete the storage pool directory that is named DIR1 in storage pool POOLA.

delete stgpooldirectory poola /storage/dir1

delete stgpooldirectory poola e:\storage\dir1

Table 1. Commands related to DELETE STGPOOLDIRECTORY
Command	Description
DEFINE STGPOOL	Defines a storage pool as a named collection of server storage media.
DEFINE STGPOOLDIRECTORY	Defines a storage pool directory to a directory-container or cloud-container storage pool.
QUERY STGPOOLDIRECTORY	Displays information about storage pool directories.
UPDATE STGPOOLDIRECTORY	Changes the attributes of a storage pool directory.
QUERY EXTENTUPDATES	Displays information about updates to data extents in directory-container storage pools.