ALTER

Related topic

Command line interface CLI

The ALTER command alters the expiration date of backup, archive, and Cloud Data Set (CDS) data sets.

Important

If you are using HCP, Pure Storage, or Cohesity, you must enable versioning to use the ALTER command.

Logic

The ALTER command accepts one resource at a time. You must specify one of the following types of data sets:

CDS
BACKUP
ARCHIVE

You must have ALTER access to the data set being altered.

Syntax

M9CLI ALTER <dataSetName> TYPE(<CDS|BACKUP|ARCHIVE>)

UNIQUEID(<uniqueID>)

DATE(yyyy/mm/dd)

[PURGE]

Required parameters

Parameter	Description	Format
dataSetName	A specific data set name, which can be enclosed in apostrophes	Full name
TYPE	Type of data set Warning Important CDS IMPORTS are not supported.	Valid values are: CDS BACKUP ARCHIVE
UNIQueid	An 8-byte ID that, when combined with the data set name, identifies each backup copy	First 8 characters
DATE	Specifies a future date on which to expire the selected data set. You cannot specify a date that has already passed.	yyyy/mm/dd

Optional parameters

Parameter	Description
PURGE	Deletes the data set, although it has not yet expired You must have READ access to the following BMC AMI Cloud resources: M9.CLI.ALTER.ARCHIVE.PURGE M9.CLI.ALTER.BACKUP.PURGE M9.CLI.ALTER.CDS.PURGE

Output

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

ALTER QA.SMS.SG1QNOBK.CLI.ALTER.NOEXPIRE.BKP TYPE(<dataSetType>) UNIQUEID(<uniqueID>) DATE(<yyyy/mm/dd>)
Model9 CLI SYSNAME: M9U1 DATE: 2025/03/18 VERSION: 4.1.0
ZM9I088I Data set QA.SMS.SG1QNOBK.CLI.ALTER.NOEXPIRE.BKP was altered successfully