Event code 9 — new condition event

Purpose

This event notifies all members that a new condition is about to be processed. This can be used by members to keep sets of condition handling related control areas concurrently with Language Environment condition handling.

Syntax

Call CEEEVnnn (9, function_code, cib_ptr) 
INT4      *function_code;
POINTER   *cib_ptr;
function_code (input)
A 31-bit fixed-binary field that describes the action that is being reported.
Value Meaning
1 A new CIB is ready for processing.
2 An old CIB is collapsing.
cib_ptr (input)
A pointer to the new or old CIB.

Usage notes

  • The notification of the event handlers occurs after the condition has been enabled. This is done prior to the debug or any other event handler being called to process the new condition.
  • The CIBs are treated as a stack. Even if CIBs go away due to move resume cursor this event notifies the members of the collapsing of the CIBs in LIFO order.
  • If the event handler indicates an unrecoverable error with a 16 return code, condition management issues ABEND U4091-14.
  • The CIB address can only be used as a token for the purpose of identifying which condition is ready for processing or is collapsing.
Parent topic: Event handler calls