Dispatch a Message (CEEMOUT) API

Required Parameter Group:

1	message_string	Input	VSTRING
2	destination_code	Input	INT4

Omissible Parameter:

Output

FEEDBACK

  Service Program Name: QLEAWI

  Default Public Authority: *USE

  Threadsafe: Yes

The Dispatch a Message (CEEMOUT) API is used to dispatch a message string.

Authorities and Locks

None.

Required Parameter Group

message_string (input by descriptor)

A valid ILE string, passed by reference with a descriptor, to be dispatched as a message. It is not necessary that this string first be retrieved by the CEEMGET API. Insert data cannot be inserted with this call.

destination_code (input)

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

1	Dispatch the message for output to the standard output (console or file). The message is also logged in the *EXT message queue of the job.
2	Log the message to the system message file only; the message is not displayed.

Note: Messages sent through this API are subject to the normal server rules for message filtering.

Omissible Parameter

fc (output): A 12-byte feedback code.

Feedback Codes and Conditions

CEE0000	The API completed successfully
Severity: 00
CEE0451	Unsupported destination code &2 passed to &1
Severity: 30
CEE0501	The operational descriptor data type is not valid
Severity: 30
CEE0502	Missing operational descriptor
Severity: 30
CEE3101	&1 cannot be called in the default activation group
Severity: 30
CEE9902	Unexpected user error occurred in &1
Severity: 30

Usage Notes

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 CEEMOUT. Message CPF9898 appends a period to the displayed text.

API introduced: V2R3

[ Back to top | ILE CEE APIs | APIs by category ]