Dealing with external CICS interface (EXCI) problems

For detailed problem determination information about the external CICS® interface including information about trace, system dumps and MVS™ abends, see the CICS External Interfaces Guide.

The following CICS messages support the external CICS interface:

DFHIR3799
 
DFHEX0001         DFHEX0011
DFHEX0002         DFHEX0012
DFHEX0003         DFHEX0013
DFHEX0004         DFHEX0014
DFHEX0005         DFHEX0015
DFHEX0010         DFHEX0016

Messages DFH5502W and DFH5503E include support for the external CICS interface facility.

This facility is also supported by two translator messages, DFH7004I and DFH7005I.

For full details of all CICS messages, see CICS Messages and Codes.

The external CICS interface outputs trace to two destinations: an internal trace table and an external MVS GTF data set. The internal trace table resides in the non-CICS MVS batch region. Trace data is formatted and included in any dumps produced by the external CICS interface.

Trace entries are issued by the external trace interface destined for the internal trace table and/or an MVS GTF data set. They are listed in CICS Trace Entries.

The external CICS interface produces MVS SYSM dumps 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. You can use IPCS to format these dumps.

A user-replaceable module, DFHXCTRA, is available for use under the guidance of IBM® service personnel. It is the equivalent of DFHTRAP used in CICS. It is invoked every time the external CICS interface writes a trace entry. The actions of the CICS-supplied DFHXCTRA are, on a pipe FREEMAIN error, to:

  1. Make a trace entry
  2. Take an SDUMP
  3. Skip writing the current trace entry
  4. Disable itself.

Related Concepts
Introduction to the external CICS interface
EXCI Concepts

Related Tasks
Using System Dumps
The EXCI Service Trap, DFHXCTRA

Related References
Messages & Codes
[[ Contents Previous Page | Next Page Index ]]