Design overview

DFHDU640 operates in batch mode while one of the dump data sets is closed. Each area, program, and table entry is identified, formatted, and printed separately, with both actual and relative addresses to facilitate analysis. You can select single or double spacing of dumps when the dump utility program is executed.

The CICS® dump data set (DFHDMPA or DFHDMPB) contains a number of CICS transaction dumps. These are produced as the result of a transaction abend or a user-application EXEC CICS DUMP TRANSACTION request.

DFHDU640 runs as a stand-alone program in batch mode to format and print the contents of a transaction dump data set. Parameters specified on the SYSIN data set can be used to print only selected dumps or an index of the dumps in the data set.

For further details about DFHDU640, see the CICS Operations and Utilities Guide.

Data sets

There are three sources of data for DFHDU640:

Parameters on JCL EXEC statement
A character string of keywords that can be specified to control the layout and format of the dumps.
SYSIN
Records specifying the criteria to be used in selecting which of the dumps on the data set are to be printed.
DFHDMPDS
The transaction dump data set.

There are two output files:

DFHPRINT
The print file for the formatted transaction dump.
DFHTINDX
The print file for the index of dumps on the data set.

Processing

Figure 42 shows the dump utility program interfaces.

Figure 42. Dump utility program interfaces
 This figure shows how the dump utility program works, as explained in the text.

The overall flow of the processing within DFHDU640 is as follows. Unless otherwise indicated, all processing is performed by DFHDUPR, the main component of DFHDU640.

  1. Process the EXEC parameters if they are present.
  2. Call DFHDUPP to open the print data set DFHPRINT.
  3. Open the dump data set DFHDMPDS.
  4. Read the dumps from DFHDMPDS. For each dump there are four categories of records:
    Dump header record
    Call DFHDUPS to see whether this dump is required for printing. On the first time through, DFHDUPS reads the selective print information from SYSIN. DFHDUPS also calls DFHDUPH to add the dump to the dump index data set DFHTINDX. DFHDUPH opens DFHTINDX on its first invocation.
    Module index records
    DFHDUPM is called to accumulate the module index information in a table in main storage.
    Other data records
    The data is formatted into print lines and DFHDUPP is invoked to write them to DFHPRINT.
    Dump trailer record
    DFHDUPM is invoked to sort and format the module index records. DFHDUPP is called to write them to DFHPRINT.
  5. When the end of the dump data set is encountered:
    1. DFHDUPP is called to close DFHPRINT.
    2. DFHDUPH is called to close DFHTINDX.
    3. DFHDUPR closes DFHDMPDS.
  6. DFHDU640 terminates.
[[ Contents Previous Page | Next Page Index ]]