DELARC

You can use the DELARC command to delete an expired archived data set and its catalog entry, without having to recall it first.

Logic

Use DELARC instead of IDCAMS DELETE to delete an archived data set without causing an automatic recall. 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.

Related topic

CLI-command-reference

The command supports additional keywords to allow the deletion of an archived 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 DELARC action cannot be undone.

Syntax

M9CLI DELARC <dataSetName>
 [PURGE]

Required parameters

Parameter

Description

dataSetName

A specific data set name

Optional parameters

Option

Description

Format

Examples

PURGE

Deletes the archived data set, although it has not yet expired

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

NA

NA

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

Archived data set deleted: <dataSetName>

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

 ZM9I038E Archive data set has not yet expired, use the PURGE keyword to delete data set <dataSetName> 

Examples

The following examples demonstrate use of the command.

Deleting an expired archived data set

Example:
TSO M9CLI DELARC M9.APPL.SMF.TEMP

Deleting an archived data set that has not yet expired

Example:
TSO M9CLI DELARC M9.APPL.SMF.PROD PURGE

 

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