Overview of reports (RVP)
This section contains the following topics:
Real-time reports versus end-of-step reports
The Recovery utility can write reports in real time as each utility task completes instead of waiting to write all reports until all tasks have completed at the end of the utility job step.
If the utility job step terminates abnormally or is cancelled, real-time reports are produced for tasks that have completed successfully, while end-of-step reports are lost.
Real-time reports have 132-byte print lines instead of the 80-byte lines that are used in end-of-step reports. The longer line length allows for compact presentation of additional data. For example, the Real-Time Processing Summary report contains a timestamp and record count for each function; this information is not available in the end-of-step Processing Summary report.
For the Recovery utility, you can request the Real-Time Processing Summary report and Real-Time Detail reports. Detail reports are the reports that are normally produced during utility execution in addition to the Processing Summary report; they include the Global Specifications report, Database Recovery - Database Summary, Database Recovery - Data Set Group Summary, Database Recovery - Data Set Summary, Input Change Accumulation Summary, and Log Sort Summary reports.
End-of-step reports include the Processing Summary report, Global Specifications report, Database Recovery - Database Summary, Database Recovery - Data Set Group Summary, Database Recovery - Data Set Summary, Input Change Accumulation Summary, and Log Sort Summary reports.
Report data sets
The Recovery utility writes reports to one or more data sets, depending on the DD statements that you specify in the job step JCL.
For information about specifying the DD statements, see Using-the-Recovery-utility.
The default data set to contain end-of-step reports is identified with the SYSPRINT DD statement.
You can include the REPORTS DD statement in the utility job step JCL to provide a separate data set for end-of-step reports. The utility writes the processing log to the SYSPRINT data set and writes the end-of-step reports to the REPORTS data set instead of to the SYSPRINT data set.
You can include the SUMMARY DD statement in the utility job step JCL to request the Real-time Processing Summary report. If this statement is included, the utility writes the Real-Time Processing Summary report to the SUMMARY data set and does not write the end-of-step Processing Summary report to the SYSPRINT data set or the REPORTS data set.
You can include the DETAIL DD statement in the utility job step JCL to request real-time detail reports. If this statement is included, the utility writes real-time detail reports to the DETAIL data set and does not write the end-of-step detail reports to the SYSPRINT data set or the REPORTS data set.
If you include the SUMMARY DD statement and the DETAIL DD statement, the REPORTS data set is not produced and the SYSPRINT data set contains only the processing log.
Recovery utility reports
The following table lists the reports that are produced by the Recovery utility.
These reports are similar to the reports that are produced by other BMC IMS Database Utilities products.
Report name | Purpose |
|---|---|
Processing log | lists control statements, DD statement input, actions performed, and diagnostic messages |
Global specifications report | lists the global options and selected environmental information used for the run |
Real-Time Processing Summary report | summarizes information about the database data set groups and areas that were processed during the job step This report is written in real time as the utility tasks complete. |
Processing Summary—Database/Data Set Group Run Summary report | summarizes information about the database data set groups and areas that were processed during the job step This report is written at the end of the utility job step. |
Database Recovery—Database Summary report | lists the options in effect during processing |
Database Recovery—Data Set Group Summary report | lists a summary for each data set group or area processed |
Input Change Accumulation Summary report | lists the input DBDs and data sets used as input to the recovery process |
Log Data Set Summary report | lists the log data sets used as input to the recovery process |
Log Sort Summary report | lists system or recovery log data sets used as input to the recovery |
Tape/Cartridge Pull List report | lists all tapes or cartridges in volume serial sequence that are required for the run. You must request that this report be generated |
Model Summary report | lists the dynamic allocation models that were used during the run |