Function
tibems_status
tibems_SetCodePages(
char* host_codepage,
char* net_codepage);
CALL "tibems_SetCodePages" USING BY REFERENCE host-codepage, BY REFERENCE net-codepage, RETURNING TIBEMS-STATUS END-CALL.
EMS software uses the operating system’s iconv()
call to automatically convert strings within messages. Conversion occurs only as needed:
This call sets the host and network code pages for string conversions in EBCDIC environments.
Call this function when the system code pages differ from the EMS default code pages (see the table of Default Code Pages). Throughout an enterprise, all sending and receiving programs must use the same code pages.
Both arguments are string names of code pages. To determine valid code page names for your operating system, see documentation from the operating system vendor.
Programs may call this function at most once. The call must precede the first call to any message function, and the arrival of the first message from the network.
To use a default code page, programs may supply NULL
for either parameter. Using the default code pages in both parameter positions has the same effect as not calling this function at all.
Strings and Character Encodings
TIBCO Enterprise Message Service™ C and COBOL Reference System Release 4.3, February 2006 Copyright © TIBCO Software Inc. All rights reserved www.tibco.com |