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.

DELVOL - Logic

The user must have READ access to the BMC AMI Cloud Resource M9.CLI.DELVOL.

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 via the UI, by clicking the SYNC WITH STORAGE button in the Agents tab.

Warning

The DELVOL action cannot be undone.

DELVOL - Syntax

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

DELVOL - 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

DELVOL - Optional parameters

Option[Short option]

Description

Format

Examples

PURGE

Deletes backup of a full-volume dump, although it has not yet expired

The user must have READ access to the BMC AMI Cloud Resource M9.CLI.DELVOL.PURGE



DELVOL - 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>

DELVOL - Examples

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

TSO M9CLI DELVOL M9SYS1 UNIQUEID(9009F2C3) PURGE

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*