__le_msg_write() — Output a Language Environment message to stderr

Standards

Standards / Extensions C or C++ Dependencies
Language Environment®
 both AMODE 64

Format

#include <__le_api.h>

void  *__le_msg_write(_VSTRING * message_string,
                      _INT4 * destination_code,
                      _FEEDBACK * fc);

General description

Writes a user-defined Language Environment message string to 'stderr'.

Parameter
Description
message_string
A halfword-prefixed printable character string containing a message. DBCS characters must be enclosed within shift-out (0x0F) and shift-in (0x0E) characters.

Insert data cannot be placed in the message with __le_msg_write(). The halfword-prefixed message string must contain only printable characters and be a length greater than zero. Unpredictable results will occur if the byte following the halfword prefix is 0x00.

destination_code
A 4–byte binary integer written to 'stderr'. The only acceptable value is 2.
fc
A 16–byte Feedback Code indicating the results of this function.
Table 1. Feedback Codes for __le_msg_write()
Code Severity Message Number Message Text
CEE000 0 - - The function completed successfully.
CEE0E3 3 451 An invalid destination code destination-code was passed to routine routine.
CEE0E9 3 457 The message file destination ddname could not be located.

Usage notes

  1. z/OS® UNIX System Services consideration – In multithreaded applications, __le_msg_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