__le_msg_get_and_write() — Get and output a Language Environment message
Standards
Standards / Extensions | C or C++ | Dependencies |
---|---|---|
Language Environment |
both | AMODE 64 |
Format
#include <__le_api.h>
void *__le_msg_get_and_write(_FEEDBACK * cond_token,
_INT4 * destination_code,
_FEEDBACK * fc);
General description
Retrieves, formats, and stores, in a passed message area, a Language Environment® message corresponding to a user supplied condition token. The caller can later retrieve the message to modify or to write as output.
- Parameter
- Description
- cond_token
- A 16–byte condition token supplied by the invoker.
- destination_code
- A 4–byte binary integer written to 'stderr'. The only acceptable value for is 2.
- fc
- A 16–byte Feedback Code indicating the results of this function.
Table 1. Feedback Codes for __le_msg_get_and_write() Code Severity Message Number Message Text CEE000 0 - - The function completed successfully. CEE0E2 3 450 The message inserts for the condition token with message number message-number and facility ID facility-id could not be located. CEE0E3 3 451 An invalid destination code destination-code was passed to routine routine. CEE0E6 3 454 The message number message-number could not be found for facility ID facility-id. CEE0E9 1 457 The message file destination ddname could not be located. CEE0EA 1 458 The message repository repository-name could not be located. CEE3CT 3 3,485 An internal message service error occurred while locating the message number within a message file. CEE3CU 3 3,486 An internal message service error occurred while formatting a message. CEE3CV 3 3,487 An internal message service error occurred while locating a message number within the ranges specified in the repository.
Usage notes
- z/OS® UNIX System Services consideration – In multithreaded applications, __le_msg_get_and_write() affects only the invoking thread. When multiple threads write to 'stderr' the output is interwoven by line. To group lines of output, serialize 'stderr' access (for example, by using a mutex).