DELCDS

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

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

Syntax

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

Required parameters

Parameter	Description
dataSetName	A specific data set name
VOLSER	The volume serial the data set resides on

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

Examples

The following examples demonstrate use of the command.

Deleting an expired cloud data set

Example:

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

Deleting a cloud data set that has not yet expired