IBM Support

Configuring Host On-Demand client for Unicode support in 5250 sessions with Java 1.5 and 1.6

Question & Answer


Question

The IBM WebSphere Host On-Demand Version 10 InfoCenter has instructions to configure the client to use the font files for Unicode support. The instructions are specific for Java 1.4 and earlier. How do you configure to use the font properties with Java 1.5 and 1.6 for Unicode support?

Answer

For Host On-Demand clients wanting to use the Unicode feature in the Host On-Demand 5250 session, you need to edit the java font.properties file. If using a Java 2-enabled browser such as Internet Explorer with a Java 2 plug-in 1.5 or 1.6 (SUN or IBM), follow these steps to configure the font on the client.

1. These instructions use the SBCS languages as an example, however the instructions are similar for Japanese, Korean, Simplified Chinese, and Traditional Chinese. Remember to use the correct Monotype Sans Duospace WT font name and font file for your language, as described in the table below:

Language: IBM WorldType font name:IBM WorldType font file:
All SBCS languages and Japanese Monotype Sans Duospace WT Jmtsansdj.ttf
Korean Monotype Sans Duospace WT Kmtsansdk.ttf
Simplified ChineseMonotype Sans Duospace WT SCmtsansds.ttf
Traditional ChineseMonotype Sans Duospace WT TCmtsansdt.ttf
The font files can be downloaded from Fix Central:
http://www-933.ibm.com/support/fixcentral/
    2. In the Java 2 directory, find the fontconfig.properties.src file. For example, assuming that Sun Java 1.6 has been installed in the 'C:\Program Files\Java\jre6\lib' directory in a Windows system, the fully qualified file name for the font.properties file is
    C:\Program Files\Java\jre6\lib\fontconfig.properties.src. Create a copy of fontconfig.properties.src and rename it to fontconfig.properties.

    3. Modify the fontconfig.properties file as follows:
      1. Open the file with an ASCII editor.
      2. Find the line beginning with these characters: monospaced.plain.alphabetic=
      3. Modify the line as follows:
        -> Comment out the line by inserting '#' symbol at the beginning of the line: #monospaced.plain.alphabetic=
        -> press Enter on the keyboard to create a new empty line and paste this text: monospaced.plain.alphabetic=Monotype Sans Duospace WT J
      For example, for the SBCS languages, modify these lines in the font.properties file:
        monospaced.plain.alphabetic=Courier New
        monospaced.plain.chinese-ms950=MingLiU monospaced.plain.hebrew=David
        monospaced.plain.japanese=MS Gothic monospaced.plain.korean=GulimChe
      These lines should read as follows:
        #monospaced.plain.alphabetic=Courier New
        monospaced.plain.alphabetic=Monotype Sans Duospace WT J monospaced.plain.chinese-ms950=MingLiU monospaced.plain.hebrew=David
        monospaced.plain.japanese=MS Gothic monospaced.plain.korean=GulimChe

      4. Make the same changes for the group beginning with monospaced.bold.alphabetic
      5. Make the same changes for the group beginning with monospaced.italic.alphabetic
      6. Make the same changes for the group beginning with monospaced.bolditalic.alphabetic
      7. For every line beginning with 'sequence.monospaced', rearrange the values on the right of '=' sign such that 'alphabetic' comes first.
        -> Find a line beginning with 'sequence.monospaced' For example : sequence.monospaced.GBK=chinese-ms936,alphabetic,dingbats,symbol
        -> comment out the line by inserting '#' symbol at the beginning of the line: #sequence.monospaced.GBK=chinese-ms936,alphabetic,dingbats,symbol
    -> press Enter on the keyboard to create a new empty line and paste this text:
        sequence.monospaced.GBK=chinese-ms936,alphabetic,dingbats,symbol
        -> Edit the newly created, uncommented line by rearranging the values on the right of '=' such that the set of values begin with 'alphabetic'. For example, change the line from: sequence.monospaced.GBK=chinese-ms936,alphabetic,dingbats,symbol to
        sequence.monospaced.GBK=alphabetic,chinese-ms936,dingbats,symbol
      8. Repeat step 7 for all lines beginning with 'sequence.monospaced', for example, these lines
        sequence.monospaced.GBK=chinese-ms936,alphabetic,dingbats,symbol
        sequence.monospaced.GB18030=chinese-gb18030,alphabetic,dingbats,symbol sequence.monospaced.x-windows-950=chinese-ms950,alphabetic,dingbats,symbol
        sequence.monospaced.x-MS950-HKSCS=chinese-ms950,alphabetic,chinese-hkscs,dingbats,symbol
        sequence.monospaced.windows-31j=japanese,alphabetic,dingbats,symbol
        sequence.monospaced.x-windows-949=korean,alphabetic,dingbats,symbol
        would be changed to: sequence.monospaced.GBK=alphabetic,chinese-ms936,dingbats,symbol sequence.monospaced.GB18030=alphabetic,chinese-gb18030,dingbats,symbolsequence.monospaced.x-windows-950=alphabetic,chinese-ms950,dingbats,symbol sequence.monospaced.x-MS950-HKSCS=alphabetic,chinese-ms950,chinese-hkscs,dingbats,symbol
        sequence.monospaced.windows-31j=alphabetic,japanese,dingbats,symbol
        sequence.monospaced.x-windows-949=alphabetic,korean,dingbats,symbol
      9. In the section called '# Exclusion Ranges', look for the line that begins with 'exclusion.alphabetic='. Comment out this line by inserting '#' as the first character of the line For example, #exclusion.alphabetic=0700-1e9f,1f00-20ab,20ad-f8ff.

      10. In the section called '# Font File Names' , depending on your language, add the following line 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 the following: filename.Monotype_Sans_Duospace_WT_J=mtsansdj.ttf
        * If your language is Korean, add the following: filename.Monotype_Sans_Duospace_WT_K=mtsansdk.ttf
        * If your language is Simplified Chinese, add the following: filename.Monotype_Sans_Duospace_WT_S=mtsansds.ttf
        * If your language is Traditional Chinese, add the following: filename.Monotype_Sans_Duospace_WT_T=mtsansdt.ttf
      11. Close the file.
      12. Restart the browser.

    [{"Product":{"code":"SSS9FA","label":"IBM Host On-Demand"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"General","Platform":[{"code":"PF033","label":"Windows"}],"Version":"10.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

    Document Information

    Modified date:
    19 April 2021

    UID

    swg21396166