Capture specification

The capture specification defines the place in CICS® where a particular event can be captured. Use capture points, filter predicates, and capture data to define the place where an event can be captured, the conditions that an event can be captured, and the data to be captured.

An event specification contains one or more capture specifications which are created by using the CICS event binding editor. Each capture specification defines the following:

Capture Point
Defines the place in CICS where a particular event can be captured; for example, when an EXEC CICS READ FILE command is run.
Filter predicates
Define more precisely the conditions under which the event can be captured. Filters can be either:
Context

A filter relating to the context of the event, for example when the current transaction ID has a particular value.

Event Option

A filter relating to a particular value for a capture point option, for example, when the file has a specific name.

Application data

A filter relating to a particular value for piece of application data, for example when a field within a record read has a particular value.

All predicates must be true for an event to be captured.
Capture data
Defines the data to be captured when the event occurs to satisfy the emitted business information items in the event specification.

Each event specification contains at least one capture specification. The specification describes exactly where in the program the event and its data are to be captured. The same event can occur at multiple points in the code; for example, because of conditional code branches or because the same event can be raised by multiple programs. So an event specification can contain multiple capture specifications.

Capture specifications support capture points for the following types of business event: