BACKUP Request

The BACKUP request reports the usage information of backup library maintenance tapes or CDs for cataloged and archived disk files. You can use this report to determine whether library maintenance backup tapes and CDs contain active backups for a specified disk family or directory.

The BACKUP request produces a printed report of backup tapes and CDs for the specified disk family or for the files in a specified directory of the disk family. The report lists the tape and CD volumes that contain active backup copies of the disk files according to the SERIALNO value and the number of active backup files for each serial number. For archive backup tape and CD volumes, the report also includes the name of each tape or CD, the date and time the tape or CD was written, and any abnormal status for the tape or CD. The report also includes tape or CD volumes for archive files that have been removed with the WFL RELEASE statement, as well as files that have been removed with REMOVE statements, autoremove actions, and programmatic remove actions such as CLOSE with PURGE.

<backup request> 

── BACKUP ─┬───────────────────────────────────────────────────┬───────┤
           └─ : ─┬─────────────────────────────────────────────┤
                 │ ┌◄────────────────────────────────────────┐ │
                 └─┴─┬─ ARCHIVE ───────────────────────────┬─┴─┘
                     ├─ BACKUPSN ── = ──<serial number>────┤
                     ├─ CATALOGUE ─────────────────────────┤
                     ├─ DATABASE ────┬─ = ──<file title>───┤
                     ├─ DIRECTORY ───┤                     │
                     ├─ NEWDATABASE ─┘                     │
                     ├─ FAMILYNAME ── = ──<family name>────┤
                     ├─ ARCHIVEBACKUP ── = ─┬─ ANY ────────┤
                     │                      ├─ CURRENT ────┤
                     │                      ├─ NONCURRENT ─┤
                     │                      └─ NONE ───────┤
                     ├─ LEVEL ── = ──<integer>─────────────┤
                     ├─ NONRESIDENTONLY ───────────────────┤
                     ├─<output option>─────────────────────┤
                     └─ RESIDENTONLY ──────────────────────┘

Explanation

BACKUP

You can specify that the report is to be for the backup volumes of a specific file or directory of files by specifying DIRECTORY = <filename> or DIRECTORY = <directory name>.

The default value for this request reports both catalog and archive tape information. If you specify CATALOGUE and not ARCHIVE or ARCHIVEBACKUP, then only catalog backup tape information is reported. If you specify ARCHIVE or ARCHIVEBACKUP, and not CATALOGUE, then only archive information is reported.

Both resident and nonresident files are reported unless the RESIDENTONLY or NONRESIDENTONLY modifier is specified. For ARCHIVE tapes and CDs, the report includes tapes and CDs for files that are resident or nonresident files that have backup copies whose generation and timestamp values match those values for the resident files.

If you specify ARCHIVEBACKUP = CURRENT, then FILEDATA reports on all tapes and CDs that include archive backup copies of nonresident files or of resident files whose generation and timestamps match those of their backup copy.

If you specify ARCHIVEBACKUP = NONCURRENT, then FILEDATA reports on all tapes and CDs that include archive backup copies for resident files with generations and timestamps that do not match those of their backup copies.

If you specify a tape or CD serial number using the BACKUPSN modifier, then only the files on that tape or CD are reported.

For more information about <output option> refer to “Output Options” earlier in this section.

Notes:

  • The printed report that you receive lists a FILE COUNT that contains the number of files on a volume. The FILE COUNT reported for archive and catalog entries of the same tape or CD might not match because of one or more of the following reasons:

    • Some files copied to the tape or CD were not catalog files.

    • An ARCHIVE PURGE, CATALOG PURGE, or CATALOG DELETE statement was issued for some of the files after the tape or CD was created.

    • More recent backup copies of the files on the tape or CD have been made. The archive keeps track of only one generation with up to four backup copies while the catalog keeps track of several generations, with up to two backup copies for each generation.

    • A file was split over multiple backup tapes. The archive lists all volumes used by the file while the catalog lists only the first volume used by the file.

  • If you re-use a backup tape with a given serial number, the report FILEDATA prints might include files copied to that tape that have since been overwritten by other files.

  • If you specify the same serial number for different backup CD volumes, the report FILEDATA prints for such a BACKUPSN might include files copied to several different CD volumes. You can distinguish between the CD volumes with the same serial number by the time and date included in the FILEDATA report.

FILEDATA Modifiers

The following FILEDATA modifiers perform functions such as selecting the disk family or file names to be reported on, and specifying the types of information to be reported for each file. Further information about these modifiers is provided under “FILEDATA Modifiers” later in this section.

  • ARCHIVE

  • ARCHIVEBACKUP

  • BACKUPSN

  • CATALOGUE

  • DATABASE

  • DIRECTORY

  • FAMILYNAME

  • LEVEL

  • NEWDATABASE

  • NONRESIDENTONLY

  • RESIDENTONLY

BACKUP Examples

The following statement produces a report of all the archive backup volumes for the user UC on the family DISK. The volumes reported for this statement might also contain backup copies of files that do not belong to the user UC. However, the FILE COUNT reported for the volumes does not include those files. 

RUN *SYSTEM/FILEDATA ("BACKUP: ARCHIVE DIRECTORY=USERCODE/UC");

The following statement, if run by a privileged user or submitted from an ODT, produces a report of all the archive and catalog backup volumes for all the files on the disk family named XPACK: 

RUN *SYSTEM/FILEDATA ("BACKUP: FAMILYNAME=XPACK");

The following statement, if run by a privileged user or submitted from an ODT, produces a report of all the archive backup volumes for all the files on the family DISK for which there is not a resident file on the family. Some of the volumes reported for this example might also contain backup copies of resident files, but the FILE COUNT reported for the volumes does not include those files. 

RUN *SYSTEM/FILEDATA ("BACKUP: NONRESIDENT");

You can use the following statement to determine if any files under the directory SYMBOL on the family PACK were backed up on a volume with the serial number X12: 

RUN *SYSTEM/FILEDATA ("BACKUP: DIRECTORY=SYMBOL FAMILYNAME = PACK
                       BACKUPSN = X12");
Prev  Up  Next
ATTRIBUTES Request  Home  CATALOGINFO Request