Information Center

Unicode support for i5/OS and OS/400 using Coded Character Set Identifiers

General information
Host requirements
Client requirements
Limitations
Programming information
Configuring the font on the client

General information

In a 5250 Display session, Host On-Demand supports the display of Unicode data located in fields tagged with Coded Character Set Identifiers (CCSIDs). The Enable Unicode Data Stream option in the 5250 Display session configuration window must be set to Yes (see ENPTUI).

Host On-Demand does not support this feature in a 5250 Printer session.

Host On-Demand supports the following CCSIDs:

Host On-Demand returns a sense code of 0x10050155 in response to any other CCSID.

Host requirements

The iSeries host must be running one of the following levels of i5/OS or OS/400:

Client workstation requirements

The following requirements apply to the client workstation:

Limitations

This feature has the following limitations:

Programming information

See Host programming information .

Configuring the font on the client

Obtaining the font file
If you are using a Java 2-enabled browser and the IBM Java 2 plug-in
If you are using a Java 2-enabled browser and the Sun Java 2 plug-in
If you are using Netscape 4.x
If you are using Internet Explorer without a Java 2 plug-in

Obtaining the font file

The client workstation must be configured to use one of the IBM WorldType Monotype Sans Duospace WT fonts. The following table shows which font name and font file should be used for each language:

Language: IBM WorldType font name: IBM WorldType font file:
All SBCS languages and Japanese Monotype Sans Duospace WT J mtsansdj.ttf
Korean Monotype Sans Duospace WT K mtsansdk.ttf
Simplified Chinese Monotype Sans Duospace WT SC mtsansds.ttf
Traditional Chinese Monotype Sans Duospace WT TC mtsansdt.ttf

You can download these font files from the WebSphere Host On-Demand Service Key site at http://www.ibm.com/software/webservers/hostondemand/support.html.

The next subsections describe how to configure the client workstation to use the font.


If you are using a Java 2-enabled browser and the IBM Java 2 plug-in

If you are using a Java 2-enabled browser (such as Netscape 6.0 or Internet Explorer with a Java 2 plug-in) and the IBM Java 2 plug-in, follow the steps in this section to configure the font on the client.

  1. These instructions use the SBCS languages as an example, but the instructions are similar for Japanese, Korean, Simplified Chinese, and Traditional Chinese. However, remember to use the correct Monotype Sans Duospace WT font name and font file for your language, as described in Obtaining the font.

  2. In the IBM Java 2 directory, find the font.properties file corresponding to your language:

    For example, assuming that IBM Java 2 has been installed in the c:\Program Files\IBM\Java14 directory, the fully qualified file name for the font.properties file for the SBCS languages is c:\Program Files\IBM\Java14\jre\lib\font.properties.


  3. Modify the font.properties file corresponding to your language as follows:
    1. Open the file with an ASCII editor.

    2. Find the line beginning with the following characters:
      monospaced.0=

    3. Modify the group of lines as follows:

      • Move the Monotype Sans Duospace WT line to the top.
      • Renumber the lines.
      For example, for the SBCS languages, modify these lines in the font.properties file:

      monospaced.0=Courier New
      monospaced.1=Lucida Sans Typewriter Regular
      monospaced.2=Lucida Sans Regular
      monospaced.3=Monotype Sans Duospace WT J

      These lines should read as follows:

      monospaced.0=Monotype Sans Duospace WT J
      monospaced.1=Courier New
      monospaced.2=Lucida Sans Typewriter Regular
      monospaced.3=Lucida Sans Regular

    4. Make the same changes for the group beginning with monospaced.italic.0.

    5. Make the same changes for the group beginning with monospaced.bold.0.

    6. Make the same changes for the group beginning with monospaced.bold.italic.0.

    7. Close the file.

  4. Restart the browser.


If you are using a Java 2-enabled browser and the Sun Java 2 plug-in

If you are using a Java 2-enabled browser (such as Netscape 6.0 or Internet Explorer with a Java 2 plug-in) and the Sun Java 2 plug-in, follow the steps in this section to configure the font on the client.

  1. These instructions use the SBCS languages as an example, but the instructions are similar for Japanese, Korean, Simplified Chinese, and Traditional Chinese. However, remember to use the correct Monotype Sans Duospace WT font name and font file for your language, as described in Obtaining the font.

  2. In the Sun Java 2 directory, find the font.properties file corresponding to your language:

    For example, assuming that Sun Java 2 has been installed in the c:\Program Files\Java\j2re1.4.1_02 directory, the fully qualified file name for the font.properties file for the SBCS languages is c:\Program Files\Java\j2re1.4.1_02\lib\font.properties.


  3. Modify the font.properties file corresponding to your language as follows:
    1. Open the file with an ASCII editor.

    2. Find the line beginning with the following characters:
      monospaced.0=

    3. Modify the group of lines as follows:

      • Add a line at the top for the Monotype Sans Duospace WT font corresponding to the font.properties file. Remember to use the correct Monotype Sans Duospace WT font name for your language, as described in Obtaining the font.
      • Renumber the lines.
      For example, for the SBCS languages, modify these lines in the font.properties file:

      monospaced.0=Courier New,ANSI_CHARSET
      monospaced.1=WingDings,SYMBOL_CHARSET
      monospaced.2=Symbol,SYMBOL_CHARSET

      The lines should read as follows:

      monospaced.0=Monotype Sans Duospace WT J
      monospaced.1=Courier New,ANSI_CHARSET
      monospaced.2=WingDings,SYMBOL_CHARSET
      monospaced.3=Symbol,SYMBOL_CHARSET

    4. Make the same changes for the group beginning with monospaced.italic.0.

    5. Make the same changes for the group beginning with monospaced.bold.0.

    6. Make the same changes for the group beginning with monospaced.bold.italic.0.

    7. Find the lines that begin with filename.

    8. Add the following line anywhere in the list, for example, before the first line that begins with filename.:
      • If your language is any SBCS language, add the following (the same as for Japanese): filename.Monotype_Sans_Duospace_WT_J=mtsansdj.ttf.

      • If your language is Japanese, add filename.Monotype_Sans_Duospace_WT_J=mtsansdj.ttf.

      • If your language is Korean, add filename.Monotype_Sans_Duospace_WT_K=mtsansdk.ttf.

      • If your language is Simplified Chinese, add filename.Monotype_Sans_Duospace_WT_S=mtsansds.ttf.

      • If your language is Traditional Chinese, add filename.Monotype_Sans_Duospace_WT_T=mtsansdt.ttf.

    9. Find the line that begins with exclusion.monospaced.0=.

    10. Comment out this line by typing a # as the first character of the line, for example, #exclusion.monospaced.0=0100-20ab,20ad-f8ff.

    11. Close the file.

  4. Restart the browser.


If you are using Netscape 4.x

If you are using Netscape 4.x, then follow the steps in this section to configure the font on the client.

  1. These instructions use the SBCS languages as an example, but the instructions are similar for Japanese, Korean, Simplified Chinese, and Traditional Chinese. However, remember to use the correct Monotype Sans Duospace WT font name and font file for your language, as described in Obtaining the font.

  2. In the Netscape directory, find the font.properties file corresponding to your language:

    For example, assuming that Netscape 4.x has been installed in the c:\Program Files\Netscape\Communicator directory, the fully qualified file name for the font.properties file for the SBCS languages is c:\Program Files\Netcape\Communicator\Program\java\classes\font.properties.


  3. Modify the font.properties file corresponding to your language as follows:
    1. Open the file with an ASCII editor.

    2. Find the line beginning with monospaced.0=.

    3. Modify the group of lines as follows:

      • Add a line at the top for the Monotype Sans Duospace WT font corresponding to the font.properties file. Remember to use the correct Monotype Sans Duospace WT font name for your language, as described in Obtaining the font.
      • Renumber the lines.
      For example, for the SBCS languages, modify these lines in the font.properties file:

      monospaced.0=Courier New,ANSI_CHARSET
      monospaced.1=Bitstream Cyberbit,DEFAULT_CHARSET
      monospaced.2=MS Gothic,SHIFTJIS_CHARSET
      monospaced.3=WingDings,SYMBOL_CHARSET,NEED_CONVERTED
      monospaced.4=Symbol,SYMBOL_CHARSET,NEED_CONVERTED

      The lines should read as follows:

      monospaced.0=Monotype Sans Duospace WT J
      monospaced.1=Courier New,ANSI_CHARSET
      monospaced.2=Bitstream Cyberbit,DEFAULT_CHARSET
      monospaced.3=MS Gothic,SHIFTJIS_CHARSET
      monospaced.4=WingDings,SYMBOL_CHARSET,NEED_CONVERTED
      monospaced.5=Symbol,SYMBOL_CHARSET,NEED_CONVERTED

    4. Find the line that begins with exclusion.monospaced.0=.

    5. Comment out this line by typing a # as the first character of the line, for example, #exclusion.monospaced.0=0100-ffff.

    6. Close the file.

  4. Restart the browser.


If you are using Internet Explorer without a Java 2 plug-in

If you are using Internet Explorer and you do not have a Java 2 plug-in installed, then follow the steps in this section to configure the font on the client.

  1. These instructions use the SBCS languages as an example, but the instructions are similar for Japanese, Korean, Simplified Chinese, and Traditional Chinese. However, remember to use the correct Monotype Sans Duospace WT font name and font file for your language, as described in Obtaining the font.

  2. Find the following key in the Windows Registry:
    My Computer\HKEY_LOCAL_MACHINE\Software\Microsoft\Java VM

  3. Under this key create the following new key:
    Font Alias

  4. Under this key create a new String Value with the following Value name:
    Courier

  5. Modify this String Value to contain the font name for your language. Remember to use the correct Monotype Sans Duospace WT font name for your language, as described in Obtaining the font. For example, for the SBCS languages, modify the String Value to contain the following:
    Monotype Sans Duospace WT J

  6. Close the registry.

  7. Reboot the machine.

  8. Restart the browser.