DELCDS


You can use the DELCDS command to delete a cloud data set (CDS) and its catalog entry.

DELCDS - Logic

Use DELCDS instead of an IDCAMS DELETE to delete a cloud data set, both the catalog entry and the data itself will be removed. The selected resource is updated in the UI during the 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.

The command supports additional keywords to allow deletion of a cloud data set that has not yet expired or a data set that does not have a valid expiration date. To determine whether a data set has expired, the command follows the logic described in Determining a data set expiration date.

Warning

The DELCDS action cannot be undone.

DELCDS - Syntax

M9CLI DELCDS <dsname> VOLSER(<volser>)
 
[ENTRY(<entry>]
 
[UNIQUEID(uniqueid)]
 
[PURGE]

DELCDS - Required parameters

Parameter

Description

dsname

volser

The volume serial the data set resides on

A specific data set name

DELCDS - Optional Parameters

Option

Description

Format

Examples

PURGE

Deletes the CDS, although it has not yet expired

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

-

ENTRY

The specific entry number if more than one version exists

numeric

ENTRY(1)

UNIQUEID

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

hexadecimal

UNIQUEID(0abb35f7)

-

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



ZM9I015I Cloud data set <dsname> on volume <volser> was deleted successfully

ZM9I014E Cloud data set <dsname> with UNIQUEID <uniqueid> has not expired yet, use the PURGE keyword to force delete regardless of expiration



DELCDS - Examples

Deleting an expired cloud data set

TSO M9CLI DELCDS M9.DEMO.CDS.PS VOLSER(MAAA00)

Deleting a cloud data set that has not yet expired

TSO M9CLI DELCDS M9.DEMO.CDS.NOTEXP VOLSER(MAAA00) PURGE

 

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