DELBACK

You can use the DELBACK command to delete non-expired backups that were created by the BACKDSN command. Expired backups are automatically deleted by the life cycle process and backups created by a policy are deleted by the policy as part of the generation management process. To use this command, you must have READ access to the BMC AMI Cloud resource M9.CLI.DELBACK.

Related topic

CLI Command Reference

Logic

The deleted data set 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 SYNC WITH STORAGE in the Agents tab.

Warning

The DELBACK action cannot be undone.

Syntax

M9CLI DELBACK <dataSetName>
 UNIQUEID(<uniqueId>)
 [PURGE]

Required parameters

Parameter

Description

dataSetName

A specific data set name

UNIQUEID

The unique ID or a partial prefix of the unique id of the deleted backup

Optional parameters

Option [short option]

Description

Format

Examples

PURGE

Deletes backup of a data set, although it has not yet expired

You must have READ access to the BMC AMI Cloud resource M9.CLI.DELBACK.PURGE.

NA

NA

Output

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

ZM9I055I Backup of data set <dataSetName> with UNIQUEID <id> was deleted successfully

If the data set has not yet expired, it will not be deleted and message M9I057E will be displayed:

ZM9I057E Backup of data set <dataSetName> has not yet expired, use the PURGE keyword to force delete regardless of expiration

Example

The following example demonstrates use of the command. 

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

Example:
TSO M9CLI DELBACK M9.USER.SOURCE UNIQUEID 9A09F2C3 PURGE

 

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