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.

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.

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.

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

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