Reporting on Application Backups
All examples in this section are found in the JCL library installed with FDR. The member names are EX5220x.
You can report on the data sets recorded in an Application Control File using:
- Program FDRABRP with its PRINT ARCHIVE function (see FDRABRP-Standard-Reporting-Facility).
- Program FDREPORT with its DATATYPE=ARCHIVE option (see FDREPORT-Generalized-Report-Writer).
- The SRS ISPF Dialog (see FDRSRS-Search-Report-and-Services-Dialog).
Each displays the data set names, data set information, and the location and expiration of the backup files. SRS can also be used to restore data sets from the Application Backup; see the SRS example in ISPF-Support-for-Application-Backups.
FDRABRP
The ABR report utility, FDRABRP, can produce a fixed-format report on data sets recorded in a single Application Control File. This example shows details of every data set in the ACF. See FDRABRP-Catalog-Report for additional operands that you might use to limit the scope of the report. The ARCHIVE DD statement points to the Application Control File. Since SORT=YES is the default in batch, to display information in data set name order, SORT DD statements may be required as shown, depending on your system SORT product.
The report produced is similar to:
**---DATA SET NAME---** SERIAL S TY ARCHIVE EXPDT ORG FM SIZE LRECL ALLOC R/TRK* TY CN SUFFIX FN VOL-SERIAL(S)
TEMPEST.EXTRACT.GDG0X. SMS812 2 0E 20.189 98.189 PS FB 23440 80 1C 9 84 1 B120189A 1 AB0003
G0002V00
TEMPEST.MASTER SMS812 2 0E 20.189 98.189 PS FB 23440 80 1C 9 84 1 B120189A 1 AB0003
FDREPORT
The ABR generalized reporting utility, FDREPORT, can report on data sets recorded in a single Application Control File. The format of the report and the information included in it are customizable. This example reports on the basic descriptive data of each data set (VOLUME, DSORG, SIZE, and so on), plus information on the backup of each data set (backup data set name, volume, file, and date of backup).
The generated report looks similar to the PRINT ARCHIVE report above. Please see FDREPORT-Generalized-Report-Writer for information on further customizing this report.
Reporting on multiple application control files example
The preceding examples reported only on the contents of one Application Control File at a time. You may wish to produce a combined report on the contents of multiple ACFs. For example, if you create the ACF for an application as a GDG, and you retain more than one generation on DASD (LIMIT for the GDG base greater than one), you might want to report on all backups in all of those ACFs. This special FDREPORT step does this.
FDREPORT first identifies all the generations that exist for a specified Application Control File name, extracts the data from each into a combined reporting file, and then reports on that combined data. It sorts on data set name and DASD volume serial. RPTYPE=ARCHIVE requests the same report format as produced by the PRINT ARCHIVE function of FDRABRP (see earlier example) but you may choose to customize the report as shown in FDREPORT-Generalized-Report-Writer.