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 in 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.
Syntax
[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:
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
Deleting a cloud data set that has not yet expired