ARCHIVE

Causes FILEDATA to select resident and nonresident disk files and to display archive information for those files.

When the ARCHIVE modifier is used with the ATTRIBUTES request, FILEDATA displays the backup tape and CD volume names, serial numbers, and backup times for each resident or nonresident file selected that has archive backup information.

When the ARCHIVE modifier is used with the CODEFILEINFO request, FILEDATA displays the backup tape and CD volume names, serial numbers, and backup times for each resident code file selected that has archive backup information.

When the ARCHIVE modifier is used with the HEADERCONTENTS request, FILEDATA displays the hexadecimal value of the archive record for each resident or nonresident file selected that has archive backup information.

When the ARCHIVE modifier is used with the NOREPORTS request, FILEDATA collects the archive backup information for files and puts the information into the database so that later requests can report the information.

ARCHIVE is invalid with the CONTAINER, TAPE, and WRAPPEDFILES modifiers.

On systems running with CATALOGING or SECOPT TAPECHECK=AUTOMATIC, the report may include the warning message, “***WARNING, ONE OR MORE OF THESE BACKUP TAPES HAVE BEEN OVERWRITTEN”. However, this warning message will only be included if the backup tapes for the file are listed in the volume library or volume directory.

The warning message may appear in the ARCHIVE report if a backup tape has been purged or overwritten. However, this message will not always appear even though the backup tape is no longer valid. When a tape containing archive backups is purged or overwritten, the system does not immediately update the archive records for the files on the tape to indicate that the backup copy may no longer be available. Therefore, if FILEDATA or another program attempts to print a report on the status of the tapes containing archive backups, the report might not indicate that some of the backup tapes may no longer be available.

Running a HEADERCONTENTS report against a given pack family makes this warning message fully accurate in subsequent FILEDATA runs until more tapes are overwritten. The PD system command also shows the same warning message for a given file. The message for the PD command is always accurate if the tapes are in the volume library or volume directory.