# 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`

Copyright © Cloud Software Group, Inc. All rights reserved.