Get, Format, and Dispatch a Message (CEEMSG) API

Required Parameter Group:

1	cond_token	Input	FEEDBACK
2	destination_code	Input	INT4

Omissible Parameter:

Output

FEEDBACK

  Service Program Name: QLEAWI

  Default Public Authority: *USE

  Threadsafe: Yes

The Get, Format, and Dispatch a Message (CEEMSG) API is used to obtain, format, and dispatch a message corresponding to an input condition token.

Authorities and Locks

None.

cond_token (input)

A 12-byte condition token. See Using Condition Management APIs for a description of the condition token.

destination_code (input)

A 4-byte binary integer of one of the following values:

1	Dispatch the message for output to the standard output. The message is also logged in the system message file.
2	Log the message to the system message file only; the message is not displayed.

CEE0000	The API completed successfully
Severity: 00
CEE0102	The condition token passed to &1 is not valid
Severity: 30
CEE0451	Unsupported destination code &2 passed to &1
Severity: 30
CEE0458	&1 cannot find message file &2
Severity: 30
CEE9902	Unexpected user error occurred in &1
Severity: 30

A CPF9898 message of type *INFO is used to log the message being dispatched. It is sent to the message queue of the caller of CEEMSG. Message CPF9898 appends a period to the displayed text.

API introduced: V2R3