The ARCHIVE command archives a single data set.


This command applies to both SMS-managed and non-SMS-managed data sets and is intended to supplement the scheduled policies. Several considerations pertain when archiving SMS-managed data sets using the ARCHIVE command:
  1. 1.
    The command verifies that the DFSMS Management Class parameter, “Command or Auto Migrate” is set to either COMMAND or BOTH.
  2. 2.
    The command will archive the data set regardless of the DFSMS Management Class “primary days non-usage” parameter’s value.
  3. 3.
    When specifying RETENTIONPERIOD, the new expiration date will override previous definitions, including the DFSMS Management Class specification.
Once archived, the archived data set is immediately available for LISTDSN and RECALL.
The archived data set will be available in the UI after a 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 Administrator and User Guide for more information.
The command supports the following additional keywords. Use of the keywords requires permission.
  • NOBACKUP - allows archive without a backup copy
  • RETENTIONPERIOD - used to specify a retention period for the archived data set.

ARCHIVE - Syntax

M9CLI ARCHIVE <dsname>

ARCHIVE - Required parameters

A specific data set name. The data set must be cataloged.

ARCHIVE - Optional Parameters

[Short option]
By default, the command will not archive a data set that is marked as changed according to the change bit, and does not have a backup copy. The command does not check whether the backup copy is the most current one, and there is no protection from manually deleting a backup of an archived data set. Specifying NOBCK will perform ARCHIVE regardless of the change bit and backup copy status. To use the keyword, the user must have READ access to the Model9 Resource M9.CLI.ARCHIVE.NOBCK
By default, the expiration date of the data set will be set according to the logic described in Determining a data set expiration date. Specifying RETENTIONPERIOD will set the retention period manually, regardless of previous dates in the VTOC, CATALOG or DFSMS Management Class. To use the keyword, the user must have READ access to the Model9 Resource M9.CLI.ARCHIVE.RETPD
A number followed by a character to specify:
d - days
w - weeks
m - months
y - years
3d - The data set will expire in 3 days

ARCHIVE - Output

The output displays the given ARCHIVE command and parameters, followed by the requested information:
ZM9I043I Data set <dsname> was archived successfully
If the data set could not be archived, message ZM9I044E will be displayed, followed by the relevant error messages:
ZM9I044E An eligible data set was not found for the archive command

ARCHIVE - Examples

Archiving a data set
Archiving a data set without a backup, to be deleted within a year
Last modified 4mo ago