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. Use system events to help you understand changes in the state of your system resources or system health.

You can be alerted to certain CICS® system conditions by capturing events for those conditions. Receiving a notification for any changes to the state of system resources avoids the need to poll for changes after they happen; it also means that you can quickly respond to these system events.

Event processing supports the following system events:
  • DB2CONN connection status
  • FILE enable or disable status
  • FILE open or close status
  • MESSAGE
  • TASK threshold
  • TRANCLASS TASK threshold
  • Unhandled transaction abend

Capture points

A new set of capture points is supported for system events, as shown in the following table:
Table 1. System event capture points
Capture point Primary predicate Filter Predicate Capture Data Description
Context Event Option Event option
DB2 CONNECTION STATUS None

Transaction ID
User ID

FROM_CONNECTST
TO_CONNECTST

DB2ID
DB2GROUPID
DB2RELEASE
FROM_CONNECTST
TO_CONNECTST

You can capture an event whenever a DB2CONN connection status changes.1

FILE ENABLE STATUS FILE

Transaction ID
User ID

FILE
FROM_ENABLESTATUS
TO_ENABLESTATUS
OPENSTATUS

FILE
DSNAME
FROM_ENABLESTATUS
TO_ENABLESTATUS
OPENSTATUS

You can capture an event whenever a file ENABLESTATUS changes.1

FILE OPEN STATUS FILE

Transaction ID
User ID

FILE
FROM_OPENSTATUS
TO_OPENSTATUS

FILE
DSNAME
FROM_OPENSTATUS
TO_OPENSTATUS
ENABLESTATUS

You can capture an event whenever a file OPENSTATUS changes.1

MESSAGE MESSAGE_ID

Transaction ID
User ID

MESSAGE_ID
INSERT1 to INSERT22 2

MESSAGE_ID
INSERT1 to INSERT22

You can capture an event whenever CICS emits a DFHxxnnnn message or CPSM emits a EYUxxnnnn message.

TASK THRESHOLD None None PERCENT_MAXTASKS

FROM_TASKS
TO_TASKS
MAXTASKS
PERCENT_MAXTASKS

You can capture an event whenever a task threshold is crossed. The threshold is chosen from a predefined list of 50%, 60%, 70%, 80%, 90, or 100%.

TRANCLASS TASK THRESHOLD TRANCLASS None

TRANCLASS
PERCENT_MAXACTIVE

TRANCLASS
FROM_ACTIVE
TO_ACTIVE
MAXACTIVE
PERCENT_MAXACTIVE

You can capture an event whenever a TRANCLASS task threshold is crossed. The threshold is chosen from a predefined list of 50%, 60%, 70%, 80%, 90%, or 100%.

TRANSACTION ABEND (Unhandled) TRANSACTION User ID

TRANSACTION
ABCODE

TRANSACTION
ABCODE

You can capture an event whenever a transaction encounters any unhandled abend.

Note: 1 The change can occur either through explicit operator actions, EXEC CICS SET commands, or implicitly as a result of CICS internal processing.
Note: 2 You can choose up to 10 message insert filters. The CICS event binding editor does not prevent a user defining a filter on an unavailable insert. For example, message DFHFC0200 has 7 inserts, if a user defines a filter on INSERT 8 through 22 the CICS event binding editor will not flag the error. Doing so results in a runtime exception trace, the predicate will evaluate false, and no event is emitted.
For more information about the capture points you can select, see Capture Point tab and Information Sources tab in the CICS event binding editor.
  • Task thresholds
    You can use task threshold events to monitor both system and TRANCLASS task load by specifying that an event is to be emitted when the active task count crosses a threshold value.
Parent topic: Capture specification