TSO Command Processor › DARCHIVE — Deferred Archive › DARCHIVE Command

DARCHIVE Command

The DARCHIVE command requests the deferred archival of a data set.

The DARCHIVE command syntax is:

DARCHIVE	 {DSN(data set names)}

{VOLUME(volser)}
{NEWNAME(dsname)}
{EXPDT(date)}
{RETPD(nnnnn)}
[UNCATALOG]
[NOCATALOG]
[RECATALOG]
[SCRATCH]
[NOSCRATCH]
[RESET]
[NORESET]
{PASSWORD(password)}

DSN

A list of one to ten names of data sets to be archived. The DSN can be eliminated from the command line and a prompt for a data-set name list will be issued. In the case of a GDG, either the relative or absolute name can be used.

VOLUME

This parameter must be supplied if either no entry exists in the system catalog for the data set, or if the catalog points to a data set with the same name on a different volume.

NEWNAME

A data set can be indexed in the archives under a different name, supplied as the value of this parameter. In the case of a GDG, either the relative or absolute name can be specified.

EXPDT

This parameter can be used to provide the date on which the archived data set can be deleted from the archives. It must be in an accepted CA Disk format. For more information, see the section Year 2000 Considerations in the chapter "General Information."

RETPD

An alternative means of specifying the date on which the archived data set can be deleted from the archives is to specify a number of days it is to be retained in the archives. The number of days must be a one- to four-digit number. For more information, see the section Year 2000 Considerations in the chapter "General Information."

UNCATALOG

The normal default catalog action after a data set is archived, but it can also be specified.

NOCATALOG

This parameter can be used to preclude the default action of uncataloging at the completion of data set archival.

RECATALOG

The presence of this parameter results in the recataloging of a data set to the CA Disk pseudo- volume upon successful archival.

SCRATCH

The normal default scratch action after a data set is archived, but it can also be specified.

NOSCRATCH

The scratching of a data set that normally occurs after archival is suppressed by the inclusion of this parameter.

RESET

By default, the change bit for the data set is reset (turned off) if the data set is NOT scratched. Although this is the default, it can still be specified.

NORESET

The resetting of the change bit that normally occurs when a data set is backed up (archived, but not scratched) is suppressed by the inclusion of this parameter.

PASSWORD

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