ARCHIVE Statement Options

<archive options>

──┬──────────────────────────────────┬─────────────────────────────────┤
  │ ┌◄─────────────────────────────┐ │
  └─┴─┬──────────────────────────┬─┴─┘
      ├─/1\─┬─ & ── COMPARE ─────┤
      │     └─ & ── VERIFY ──────┤
      ├─/1\─┬─ & ── DSONERROR ───┤
      │     └─ & ── WAITONERROR ─┤
      ├─/1\─ & ── RELEASE ───────┤
      ├─/1\─ & ── REPORT ────────┤
      └─/1\─ SKIPEXCLUSIVE ──────┘

Explanation

The following table options are available for all of the ARCHIVE statements.

COMPARE

Compares the input file and the output file bit by bit immediately after the file is copied. If a compare error occurs, the process will stop and ask the operator if the file must be recopied.

DSONERROR

Causes the system to discontinue the archiving process if any error is detected.

RELEASE

Causes library maintenance to execute an “archive release” operation for each file that library maintenance successfully copies and archives. The archive release operation removes the resident version of the file from the disk. You can use the RELEASE option only in ARCHIVE FULL, ARCHIVE INCREMENTAL, and ARCHIVE DIFFERENTIAL statements.

Note: Library maintenance does not release a file that is in use by another program.

REPORT

Causes library maintenance to print a report of the files it copied and any errors encountered. When & REPORT is specified, library maintenance does not write “file copied” messages in the job log or the system sumlog.

SKIPEXCLUSIVE

Causes the system to not copy those files from disk that are opened with EXCLUSIVE=TRUE or that are KEYEDIOII files marked as being updated.

WAITONERROR

Causes the archive process to issue an RSVP message whenever an error occurs during the archive process.

Examples of possible errors include: requesting a file or directory that is missing, or failing to open a tape successfully. The RSVP message halts the archive process until the operator or programmer responds with OK or DS. A response of OK causes the archive process to continue archiving with other files or tapes. A response of DS will terminate the archive process. After investigating the error which created the RSVP message, you can re-issue the archive statement.

VERIFY

This option is similar to the COMPARE option. However, instead of comparing the copied file bit by bit, the file is read again and its overall checksum is compared. When copying to a CD-ROM volume, the system ignores the VERIFY option.