Using System dumps

The external CICS® interface produces MVS™ SYSMDUMPs for some error conditions and MVS SDUMPs for other, more serious conditions. These dumps contain all the external CICS interface control blocks, as well as trace entries.

Formatting system dumps

You can use the CICS IPCS verb exit, DFHPD640, to format the system dumps. The following keywords are available for use when formatting an external CICS interface dump using DFHPD640:

KE
Formats PSW and registers, and all external CICS interface control blocks.
LD
Formats a load map of where the external CICS interface modules are loaded in the address space, and gives their PTF level.
MRO
Formats the MRO control blocks for the external CICS interface address space, including common control blocks that reside in the MVS common service area (CSA). This option also formats some MRO blocks that reside in the CICS address space for pipes connected to CICS.
TR
Formats the external CICS interface trace table. You can format the trace table in abbreviated and full forms (TR=1 gives you the abbreviated trace).
SU
Produces a dump summary.

Multiple TCBs

If the external CICS interface takes a system dump when there is more than one TCB in use, it dumps only the control blocks and trace table for the TCB that requested the dump.

If you take a dump of the external CICS address space using a console command, the CICS verb exit routine, DFHPD640 formats the control blocks and trace tables for every TCB it finds in the dump.

Capturing SYSMDUMPs

To capture SYSMDUMPs produced by the external CICS interface, ensure you always include a DD statement for the SYSMDUMP data set in the client application program's JCL.

Using the MVS DUMP command at the console for dumps

In addition to the dumps taken automatically by the external CICS interface, you can also force a dump of an address space running a client application program by means of an MVS DUMP command entered at the console. You can use the CICS IPCS verb exit routine DFHPD640 to format dumps taken in this way.

Note:
You can also issue the DUMP command from TSO, SDSF, or NetView®.

You can use the console to issue the DUMP command also to dump the CICS server address space as well as the client address space, and use the CICS IPCS verb exit routine DFHPD640 to format both address space dumps together.

[[ Contents Previous Page | Next Page Index ]]