Copying archive data sets

You can copy or move an archive from one device to another. RUV registers the new archives in the repository.

Note

Do not concatenate input data sets. If you want to combine archives, use the ARCHIVE ACCUM command. Combining offsite storage functions with use of the LOCATION keyword can simplify disaster recovery preparations.

Using the ARCHIVE ARCHIVE_IN command

To copy or move an archive, use the ARCHIVE ARCHIVE_IN command, as shown in the following example:

ARCHIVE ARCHIVE_IN(GNL.ARCVDASD)
    SCRATCH(YES)
    ARCHIVE_OUT(ARCVTAPE
        COMMENT('GENERAL LEDGER LOCAL ARCHIVE')
        LOCATION(LOCAL)
        STATUS(ACTIVE)
        MUST_COMPLETE(YES)
        )
    ARCHIVE_OUT(ARCVTAP2
        COMMENT('GENERAL LEDGER REMOTE ARCHIVE')
        LOCATION(REMOTE)
        STATUS(INACTIVE)
        MUST_COMPLETE(NO)
        )
    ;

Using the ARCHIVE_IN keyword

Use the required ARCHIVE_IN keyword on the ARCHIVE ARCHIVE_IN command to specify the data set name of the archive to copy or move. Set the value to the ddname of the input archive data set in the JCL, or set it to the fully qualified data set name to have RUV dynamically allocate the data set.

Using the ARCHIVE_OUT keyword

Use the required ARCHIVE_OUT keyword on the ARCHIVE ARCHIVE_IN command to specify the new data set name of the copied or moved archive. Set the value to the ddname of the output archive data set in the JCL.

You can specify as many ARCHIVE_OUT keywords as the number of copies you need, limited by the available system resources (the storage buffers for the outputs that are created).

You can code the following optional keywords with the ARCHIVE_OUT keyword on the ARCHIVE ARCHIVE_IN command:

COMMENT (see Using-the-COMMENT-keyword)
LOCATION (see Using-the-LOCATION-keyword)
STATUS (see Using-the-STATUS-keyword)
MUST_COMPLETE (see Using-the-MUST_COMPLETE-keyword)

Code these keywords and their values after the ddname value but before the closing parenthesis for the ARCHIVE_OUT value. Only one archive copy should have an active status.

Coding ARCHIVE ARCHIVE_IN statements

To code an ARCHIVE ARCHIVE_IN statement, use the following syntax:

ARCHIVE ARCHIVE_IN(ddn8_or_dsn44)
    { SCRATCH(NO | YES) }
    ARCHIVE_OUT(ddn8
        { LOCATION(locname8) }
        { COMMENT('comment fields') }
        { STATUS(ACTIVE | INACTIVE) }
        { MUST_COMPLETE(YES | NO) }
        )
    { ARCHIVE_OUT(ddn8, ...) }
    ;

For clarity, you can also use the following unit-of work-syntax to copy archives that contain UOW data:

ARCHIVE
UNIT_OF_WORK_IN(ddn8_or_dsn44)
UNIT_OF_WORK_OUT(ddn8) ;