- ARCHIVE Backup Statement
- ARCHIVE Statement Options
- ARCHIVE Disk Volume
- ARCHIVE Disk Volume Attribute List
- ARCHIVE Tape Volume
- ARCHIVE Tape Volume Attribute List
- ARCHIVE CD Volume
- ARCHIVE CD Volume Attribute List
- ARCHIVE Task Equation List
- ARCHIVE MERGE Statement
- ARCHIVE PURGE Statement
- ARCHIVE RELEASE Statement
- ARCHIVE RESTORE Statement
- ARCHIVE ROLLOUT Statement
- ARCHIVE VOLUME Statement
| Note: | Non-privileged users cannot use ARCHIVE statements for files within the permanent directory namespace. |
The archive subsystem consists of six different ARCHIVE statements. These statements enable you to
-
Copy files to archive backup tape and CD-ROM volumes.
-
Maintain a record of the names, locations, and attributes of the archived files and directories.
-
Remove archive backup information for specified files.
-
Transfer archived files between backup tapes.
-
Restore archived files to disk.
-
Merge files onto a single tape or tape set.
The following paragraphs briefly describe the functions of the ARCHIVE statements:
-
Copying, transferring, and restoring files
You can perform library maintenance operations that include copying and transferring disk files to backup tape and CD-ROM volumes, restoring disk files from backup tape and CD-ROM volumes, and merging backup tape and CD-ROM volumes to a single tape or tape set.
-
Automatically maintaining an archive directory
The archive directory is a disk directory that records the names, locations, and attributes of disk files that have been transferred through archive operations to tape or CD-ROM volumes, or merged from many tape and CD-ROM volumes to one tape or tape set. The archive subsystem maintains an archive directory for each online disk family from which archive operations have been performed. These directories reside on the DL CATALOG family.
-
Controlling access using the support library
The support library is used by the ARCHIVE statement to control which files are copied during an archive operation. The archive support library rejects files that are requested by ARCHIVE statements based on various selection criteria. The support library is sometimes called the selector library.
Specifying Different ARCHIVE Statements
The following table lists all of the ARCHIVE statements and their functions.
At many sites, the use of the ARCHIVE statements to manipulate files under usercodes other than your own is limited to those usercodes whose security access is privileged. However, a WFL job that is started at an ODT without a usercode can use any one of the following ARCHIVE RESTORE statements.
ARCHIVE DIFFERENTIAL ARCHIVE FULL ARCHIVE INCREMENTAL
Copy resident disk files to library maintenance tape or CD-ROM volumes and are referred to as ARCHIVE backup statements.
Merges files from two or more library maintenance tape or CD-ROM volumes to a single tape or tape set.
Removes the backup records for specific files or directories from the archive directory of the specified disk family. This statement does not affect resident disk files in any way.
Removes files from disk that are not in use and have up-to-date archive backup records. This statement is intended to free disk space for other uses. The removed files can be restored by the archive AUTORESTORE feature and the WFL statements ARCHIVE RESTORE and ARCHIVE RESTOREADD. In addition to the ARCHIVE RELEASE statement, see the WFL statements REMOVE and REMOVE DESTROY.
ARCHIVE RESTORE ARCHIVE RESTOREADD
Restore archived files from library maintenance tape and CD-ROM volumes to disk.
Selects and copies disk files to a library maintenance tape and CD-ROM volumes. It then removes the original disk files from the disk. This statement is intended to free disk space for other uses.
Generations
The archive subsystem stores information about backups in the SYSTEM/ARCHIVE/<family name>/<number> directory for a family. The archive subsystem can store information about one to four different backups of the same generation of any given disk file. The archive subsystem does not store information about different generations of the same file. When you execute an ARCHIVE backup, if the resident generation of a file is different from the generation listed in the archive directory, the archive subsystem deletes all the information about the old generation of the file. It deletes information including the backup tape, CD serial numbers and volume names, and stores the information about the new generation of the file and its backup tape(s) or CD into the ARCHIVE directory.
The archive subsystem calculates the generation of a file based on several attributes. The PD system command displays most of the attributes that the archive subsystem uses to calculate the generation of a file:
ARCHIVE ENTRY 0 (filekind):
CYCLE: number VERSION: number
TIMESTAMP: date and time
CREATION: date and time
LASTACCESS: date and time
ALTER/MODIFY: date and timeThe calculation does not use the LASTACCESS date or time. "ALTER/MODIFY" is the more recent of either the ALTERDATE and ALTERTIME or the ATTMODIFYDATE and ATTMODIFYTIME. For example,
-
ARCHIVE INCREMENTAL does not copy any resident file whose generation matches the generation of its existing backup. ARCHIVE INCREMENTAL deletes all existing backup information about any file it copies and stores the information about the resident version of the file, which it copied into the ARCHIVE directory.
-
If ARCHIVE FULL of a file is done with existing backups and if the FILEKIND of the resident file differs from that of the backups, or if the ALTERDATE or ALTERTIME of the resident file differs from that of the backups, then the archive subsystem erases all the information about the old backups and replaces it with that of the resident file's new backup.
FAMILY Specifications
Family substitution is used if the job or task has an active family specification. Only the primary family name is used. Refer to FAMILY Assignment and Interrogating Complex Task Attributes.
