Resolution:
EMS C client does not provide an API to convert character encoding like Java does. If the character encoding of the received message in a C client application does not match the character set or code page of the client applications console, the characters will not display correctly.

Here is an example how to configure the console under Windows and Unix to display iso-8859-8 character encoding (Hebrew) string.

Putty for Unix client
=======================
1). Load a session.

2). Go to Windows-&gtTranslation, and select "ISO-8859-8:1999 (Latin/Hebrew)" or "Win1255 (Hebrew)" as "Character set translation on received data".

3). Go to Windows-&gtAppearance, and in "font settings" select "Courier New" as the font.

4). Go to Session and click on the Save button to save the configuration.


Command prompt for Windows XP client
=======================

1). Install a new font for Command Prompt since the default fonts do not support Hebrew language. Refer to the link of http://forums.techarena.in/tips-tweaks/1075409.htm

   i).    Go to Start -> Run, then type regedit and press enter.
  
   ii).   Locate HKEY_LOCAL_MACHINE\Software\Microsoft\WindowsNT\CurrentVersion\Console\TrueTypeFont

   iii). On the right panel you will notice that Lucida Console has been added by default and under name column it is named as 0. For additional fonts you are going to add in you must named it as 00, 000, 0000 and so on. You must follow this naming convention else the added new fonts will not appear;

   iv).   Right click TrueTypeFont, choose New -> String Value, enter the name as 00 then press enter key.

   v).   Double click on this newly created String Value at step iv), then enter the font name "Consolas" under Value data field.

   vi).   repeat step iv) and v) to add "Courier New" under name 000. Note: the font we need for Hebrew is "Courier New" but it has to be installed after "Consolas".

   vii). Reboot your PC as the newly added fonts will only appear after the PC is rebooted.

   viii). Once your PC is rebooted, launch the command prompt then right click on the title bar and choose properties. Under the Font tab you should be able to see the fonts that you have just added. Select "Courier New" and then click OK to save the setting.

2). In Command Prompt, run "chcp 1255" to set the current code page to be Windows-1255.


Test procedure
=================
1). Start an EMS server.

2). Start the C sample program "tibemsMsgConsumer -server tcp://host:port -queue &ltqueue-name>" in putty or Command Prompt.

3). Start the Java sample program attached in SR:1-D166KP as "java tibjmsMsgProducer -server tcp://host:port- queue &ltqueue-name> -encoding iso88598" to send Hebrew letters.