Handle a Condition (CEE4HC) API
Required Parameter Group:
| 1 | isi | Input | UINT4 |
| 2 |
inv | Input | INVPTR |
Omissible Parameter Group:
| 3 | option | Input | UINT4 |
| 4 | fc | Output | FEEDBACK |
Service Program Name: QLEAWI
Default Public Authority: *USE
Threadsafe: Yes
The Handle a Condition (CEE4HC) API handles a specified condition and, optionally, logs the condition.
Authorities and Locks
None.
Required Parameter Group
- isi (input)
- The instance specific information number for the condition. This is the
message reference key of the underlying server exception.
- inv (input)
- The call stack entry that the handle cursor points to for the condition.
This is the target call stack entry of the underlying server exception.
Omissible Parameter Group
- option (input)
- The options are:
0 Take the default log action for the message. *ESCAPE and function check messages are logged. *STATUS messages are never logged. 1 Do not log the condition. 2 Log the condition. Only conditions with a severity greater than 1 can be logged. If the option parameter is omitted, the value 0 is used.
- fc (output)
- A 12-byte feedback code.
Feedback Codes and Conditions
| CEE0000 | The API completed successfully |
| Severity: 00 | |
| CEE3104 | The pointer type in &1 is not valid |
| Severity: 30 | |
| CEE3105 | The call stack entry given to &1 no longer exists |
| Severity: 30 | |
| CEE3107 | The message specified for &1 is not an exception message |
| Severity: 30 | |
| CEE3108 | The option specified for &1 is not valid |
| Severity: 30 | |
| CEE9902 | Unexpected user error occurred in &1 |
| Severity: 30 |
Usage Notes
-
The call stack entry that inv points to must appear in the call stack for the job issuing the call to the CEE4HC API.
-
The CEE4HC API can be used to take a previously handled message out of the job log, but only if that message is enqueued on inv.
-
The CEE4HC API can be used to handle *ESCAPE, *STATUS, *NOTIFY, and function check exceptions. A default reply is sent for *NOTIFY messages if no reply has been sent previously.
API introduced: V2R3
[ Back to top | ILE CEE APIs | APIs by category ]