Signal a Condition (CEESGL) API

The Signal a Condition (CEESGL) API signals or resignals a condition to the ILE condition manager.

Authorities and Locks

None.

Required Parameter

cond_rep (I/O)

A condition token defining the condition to be raised.

The CEESGL API always uses the facility_ID to retrieve a message, whether or not instance specific information (ISI) is provided. If ISI is provided, the message data from the message is used as insert data for the condition that is to be raised.

Omissible Parameter Group

q_data_token (input)

A 32-bit data object to be placed in the ISI field for use in accessing the qualifying data associated with the given instance of the condition. This parameter is provided for compatibility purposes only. It is ignored on the system.

fc (output)

A 12-byte feedback code.

Feedback Codes and Conditions

Usage Notes

• If the condition is unhandled and a feedback code is provided, a message number is returned in the fc parameter. The message number returned is dependent on the severity of the condition when it reaches the control boundary.

  If the severity of the condition is 0-1, message number CEE0000 is returned. The message is classified as a *STATUS message.

  If the severity of the condition is 2-4, message number CEE0201 is returned. The message is classified as an *ESCAPE message.

  See Mapping i5/OS *ESCAPE Message Severities to ILE Condition Severities and Mapping i5/OS *STATUS and *NOTIFY Message Severities to ILE Condition Severities for the relationship of condition severities and message severities.