<archive backup statement>
── ARCHIVE ─┬─ FULL ─────────┬─┬─────────────────────┬─────────────────────►
├─ INCREMENTAL ──┤ └─ <archive options> ─┘
└─ DIFFERENTIAL ─┘
►─┬─────────────────────────────────────────────────────────────────────┬──►
├─ FROM ── <archive disk volume> ─────────────────────────────────────┤
│ ┌◄─────────────────────────────── , ──────────────────────────────┐ │
│ │ ┌◄───────────── , ────────────┐ │ │
└─┴─┴─┬─ <long file name> ──────┬─┴─ FROM ── <archive disk volume> ─┴─┘
└─ <long directory name> ─┘
►─┬───────────────────────────────────┬────────────────────────────────►
├─ TO ──<archive CD-R volume>───────┤
│ ┌◄────────────── , ─────────────┐ │
└─┴─ TO ── <archive tape volume> ─┴─┘
►─┬───────────────────────────────┬────────────────────────────────────►
└─ [ ── <task identifier> ── ] ─┘
►─┬─────────────────────────────────────┬──────────────────────────────┤
└─ ; ── <archive task equation list> ─┘Explanation
These ARCHIVE statement copies resident disk files to backup tape or CD-ROM volumes. You can use these statements to backup some or all of the disk files on various families; which files the archive subsystem selects for backup depends on which of the three statements you select.
The three variants of the ARCHIVE backup statement are as follows:
-
ARCHIVE FULL
Copies all specified resident disk files on the named families to a CD-ROM volume or to one or more backup tapes.
-
ARCHIVE INCREMENTAL
Copies to backup CD-ROM or tape volumes only those specified resident disk files that have been changed or added since the last archive backup procedure was performed. This statement does not copy files solely on the basis of the last full archive operation.
-
ARCHIVE DIFFERENTIAL
Copies to backup CD-ROM or tape volumes the specified resident disk files that have been changed or added to the family or families since the last ARCHIVE FULL statement was executed.
For each of the ARCHIVE backup statements, files are selected by the disk subsystem and then accepted or rejected for the actual archive procedure. The archive support library determines which of the candidate files can and cannot be archived to a tape or CD-ROM volume.
If your installation has compiled its own selector support library, you can use library equation to direct the file selection process through that library.
You can use the backup CD-ROM and tape files created by these statements as input for the ARCHIVE MERGE, ARCHIVE RESTORE, and ARCHIVE RESTOREADD statements, and for the COPY and ADD statements.
Special Considerations for Backup Tape and CD-ROM Volumes
It is necessary to plan what volume names and, optionally, what serial numbers to use for the backup volume. Otherwise, archive restore requests result in the following RSVP messages for tape or CD-ROM volumes it decides to use:
NO FILE <volume name>/FILE000 (MT) [<serial number>]
NO FAMILY <volume name> (CD) [<serial number>]
You need to select scratch tapes to use in the archiving procedure from your tape library. It is recommended that you label the scratch tapes used in your archiving procedures with an unchanging serial number clearly visible on the tape exterior. Always use archive scratch tapes in numeric sequence.
The operator must have a method to find those tape or CD-ROM volumes and load them onto a tape or CD-ROM unit. Keep in mind the following considerations:
-
Tape volumes always have serial numbers that you assign in advance with the SN (Serial Number) system command. Since the serial numbers for tape volumes are usually unique and assigned in numerical sequence, it is relatively easy to build a tape library with each volume stored according to its serial number.
-
For CD-ROM volumes, you cannot assign the serial numbers in advance, and when you do specify a serial number in an archive backup request, the archive system puts the same serial numbers on all the CD-ROM volumes created by that backup request.
Therefore, you must systematically assign volume names and, optionally, serial numbers to CD-ROM volumes for each archive backup request you issue and store those CD-ROM volumes in an organized library so that operators can locate them when archive restore asks for them.
Checking the Progress of the Backup
You can use the HI (Cause Exception Event) system command to check the progress of an ARCHIVE backup statement. A command of the form <mix number> HI displays the number of files already copied and other information.
Examples
The following example illustrates how to perform a complete backup of the TESTPACK family:
ARCHIVE FULL FROM TESTPACK
The following example shows how to perform a complete backup of all online families:
ARCHIVE FULL
The following example creates backup copies of the files under the SYSTEM directory on the families DISK and HLUNIT that do not already have archive backup copies:
ARCHIVE INCREMENTAL & VERIFY SYSTEM/= FROM DISK,
SYSTEM/= FROM HLUNIT TO SYSTAPE;The following example illustrates how to perform a backup of files under the usercode DOE on the family TESTFAMILY that have been updated since the last ARCHIVE FULL statement:
ARCHIVE DIFFERENTIAL (DOE) = FROM TESTFAMILY
The following example shows how to back up files under the usercode MYCODE to a tape volume called NEWTAPE from the scratch pool POOL1:
ARCHIVE DIFFERENTIAL (MYCODE) = FROM TESTFAMILY TO NEWTAPE (KIND = TAPE, SCRATCHPOOL = POOL1);
The following example shows how to perform a complete backup of the XDATA disk family to CD-ROM volumes. In this case, because CDCOPIES is 2, the system produces duplicate copies of the files onto two sets of CD-ROM volumes.
ARCHIVE FULL *= FROM XDATA
TO XDARC (KIND=CD, CDCOPIES=2, SERIALNO=555555);In this example, both sets of CD-ROM volumes get the name XDARC and the serial number 555555. If more files are on the disk family XDATA than fit on one CD‑ROM volume, then the system requests additional CD-ROM volumes during the copy process. The system gives those additional CD-ROM volumes the volume name XDARC and the serial number 555555 also.
