Signal a Condition (CEESGL) API
Required Parameter:
1 | cond_rep | I/O | FEEDBACK |
Omissible Parameter Group:
2 | q_data_token | Input | INT4 |
3 | fc | Output | FEEDBACK |
Service Program Name: QLEAWI
Default Public Authority: *USE
Threadsafe: Yes
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
CEE0000 | The API completed successfully |
Severity: 00 | |
CEE0201 | The condition sent by &1 was not handled |
Severity: 00 | |
CEE0258 | The condition token passed to &1 is not valid |
Severity: 30 | |
CEE9902 | Unexpected user error occurred in &1 |
Severity: 30 |
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 IBM® i *ESCAPE Message Severities to ILE Condition Severities and Mapping IBM i *STATUS and *NOTIFY Message Severities to ILE Condition Severities for the relationship of condition severities and message severities.
API introduced: V2R3
[ Back to top | ILE CEE APIs | APIs by category ]