Dispatch a Message (CEEMOUT) API
Required Parameter Group:
| 1 | message_string | Input | VSTRING |
| 2 | destination_code | Input | INT4 |
Omissible Parameter:
| 3 | fc | 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 ]