__le_msg_get_and_write() — Get and output a Language Environment message

Standards

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

1. 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).

Related information

• __le_api.h
• __le_msg_add_insert() — Add insert to a Language Environment message
• __le_msg_get() — Get a Language Environment message
• __le_msg_write() — Output a Language Environment message to stderr