Start of change

Capture specification

Start of changeThe 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.End of change

Start of changeAn event specification contains one or more capture specifications which are created by using the CICS event binding editor. Each capture specification defines the following: End of change

Start of change
  • 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.
  • Capture data

    Defines the data to be captured when the event occurs to satisfy the emitted business information items in the event specification.

End of change

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.

Start of changeCapture specifications support capture points for the following types of business event:End of change

  • Application events
    An application event is a type of business event that results from application program activity and contains application data.
  • System events
    A system event is a type of business event that results from system activity and contains system data. System events can include resource state changes, thresholds being crossed, or unusual system states or actions.
Parent topic: Event specification
Related concepts:
Event binding
Event specification
End of change