DELCDS

The DELCDS command is used 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 will be updated in the UI during the periodic synchronization, which by default, is performed automatically every 5 minutes. If needed, on-demand synchronization can be performed via the UI, by clicking the “SYNC WITH STORAGE” button in the “Agents” tab. See the Administration and User Guide for more information.

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

A specific data set name.

volser

The volume serial the data set resides on

DELCDS - Optional Parameters

Option

Description

Format

Examples

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)

PURGE

Deletes the CDS, although it has not yet expired. The user must have READ access to the Model9 Resource M9.CLI.DELCDS.PURGE

-

-

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

Last updated