Backup/Archive › Explicit ARCHIVE › Explicit ARCHIVE and DARCHIVE Syntax

Explicit ARCHIVE and DARCHIVE Syntax

Explicit ARCHIVE and DARCHIVE command syntax is:

DARCHIVE

SIMULATE,DSNAME=,VOLUME=,NEWNAME=,RETPD=,EXPDT=,RECATALOG,
UNCATALOG,NOCATALOG,
SCRATCH,NOSCRATCH,RESET,NORESET,PASSWORD=

ARCHIVE

Same parameters as above with the addition of MEMBER=,DEFER

SIMULATE

This simple parameter can be placed on each DARCHIVE or ARCHIVE command in lieu of using the MODESET SIMULATE command. For a given input stream, simulate and non-simulate modes should not be intermixed.

DSNAME=

The full explicit name of the non-VSAM data set or VSAM cluster to be archived (relative GDG version number is permitted, but if multiple generations are processed in the same job step, they must be specified in the descending order of their values, that is, -2, -1, 0). The catalog is searched to find VSAM clusters. The catalog is also searched to find non-VSAM data sets unless you also supply the volume parameter.

VOLUME=

This optional parameter specifies the volume serial number of the device containing the data set to be archived. If the data set is not found on this device, the request is rejected.

NEWNAME=

An alternative data set name to be assigned to the archived data set (a relative GDG name is also permitted). The archived version is indexed under this name, which can be up to 44 characters in length.

RETPD=

A one- to five-digit number to specify a retention period to be assigned to data sets. If this parameter is omitted, a default value is obtained from sysparm ARCRETPD. For more information, see the section Year 2000 Considerations in the chapter "General Information."

EXPDT=

An expiration date in an accepted CA Disk format can alternatively be specified to designate the period of time the data set will remain archived. (If the value given is less than the current date, the current date will be used as the EXPDT.) For more information, see the section Year 2000 Considerations in the chapter "General Information."

MEMBER=

To archive a subset of a partitioned data set, this parameter is used to specify one or more member and/or group names to constitute the archived version of the data set. (A maximum of 25 entries is supported.)

This parameter is valid only when an immediate archive is being done (not a deferred archive).

DEFER

This parameter can be specified on the ARCHIVE command to indicate that the request is to be queued for later processing. It can be used in lieu of of changing the ARCHIVE command to DARCHIVE.

PASSWORD=

The password parameter provides the password value required to access a protected VSAM cluster. If the cluster is to be archived but not deleted, the read-level or higher access is required. If the cluster is to be deleted, the master-level password is required.