Converts Universal Character Set (UCS) data to multi-byte string data. This function is, typically, used only for formatting diagnostic messages. Normal processing is best done in UCS-2, which can represent all characters from all languages.
The sample code (BipSampPluginUtil.c) shows more utilities for processing UCS-2 characters in a portable way.
int cciUcsToMbs( int* returnCode, const CciChar* ucsString, char* mbString, int mbStringLength, int codePage);
For an ASCII system, a value of 1208 (meaning code page ibm-1208, which is UTF-8 Unicode) is a good choice if you are using cciUcsToMbs to convert string constants for processing by WebSphere® Message Broker. 1208 is appropriate for Linux and UNIX, and for Windows platforms.
On Linux and UNIX, nl_langinfo(CODEPAGE) gives you the code page that has been selected by setlocale.
For OS/390 and z/OS, the default code page for WebSphere MQ, which is 500, should not be used. Instead, you should use a code page value of 1047.