Administrator's Reference

DELETE VOLUME (Delete a Storage Pool Volume)

Use this command to delete a storage pool volume and, optionally, the files stored in the volume. If the volume has data, to delete the volume you must do one of the following:

If you are deleting several volumes, delete the volumes one at a time. Deleting more than one volume at a time can adversely affect server performance.

Storage pool volumes cannot be deleted if they are in use. For example, a volume cannot be deleted if a user is restoring or retrieving a file residing in the volume, if the server is writing information to the volume, or if a reclamation process is using the volume.

Privilege Class

To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the storage pool to which the volume is defined.

Syntax

                                 .-DISCARDdata--=--No------.
>>-DELete Volume--volume_name----+-------------------------+---->
                                 '-DISCARDdata--=--+-No--+-'
                                                   '-Yes-'
 
      .-Wait--=--No------.
>-----+------------------+-------------------------------------><
      '-Wait--=--+-No--+-'
                 '-Yes-'
 

Parameters

volume_name (Required)
Specifies the name of the volume to delete.

DISCARDdata
Specifies whether files stored in the volume are deleted. This parameter is optional. The default value is NO. Possible values are:

No
Specifies that files stored in the volume are not deleted. If the volume contains any files, the volume is not deleted.

Yes
Specifies that all files stored in the volume are deleted. The server does not need to mount the volume for this type of deletion.

If the volume being deleted is a primary storage pool volume, the server checks whether any copy storage pool has copies of files that are being deleted. When files stored in a primary storage pool volume are deleted, any copies of these files in copy storage pools are also deleted.

When you delete a disk volume in a primary storage pool, the command also deletes any files that are cached copies (copies of files that have been migrated to the next storage pool).

Do not use the DELETE VOLUME command with DISCARDDATA=YES if a restore process (RESTORE STGPOOL or RESTORE VOLUME) is running. The DELETE VOLUME command could cause the restore to be incomplete.

If you cancel the DELETE VOLUME operation during processing or if a system failure occurs, some files might remain on the volume. You can delete the same volume again to have the server delete the remaining files and then the volume.

Wait
Specifies whether to wait for the server to complete processing this command in the foreground. This parameter affects processing only when you have also requested that any data on the volume be discarded. This parameter is optional. The default value is No. Possible values are:

No
Specifies that the server processes this command in the background. You can continue with other tasks while the command is being processed. The server displays messages that are created from the background process either in the activity log or the server console, depending on where messages are logged.

Yes
Specifies that the server processes this command in the foreground. You wait for the command to complete before continuing with other tasks. The server then displays the output messages to the administrative client when the command completes.
Note:You cannot specify WAIT=YES from the server console.

Examples

Task

Delete storage pool volume stgvol.1 from the storage pool FILEPOOL.

Command:
delete volume stgvol.1

Related Commands

Table 107. Commands Related to DELETE VOLUME

Command Description
CANCEL PROCESS Cancels a background server process.
DEFINE VOLUME Assigns a volume to be used for storage within a specified storage pool.
MOVE DATA Moves data from a specified storage pool volume to another storage pool volume.
MOVE DRMEDIA Moves DRM media onsite and offsite.
QUERY CONTENT Displays information about files in a storage pool volume.
QUERY DRMEDIA Displays information about disaster recovery volumes.
QUERY PROCESS Displays information about background processes.
QUERY VOLUME Displays information about storage pool volumes.
UPDATE VOLUME Updates the attributes of storage pool volumes.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]