tibemsMsg_SetEncoding

Function

Purpose

Set the character encoding header of a message.

C Declaration

tibems_status tibemsMsg_SetEncoding(
    tibemsMsg message,
    const char* value );

COBOL Call

CALL "tibemsMsg_SetEncoding"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.
Note: message has usage pointer.

Parameters

Parameter Description
message Indicate the character encoding of this message.
value Indicate that the character encoding is this value.

Remarks

This call extends the JMS specification.

Programs can indicate the encoding for individual messages.

tibemsMsg_SetEncoding does not actually do any encoding of message strings. An application uses this function to indicate the actual encoding of strings in the message.

When receiving a message in an EMS C client application, the encoding can be retrieved using tibemsMsg_GetEncoding and then use a third party library to do the actual decoding.

See Also

Strings and Character Encodings

tibemsMsg_GetEncoding