DELVOL

You can use the DELVOL command to delete backup versions created by the full-volume dump policy runs. The BMC AMI Cloud server finalization process automatically deletes expired backups as part of the generation management process. To use this command, you must have READ access to the BMC AMI Cloud resource M9.CLI.DELVOL.

Logic

The deleted full-volume dump is visible in the UI until a periodic synchronization, which by default, is performed automatically every 5 minutes. If needed, you can perform on-demand synchronization in the UI by clicking the SYNC WITH STORAGE button in the Agents tab.

Warning

The DELVOL action cannot be undone.

Syntax

M9CLI DELVOL <volser>
UNIQUEID(<uniqueId>)
[PURGE]

Required parameters

Parameter	Description
volser	A specific volume name
uniqueid	The unique id or a partial prefix of the unique id of the deleted full-volume dump

Optional parameters

Option[Short option]	Description	Format	Examples
PURGE	Deletes backup of a full-volume dump, although it has not yet expired You must have READ access to the BMC AMI Cloud resource M9.CLI.DELVOL.PURGE	N/A	N/A

Output

The output displays the given DELVOL command and parameters, followed by the requested information:

ZM9I073I Backup of volume <volume_name> with UNIQUEID <uniqueid> was deleted successfully

If the full-volume dump has not yet expired, it will not be deleted, and the message ZM9I077E will be displayed:

ZM9I077E Backup of volume <volume_name> with UNIQUEID <uniqueid> has not expired yet, use the PURGE keyword to force delete regardless of expiration

If the full-volume dump specified doesn't exists, the message ZM9I058E will be displayed:

ZM9I058E UNIQUEID <uniqueid> was not found for volume: <volume_name>

Example

The following example demonstrates use of the command.

Deleting a backup that has not yet expired or with no expiration date

TSO M9CLI DELVOL M9SYS1 UNIQUEID(9009F2C3) PURGE