To obtain a Statistics and Diagnostics Area Report, execute the REPORT function with the following command format:
►►─ REPORT AREA=PXX ─┬─────────────────────────┬─┬─────────────────────┬──────► └─ ,DUMPS= ─┬─ FULL ────┬─┘ └─ ,JOBNAME=jjjjjjjj ─┘ ├─ REQUEST ─┤ └─ TRACE ───┘ ►─┬───────────────────────────┬─┬───────────────┬────────────────────────────► └─ ,JOBSTAT= ─┬─ DETAIL ──┬─┘ └─ ,RTNCODE=nn ─┘ ├─ DETAILX ─┤ └─ SUMMARY ─┘ ►─┬───────────────────────────┬──────────────────────────────────────────────►◄ └─ ,SYSSTAT= ─┬─ DETAIL ──┬─┘ ├─ DETAILX ─┤ └─ SUMMARY ─┘
Command
Invokes the function to produce a report.
Required Keywords
Note: You must include at least one of the keywords: DUMPS, JOBSTAT, or SYSSTAT.
Requests the Statistics and Diagnostics Area Report.
Specifies that formatted dumps are to be printed.
Dumps Master List, buffer areas, Request Area, and Compound Boolean Selection Facility (CBS) Diagnostic Report.
The process of producing dumps has changed. Dumps are produced using new memory management methods that support 64-bit addressing and are faster. Because of this enhanced processing and to simplify it, the following changes were made:
Dump Addresses Format Changes
The formatting of dumps has changed to show addresses in 64-bit memory that start with one byte, followed by an underscore, then the address within 64-bit memory. This new way of formatting dump addresses appears in both the DBUTLTY REPORT AREA=PXX and in the Master List dump output directed to the PXXML by the SYSOUT MUF startup option.
STATBFR Startup Option Removed
You are not allowed to specify STATBFR in the MUF startup. The STATBFR MUF startup option was previously used to specify the size of the buffer that accumulates system and job statistics, but STATBFR was removed. Complete statistics are now always provided when requested.
SNAPER Processing Changes
In z/OS environments, output SNAPER processing has changed. Previously, full address space SNAP dumps and partial memory were all written to SNAPER. An address space SNAP, produced due to an abend, is routed to SNAPER the same as it was. All other items, however, are written to other SYSOUT data sets to keep them separate and make them easier to find.
Another change is that in a MUF failure, any ECSA memory is written to a DD statement, SNAPECSA, and data space memory, when used for communication, is written to SNAPDTSP. During debugging, if multiple address space dumps are snapped, they are individually written to SNAPASnn where nn is a number 01 through 99.
ECSA Labels
The Master List in the ECSA is labeled DB_ML_ECSA.
Message DB02406I Changed
To support the change in dump processing, message DB02406I has changed. The message text could previously contain a variable, replaced with a ML or a BFR, that could possibly be separated by another PXX dump. The multiple parts of the process, and the variable in the message for ML or BFR that have been removed. The process now has a single completion. In addition, text describing the error has been added to the end of the message.
Note: For details, see the CA Datacom/DB Message Reference Guide.
Prints only the Request Area portion of the dumps.
Produces only the Compound Boolean Selection Facility (CBS) Diagnostic Report and the SQL trace information requested through the DBUTLTY COMM ALTER function. See Reporting on the Compound Boolean Selection Facility and COMM ALTER (Modify Error Table).
FULL, REQUEST, TRACE
No dumps are printed.
Indicates that a job statistics report is to be printed.
Note: To get JOBSTAT information, either comment out the PXXSTATS MUF startup option or specify it as PXXSTATS DETAIL. Detailed information about MUF startup options can be found in the CA Datacom/DB Database and System Administration Guide.
Performs a top of form and prints JOBSTAT detail, causing each JOBSTAT to start on a new page.
Skips three lines and prints JOBSTAT detail, causing JOBSTAT information to print on the same page with other information.
Performs a top of form and prints only the summary information from each job close.
DETAIL, DETAILX, or SUMMARY
No JOBSTAT information is printed.
Indicates that system statistics information is to be printed. The value you code for this keyword specifies the format of the Statistics Report. System statistics are in the Report Area (PXX) for each CLOSE request. These statistics are cumulative and reflect information from the time the system begins running.
Note: The frequency at which MUF statistics records are written (if any), are controlled by URT closings and the PXXSTATS MUF startup option. For detailed information about MUF startup options, see the CA Datacom/DB Database and System Administration Guide.
Performs a top of form and prints system statistics for each CLOSE request.
Skips three lines and prints system statistics for each CLOSE request, causing SYSSTAT information to print on the same page with other information.
Performs a top of form and prints the system statistics from the last CLOSE record in the Report Area (PXX).
DETAIL, DETAILX, SUMMARY
No SYSSTAT information is printed.
Note: When you request a PXX report with JOBSTAT DETAIL that specifies either a JOBNAME= or RTNCD= keyword, be aware that both job and summary statistics are generated.
Optional Keywords
Specifies the name of the job for any dumps and statistics that are to be reported.
Any valid job name
Statistics and dumps are printed for all jobs.
Specifies that dumps are to be printed only if the named return code is found in the Request Area. The RTNCODE= parameter is active when the DUMPS=FULL or DUMPS=REQUEST keyword. If DUMPS=TRACE is specified, RTNCODE= is ignored.
Any CA Datacom/DB return code (2-character numeric)
(No default)
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|