Troubleshooting for event processing

Use this information to help you identify the source of errors that can affect event processing.

What diagnostic information and tools are available

Use these problem determination tools to diagnose the cause of event processing problems.

Statistics utility transaction STAT
You can review event processing and CAPTURESPEC statistics that are relevant to CICS® event processing problem determination using the STAT transaction in sample group DFH£STAT.
  • The CAPTURESPECs option of the STAT transaction generates the CAPTURESPEC report.
  • The EPADAPTER option of the STAT transaction generates the EPADAPTER report.
  • The Event Binding option of the STAT transaction generates the EVENTBINDING report.
  • The Event Processing option of the STAT transaction generates the EVENTPROCESS report.

For reference information about these reports, see Event processing reports: CAPTURESPEC, EPADAPTER, EVENTBINDING, and EVENTPROCESS.

Event capture (EC) component trace
You can determine entry and exit points from the event capture process using level 1 trace. You can determine all the stages of event point filter evaluation and event capture using a level 2 trace. For details, see Event capture (EC) component trace.
Formatted dump for EC component
The EVENT BINDING SUMMARY in the EC formatted dump is particularly useful because it lists the details of the CAPTURESPECs. For details, see Formatted dump for EC component.
Main terminal CEMT INQUIRE transaction

You can check the status of event processing, list the installed EVENTBINDINGs and their status, and see the temporary storage queues created by the TS Queue EP adapter or the sample custom EP adapter.

You can use the CEMT INQUIRE transaction to perform problem determination as follows:
You can also use the IBM® CICS Explorer® views to perform problem determination as follows:
  • Event processing view to check the status of event processing.
  • Event bindings view to list the installed EVENTBINDINGs and their status.
  • TS queues view to see the temporary storage queues created by the TS Queue EP adapter or the sample custom EP adapter.
For more information, see SM Operations views in the CICS Explorer product documentation. You might also need to check the following reference information.
CICSPlex® SM views CICSPlex SM resource tables
The Event processing - EVNTGBL view The EVNTGBL resource table
The Event binding - EVNTBIND view The EVNTBIND resource table
The temporary storage queues - TSQNAME view The TSQNAME resource table
  The TSQUEUE resource table
TD Queue or TS Queue EP adapter and sample custom EP adapter
The TD and TS Queue EP adapter write CICS event objects to a TD or TS queue in CICS flattened event, common base event, common base event REST, Decision Server Insights Event, and WebSphere® Business Event formats. The sample custom EP adapter writes events to a TS queue in a simplified flattened event format. You can use these EP adapters during development of event processing applications, or during problem determination, to check the number of events and the contents being captured.
See also Event processing adapters, Temporary storage queue (TSQ) EP adapter, and Sample custom EP adapter.