Dump information for data tables

Information relevant to data tables is included in a CICS® system dump to help you determine the cause of a problem.

For information about the contents of dumps and how to obtain them, see Using dumps in problem determination.

The major control blocks that are used by shared data table support are included in the FILE CONTROL area of a formatted dump of the file-owning region. These control blocks are named:
Data Table Global Area
This is also known as the shared data table header block, so it uses the eye-catcher DFHDTHEADER.
Data Table Base Area
This is also known as the shared data table block, so it uses the eye-catcher DFHDTTABLE.
Data Table Path Area
This is also known as the shared data table file block, so it uses the eye-catcher DFHDTFILE.
The data table contents are not included in the CICS system dump because the data space storage in which the data table resides is not part of the CICS address space. The table entries reside in data space DFHDT001, the index nodes in DFHDT002, and the record data in data spaces DFHDT003, DFHDT004, DFHDT005, and so on, with new data spaces being added as required. If you want to see the contents of the data table, ask the system operator to use the MVS DUMP command to request a dump of the appropriate data space owned by the appropriate CICS startup job.
The operator command DISPLAY J,CICS-startup-jobname shows information about a CICS job, including the DSPNAMEs of data spaces that it owns. To dump the contents of data space DFHDT003, you can use the MVS DUMP command as follows:
  1. Enter
    DUMP COMM=(title for your dump)
  2. This generates an MVS console message
    * id IEE094D SPECIFY OPERAND(S) FOR DUMP COMMAND
  3. Reply to the message with
    REPLY id, DSPNAME='jobname'.DFHDT003
    and the data space storage is dumped.
    Note: It is possible, using the following asterisk notation, to dump the contents of all the data spaces owned by CICS:
    REPLY id, DSPNAME='jobname'.DFHDT*
    However, this should be used with care, because if there are many data spaces the dump data set could be huge.
  4. Use DISPLAY DUMP,TITLE to see which SYS1.DUMPnn data set has been used.