# IBM SDK for Linux platforms, Java Technology Edition

# Information for Japanese Users

Version 5 Release 0
Note

Before using this information and the product it supports, read the information in Notices.

Copyright information

This edition of the user guide applies to Japanese users of Linux on multiple architectures.

This user guide applies to the following platforms:

- IBM 32-bit SDK and Runtime Environment for Linux on Intel architecture, Java 2 Technology Edition, Version 5.0
- IBM 64-bit SDK and Runtime Environment for Linux on AMD64/EM64T architecture, Java 2 Technology Edition, Version 5.0
- IBM 32-bit SDK and Runtime Environment for Linux on System i® and System p® architecture, Java 2 Technology Edition, Version 5.0
- IBM 64-bit SDK and Runtime Environment for Linux on System i and System p architecture, Java 2 Technology Edition, Version 5.0
- IBM 31-bit SDK and Runtime Environment for Linux on System z architecture, Java 2 Technology Edition, Version 5.0
- IBM 64-bit SDK and Runtime Environment for Linux on System z architecture, Java 2 Technology Edition, Version 5.0

and to all subsequent releases and modifications until otherwise indicated in new editions.

© Copyright Sun Microsystems, Inc. 1997, 2006, 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.

Copyright International Business Machines Corporation 2003, 2010.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

# Contents

Audience
Intel IA32 architecture
Tested environments
Displaying Japanese halfwidth Katakana characters
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
AMD64 and Intel EM64T architecture
Tested environments
Displaying Japanese halfwidth Katakana characters
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
IBM POWER 32-bit architecture
Tested environments
Displaying Japanese halfwidth Katakana characters
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
IBM POWER 64-bit architecture
Tested environments
Displaying Japanese halfwidth Katakana characters
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
zSeries 31-bit architecture
Tested environments
Displaying Japanese halfwidth Katakana characters
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
zSeries 64-bit architecture
Tested environments
Displaying Japanese halfwidth Katakana characters
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
Notices
Trademarks

# Audience

This file contains information that applies to Japanese users only. Read this information in conjunction with the user guides provided with the IBM® SDK and Runtime Environment for Linux® platforms, Java™ 2 Technology Edition, Version 5.0.

# Intel IA32 architecture

This section contains information for Intel® IA32 architecture users.

## Tested environments

The IBM SDK for Linux, v5.0 was tested using multiple Linux distributions, windows managers, and input methods.

The following Japanese environments were tested for the IBM SDK for Linux platforms, Java 2 Technology Edition, Version 5.0.

Table 1. Tested environments
Distribution | Desktop or window manager | Input method
--- | --- | ---
Novell Linux Desktop 9 for x86 SP1 | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
SUSE Linux Enterprise Server 9 for x86 with Service Pack 1 | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
SUSE Linux Enterprise Server 9 for AMD64 & Intel EM64T with Service Pack 1 | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
Red Hat Enterprise Linux AS v.3 for x86 with Update4 | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
Red Hat Enterprise Linux AS v.3 for AMD64/Intel EM64T with Update4 | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
Red Hat Enterprise Linux AS v.4 for 32-bit x86 | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 Canna-3.7p3-7.EL4
Red Hat Enterprise Linux AS v.4 for AMD64/Intel EM64T | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 Canna-3.7p3-7.EL4
SUSE Linux Enterprise Server 11 for x86 | GNOME-2.24 | scim-1.4.7 scim-anthy-1.2.4 anthy-9100
SUSE Linux Enterprise Server 11 for x86_64 | GNOME-2.24 | scim-1.4.7 scim-anthy-1.2.4 anthy-9100
Ubuntu 8.04.1 LTS Desktop (i386) | GNOME-2.22 (with metacity) | scim-1.4.7 scim-anthy-1.2.4 anthy-9100d
Ubuntu 8.04.1 LTS Desktop (amd64) | GNOME-2.22 (with metacity) | scim-1.4.7 scim-anthy-1.2.4 anthy-9100d

Note: The Japanese environments were also tested with these Beta releases:

- Red Hat Enterprise Linux 5 Server for 32-bit x86 (Beta)
- Red Hat Enterprise Linux 5 Server for 64-bit x86_64 (Beta)
- SUSE Linux Enterprise Server 10 for x86 (Beta)
- SUSE Linux Enterprise Server 10 for AMD64 & Intel EM64T (Beta)

### SuSE Linux Enterprise Server 11 for Japanese users

Sometimes an incorrect fonts.dir is generated by the SLES11 installation process. Java uses X11 font settings in fonts.dir to access to True Type fonts. With the wrong fonts.dir, Java might not display the correct characters.

This issue applies only to Japanese TrueType fonts such as Sazanami Gothic and Sazanami Mincho.

To verify your installation, check fonts.dir after installation using the command:

    $ grep "^sazanami-.*misc-sazanami.*10646" /usr/share/fonts/truetype/fonts.dir
    sazanami-gothic.ttf -misc-sazanami gothic-medium-r-normal--0-0-0-0-p-0-iso10646-1
    sazanami-mincho.ttf -misc-sazanami mincho-medium-r-normal--0-0-0-0-p-0-iso10646-1

If your output is not similar to the example output, a root user must run the commands:

    # mkdir /tmp/fonts
    # cd /tmp/fonts
    # cp -i /usr/share/fonts/truetype/sazanami-*.ttf .
    # mkfontscale .
    # cp fonts.scale /usr/share/fonts/truetype/fonts.scale.sazanami
    # cd ~
    # /usr/sbin/fonts-config -v -d -f
    # rm -rf /tmp/fonts

Verify using the previous grep command.

Note: You should use the library `libjavaplugin_ojigtk2.so` on SLES11.

## Displaying Japanese halfwidth Katakana characters

Halfwidth Katakana characters might not be displayed correctly because of the lack of font data for those characters.

## Japanese Kana-Kanji conversion

On Japanese versions of Linux, you can use a Japanese input method such as Canna or FreeWnn.

### Input Method Editor (IME)

Known limitations and solutions for IME users.

If you use an IME on a TextArea or a TextField component with Motif AWT, the composed text is sometimes displayed in the wrong position. To avoid this problem, do not change the component position vertically after you commit a string. If you do encounter this problem, reactivate the IME; the composed text is then displayed at the correct position. The committed text is always displayed at the correct position.

If you are using kinput2 as the input method server, do not use the Close button on the window frame because kinput2 might be stopped by this operation.

If you are using IIIMF as the input method server on Red Hat Enterprise Linux 4, Java requires the IIIMF packages (iiimf-*-12.1.13.EL.2) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 2 or later.

### Canna

Limitations using Canna with quoted-insert-mode.

If you switch to quoted-insert-mode by pressing Ctrl + Q, entering control characters might cause unexpected behavior. To avoid this problem, disable quoted-insert-mode by adding the following line to `$HOME/.canna`. If `$HOME/.canna` does not exist, copy `default.canna` to the home directory as `$HOME/.canna` and add the following line:

    (global-unbind-key-function 'quoted-insert)

### FreeWnn

If you are using FreeWnn, the numpad Enter key might not create a new line and a carriage return while the Input Method Editor (IME) is activated. To create a new line and carriage return, deactivate the IME.

# AMD64 and Intel EM64T architecture

This section contains information for AMD64 and Intel EM64T architecture users.

## Tested environments

The IBM SDK for Linux, v5.0 was tested using multiple Linux distributions, windows managers, and input methods.

The following Japanese environments were tested for the IBM SDK for Linux platforms, Java 2 Technology Edition, Version 5.0.

Table 2. Tested environments
Distribution | Desktop or window manager | Input method
--- | --- | ---
SUSE Linux Enterprise Server 9 for AMD64 & Intel EM64T with Service Pack 1 | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
Red Hat Enterprise Linux AS v.3 for AMD64/Intel EM64T with Update4 | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
Red Hat Enterprise Linux AS v.4 for AMD64/Intel EM64T | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 Canna-3.7p3-7.EL4
SUSE Linux Enterprise Server 11 for x86_64 | GNOME-2.24 | scim-1.4.7 scim-anthy-1.2.4 anthy-9100
Ubuntu 8.04.1 LTS Desktop (amd64) | GNOME-2.22 (with metacity) | scim-1.4.7 scim-anthy-1.2.4 anthy-9100d

Note: The Japanese environments were also tested with these Beta releases:

- Red Hat Enterprise Linux 5 Server for 64-bit x86_64 (Beta)
- SUSE Linux Enterprise Server 10 for AMD64 and Intel EM64T (Beta)

### SuSE Linux Enterprise Server 11 for Japanese users

Sometimes an incorrect fonts.dir is generated by the SLES11 installation process. Java uses X11 font settings in fonts.dir to access to True Type fonts. With the wrong fonts.dir, Java might not display the correct characters.

This issue applies only to Japanese TrueType fonts such as Sazanami Gothic and Sazanami Mincho.

To verify your installation, check fonts.dir after installation using the command:

    $ grep "^sazanami-.*misc-sazanami.*10646" /usr/share/fonts/truetype/fonts.dir
    sazanami-gothic.ttf -misc-sazanami gothic-medium-r-normal--0-0-0-0-p-0-iso10646-1
    sazanami-mincho.ttf -misc-sazanami mincho-medium-r-normal--0-0-0-0-p-0-iso10646-1

If your output is not similar to the example output, a root user must run the commands:

    # mkdir /tmp/fonts
    # cd /tmp/fonts
    # cp -i /usr/share/fonts/truetype/sazanami-*.ttf .
    # mkfontscale .
    # cp fonts.scale /usr/share/fonts/truetype/fonts.scale.sazanami
    # cd ~
    # /usr/sbin/fonts-config -v -d -f
    # rm -rf /tmp/fonts

Verify using the previous grep command.

## Displaying Japanese halfwidth Katakana characters

Halfwidth Katakana characters might not be displayed correctly because of the lack of font data for those characters.

## Japanese Kana-Kanji conversion

On Japanese versions of Linux, you can use a Japanese input method such as Canna or FreeWnn.

### Input Method Editor (IME)

Known limitations and solutions for IME users.

If you use an IME on a TextArea or a TextField component with Motif AWT, the composed text is sometimes displayed in the wrong position. To avoid this problem, do not change the component position vertically after you commit a string. If you do encounter this problem, reactivate the IME; the composed text is then displayed at the correct position. The committed text is always displayed at the correct position.

If you are using kinput2 as the input method server, do not use the Close button on the window frame because kinput2 might be stopped by this operation.

If you are using IIIMF as the input method server on Red Hat Enterprise Linux 4, Java requires the IIIMF packages (iiimf-*-12.1.13.EL.2) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 2 or later.

### Canna

Limitations using Canna with quoted-insert-mode.

If you switch to quoted-insert-mode by pressing Ctrl + Q, entering control characters might cause unexpected behavior. To avoid this problem, disable quoted-insert-mode by adding the following line to `$HOME/.canna`. If `$HOME/.canna` does not exist, copy `default.canna` to the home directory as `$HOME/.canna` and add the following line:

    (global-unbind-key-function 'quoted-insert)

### FreeWnn

If you are using FreeWnn, the numpad Enter key might not create a new line and a carriage return while the Input Method Editor (IME) is activated. To create a new line and carriage return, deactivate the IME.

# IBM POWER 32-bit architecture

This section contains information for IBM POWER® 32-bit architecture users. IBM POWER systems can run AIX®, Linux or IBM i operating systems.

## Tested environments

The IBM SDK for Linux, v5.0 was tested using multiple Linux distributions, windows managers, and input methods.

The following Japanese environments were tested for the IBM SDK for Linux platforms, Java 2 Technology Edition, Version 5.0.

Table 3. Tested environments
Distribution | Desktop or window manager | Input method
--- | --- | ---
SUSE Linux Enterprise Server 9 for IBM POWER with Service Pack 1 | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
Red Hat Enterprise Linux AS v.3 for iSeries® and pSeries® with Update4 | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
Red Hat Enterprise Linux AS v.4 for 64-bit IBM POWER | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 Canna-3.7p3-7.EL4
SUSE Linux Enterprise Server 11 for IBM POWER | GNOME-2.24 | scim-1.4.7 scim-anthy-1.2.4 anthy-9100

Note: The Japanese environments were also tested with these Beta releases:

- Red Hat Enterprise Linux 5 Server for 64-bit IBM POWER (Beta)
- SUSE Linux Enterprise Server 10 for IBM POWER (Beta)

### SuSE Linux Enterprise Server 11 for Japanese users

Sometimes an incorrect fonts.dir is generated by the SLES11 installation process. Java uses X11 font settings in fonts.dir to access to True Type fonts. With the wrong fonts.dir, Java might not display the correct characters.

This issue applies only to Japanese TrueType fonts such as Sazanami Gothic and Sazanami Mincho.

To verify your installation, check fonts.dir after installation using the command:

    $ grep "^sazanami-.*misc-sazanami.*10646" /usr/share/fonts/truetype/fonts.dir
    sazanami-gothic.ttf -misc-sazanami gothic-medium-r-normal--0-0-0-0-p-0-iso10646-1
    sazanami-mincho.ttf -misc-sazanami mincho-medium-r-normal--0-0-0-0-p-0-iso10646-1

If your output is not similar to the example output, a root user must run the commands:

    # mkdir /tmp/fonts
    # cd /tmp/fonts
    # cp -i /usr/share/fonts/truetype/sazanami-*.ttf .
    # mkfontscale .
    # cp fonts.scale /usr/share/fonts/truetype/fonts.scale.sazanami
    # cd ~
    # /usr/sbin/fonts-config -v -d -f
    # rm -rf /tmp/fonts

Verify using the previous grep command.

Note: This release was tested on pSeries only.

## Displaying Japanese halfwidth Katakana characters

Halfwidth Katakana characters might not be displayed correctly because of the lack of font data for those characters.

## Japanese Kana-Kanji conversion

On Japanese versions of Linux, you can use a Japanese input method such as Canna or FreeWnn.

### Input Method Editor (IME)

Known limitations and solutions for IME users.

If you use an IME on a TextArea or a TextField component with Motif AWT, the composed text is sometimes displayed in the wrong position. To avoid this problem, do not change the component position vertically after you commit a string. If you do encounter this problem, reactivate the IME; the composed text is then displayed at the correct position. The committed text is always displayed at the correct position.

If you are using kinput2 as the input method server, do not use the Close button on the window frame because kinput2 might be stopped by this operation.

If you are using IIIMF as the input method server on Red Hat Enterprise Linux 4, Java requires the IIIMF packages (iiimf-*-12.1.13.EL.2) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 2 or later.

### Canna

Limitations using Canna with quoted-insert-mode.

If you switch to quoted-insert-mode by pressing Ctrl + Q, entering control characters might cause unexpected behavior. To avoid this problem, disable quoted-insert-mode by adding the following line to `$HOME/.canna`. If `$HOME/.canna` does not exist, copy `default.canna` to the home directory as `$HOME/.canna` and add the following line:

    (global-unbind-key-function 'quoted-insert)

### FreeWnn

If you are using FreeWnn, the numpad Enter key might not create a new line and a carriage return while the Input Method Editor (IME) is activated. To create a new line and carriage return, deactivate the IME.

# IBM POWER 64-bit architecture

This section contains information for IBM POWER 64-bit architecture users. IBM POWER systems can run AIX, Linux or IBM i operating systems.

## Tested environments

The IBM SDK for Linux, v5.0 was tested using multiple Linux distributions, windows managers, and input methods.

The following Japanese environments were tested for the IBM SDK for Linux platforms, Java 2 Technology Edition, Version 5.0.

Table 4. Tested environments
Distribution | Desktop or window manager | Input method
--- | --- | ---
SUSE Linux Enterprise Server 9 for IBM POWER with Service Pack 1 | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
Red Hat Enterprise Linux AS v.3 for iSeries and pSeries with Update4 | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
Red Hat Enterprise Linux AS v.4 for 64-bit IBM POWER | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 Canna-3.7p3-7.EL4
SUSE Linux Enterprise Server 11 for IBM POWER | GNOME-2.24 | scim-1.4.7 scim-anthy-1.2.4 anthy-9100

Note: The Japanese environments were also tested with these Beta releases:

- Red Hat Enterprise Linux 5 Server for 64-bit IBM POWER (Beta)
- SUSE Linux Enterprise Server 10 for IBM POWER (Beta)

### SuSE Linux Enterprise Server 11 for Japanese users

Sometimes an incorrect fonts.dir is generated by the SLES11 installation process. Java uses X11 font settings in fonts.dir to access to True Type fonts. With the wrong fonts.dir, Java might not display the correct characters.

This issue applies only to Japanese TrueType fonts such as Sazanami Gothic and Sazanami Mincho.

To verify your installation, check fonts.dir after installation using the command:

    $ grep "^sazanami-.*misc-sazanami.*10646" /usr/share/fonts/truetype/fonts.dir
    sazanami-gothic.ttf -misc-sazanami gothic-medium-r-normal--0-0-0-0-p-0-iso10646-1
    sazanami-mincho.ttf -misc-sazanami mincho-medium-r-normal--0-0-0-0-p-0-iso10646-1

If your output is not similar to the example output, a root user must run the commands:

    # mkdir /tmp/fonts
    # cd /tmp/fonts
    # cp -i /usr/share/fonts/truetype/sazanami-*.ttf .
    # mkfontscale .
    # cp fonts.scale /usr/share/fonts/truetype/fonts.scale.sazanami
    # cd ~
    # /usr/sbin/fonts-config -v -d -f
    # rm -rf /tmp/fonts

Verify using the previous grep command.

Note: This release was tested on pSeries only.

## Displaying Japanese halfwidth Katakana characters

Halfwidth Katakana characters might not be displayed correctly because of the lack of font data for those characters.

## Japanese Kana-Kanji conversion

On Japanese versions of Linux, you can use a Japanese input method such as Canna or FreeWnn.

### Input Method Editor (IME)

Known limitations and solutions for IME users.

If you use an IME on a TextArea or a TextField component with Motif AWT, the composed text is sometimes displayed in the wrong position. To avoid this problem, do not change the component position vertically after you commit a string. If you do encounter this problem, reactivate the IME; the composed text is then displayed at the correct position. The committed text is always displayed at the correct position.

If you are using kinput2 as the input method server, do not use the Close button on the window frame because kinput2 might be stopped by this operation.

If you are using IIIMF as the input method server on Red Hat Enterprise Linux 4, Java requires the IIIMF packages (iiimf-*-12.1.13.EL.2) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 2 or later.

### Canna

Limitations using Canna with quoted-insert-mode.

If you switch to quoted-insert-mode by pressing Ctrl + Q, entering control characters might cause unexpected behavior. To avoid this problem, disable quoted-insert-mode by adding the following line to `$HOME/.canna`. If `$HOME/.canna` does not exist, copy `default.canna` to the home directory as `$HOME/.canna` and add the following line:

    (global-unbind-key-function 'quoted-insert)

### FreeWnn

If you are using FreeWnn, the numpad Enter key might not create a new line and a carriage return while the Input Method Editor (IME) is activated. To create a new line and carriage return, deactivate the IME.

# zSeries 31-bit architecture

This section contains information for zSeries® 31-bit architecture users.

## Tested environments

The IBM SDK for Linux, v5.0 was tested using multiple Linux distributions, windows managers, and input methods.

The following Japanese environments were tested for the IBM SDK for Linux platforms, Java 2 Technology Edition, Version 5.0.

Table 5. Tested environments
Connectivity | Mainframe-side distribution | PC-side OS | Language and encoding | Desktop or window manager | Input method
--- | --- | --- | --- | --- | ---
XDM | SUSE Linux Enterprise Server 9 for IBM S/390® (31 bit) with Service Pack 1 | SUSE Linux Enterprise Server 9 for x86 with Service Pack 1 | Japanese (UTF-8) | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
XDM | SUSE Linux Enterprise Server 9 for IBM zSeries with Service Pack 1 | SUSE Linux Enterprise Server 9 for x86 with Service Pack 1 | Japanese (UTF-8) | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
SSH X11 Forwarding | SUSE Linux Enterprise Server 9 for IBM S/390 (31 bit) with Service Pack 1 | SUSE Linux Enterprise Server 9 for x86 with Service Pack 1 | Japanese (UTF-8) | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
SSH X11 Forwarding | SUSE Linux Enterprise Server 9 for IBM zSeries with Service Pack 1 | SUSE Linux Enterprise Server 9 for x86 with Service Pack 1 | Japanese (UTF-8) | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
XDM | Red Hat Enterprise Linux AS v.3 for S/390 with Update4 | Red Hat Enterprise Linux AS v.3 for x86 with Update4 | Japanese (EUC) | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
XDM | Red Hat Enterprise Linux AS v.3 for zSeries with Update4 | Red Hat Enterprise Linux AS v.3 for x86 with Update4 | Japanese (EUC) | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
SSH X11 Forwarding | Red Hat Enterprise Linux AS v.3 for S/390 with Update4 | Red Hat Enterprise Linux AS v.3 for x86 with Update4 | Japanese (EUC) | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
SSH X11 Forwarding | Red Hat Enterprise Linux AS v.3 for zSeries with Update4 | Red Hat Enterprise Linux AS v.3 for x86 with Update4 | Japanese (EUC) | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
XDM | Red Hat Enterprise Linux AS v.4 for 31-bit IBM S/390 | Red Hat Enterprise Linux AS v.4 for 32-bit x86 | Japanese (UTF-8) | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 with patch Canna-3.7p3-7.EL4
XDM | Red Hat Enterprise Linux AS v.4 for 64-bit IBM zSeries | Red Hat Enterprise Linux AS v.4 for 32-bit x86 | Japanese (UTF-8) | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 with patch Canna-3.7p3-7.EL4
SSH X11 Forwarding | Red Hat Enterprise Linux AS v.4 for 31-bit IBM S/390 | Red Hat Enterprise Linux AS v.4 for 32-bit x86 | Japanese (UTF-8) | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 with patch Canna-3.7p3-7.EL4
SSH X11 Forwarding | Red Hat Enterprise Linux AS v.4 for 64-bit IBM zSeries | Red Hat Enterprise Linux AS v.4 for 32-bit x86 | Japanese (UTF-8) | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 with patch Canna-3.7p3-7.EL4
XDM | SUSE Linux Enterprise Server 11 for IBM System z® | SUSE Linux Enterprise Server 11 for x86 | Japanese (UTF-8) | GNOME-2.24 | scim-1.4.7 scim-anthy-1.2.4 anthy-9100

Note: The XDM and SSH X11 Forwarding Japanese environments were also tested with these Beta releases:

- Red Hat Enterprise Linux 5 Server for 64-bit IBM System z (Beta)
- SUSE Linux Enterprise Server 10 for IBM zSeries (Beta)

Note: System z systems do not have graphical displays. To use graphical Java applications on System z you must run an X-Server on another system and use XDM or SSH X11 Forwarding on System z. With an XDM connection, the window manager and input method on the System z system is used. With an SSH X11 Forwarding connection, the window manager and input method on the PC-side OS is used.
Note: For SuSE Linux Enterprise Server 11 for Japanese users, an incorrect `fonts.dir` might be generated by the SLES11 installation process. Java uses X11 font settings in `fonts.dir` to access True Type fonts. If the `fonts.dir` is incorrect, Java might not display the correct characters. This problem applies only to the Japanese TrueType fonts Sazanami Gothic, and Sazanami Mincho. To check the `fonts.dir` after installation, enter the following command:

    $ grep "^sazanami-.*misc-sazanami.*10646" /usr/share/fonts/truetype/fonts.dir

You should see results similar to the following output:

    sazanami-gothic.ttf -misc-sazanami gothic-medium-r-normal--0-0-0-0-p-0-iso10646-1
    sazanami-mincho.ttf -misc-sazanami mincho-medium-r-normal--0-0-0-0-p-0-iso10646-1

If your results are not similar, run the following commands as a root user:

    mkdir /tmp/fonts
    cd /tmp/fonts
    cp -i /usr/share/fonts/truetype/sazanami-*.ttf .
    mkfontscale .
    cp fonts.scale /usr/share/fonts/truetype/fonts.scale.sazanami
    cd ~
    /usr/sbin/fonts-config -v -d -f
    rm -rf /tmp/fonts

For verification, use the grep command.

## Displaying Japanese halfwidth Katakana characters

Halfwidth Katakana characters might not be displayed correctly because of the lack of font data for those characters.

## Japanese Kana-Kanji conversion

On Japanese versions of Linux, you can use a Japanese input method such as Canna or FreeWnn.

### Input Method Editor (IME)

Known limitations and solutions for IME users.

If you use an IME on a TextArea or a TextField component with Motif AWT, the composed text is sometimes displayed in the wrong position. To avoid this problem, do not change the component position vertically after you commit a string. If you do encounter this problem, reactivate the IME; the composed text is then displayed at the correct position. The committed text is always displayed at the correct position.

If you are using kinput2 as the input method server, do not use the Close button on the window frame because kinput2 might be stopped by this operation.

If you are using IIIMF as the input method server on Red Hat Enterprise Linux 4, Java requires the IIIMF packages (iiimf-*-12.1.13.EL.2) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 2 or later.

If you are using PC-side IIIMF as the input method server, you might not be able to input any characters. If you see this situation, please contact Red Hat. See Red Hat Bugzilla number RIT77126.

If you are using IIIMF as the input method server, you might experience IIIMF failures or a failure to start. See Red Hat Bugzilla number RIT73533.

### Canna

Limitations using Canna with quoted-insert-mode.

If you switch to quoted-insert-mode by pressing Ctrl + Q, entering control characters might cause unexpected behavior. To avoid this problem, disable quoted-insert-mode by adding the following line to `$HOME/.canna`. If `$HOME/.canna` does not exist, copy `default.canna` to the home directory as `$HOME/.canna` and add the following line:

    (global-unbind-key-function 'quoted-insert)

### FreeWnn

If you are using FreeWnn, the numpad Enter key might not create a new line and a carriage return while the Input Method Editor (IME) is activated. To create a new line and carriage return, deactivate the IME.

# zSeries 64-bit architecture

This section contains information for zSeries 64-bit architecture users.

## Tested environments

The IBM SDK for Linux, v5.0 was tested using multiple Linux distributions, windows managers, and input methods.

The following Japanese environments were tested for the IBM SDK for Linux platforms, Java 2 Technology Edition, Version 5.0.

Table 6. Tested environments
Connectivity | Mainframe-side distribution | PC-side OS | Language and encoding | Desktop or window manager | Input method
--- | --- | --- | --- | --- | ---
XDM | SUSE Linux Enterprise Server 9 for IBM zSeries with Service Pack 1 | SUSE Linux Enterprise Server 9 for x86 with Service Pack 1 | Japanese (UTF-8) | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
SSH X11 Forwarding | SUSE Linux Enterprise Server 9 for IBM zSeries with Service Pack 1 | SUSE Linux Enterprise Server 9 for x86 with Service Pack 1 | Japanese (UTF-8) | KDE3-3.2.1 | kinput2-v3.1 Canna-3.7p1
XDM | Red Hat Enterprise Linux AS v.3 for zSeries with Update4 | Red Hat Enterprise Linux AS v.3 for x86 with Update4 | Japanese (EUC) | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
SSH X11 Forwarding | Red Hat Enterprise Linux AS v.3 for zSeries with Update4 | Red Hat Enterprise Linux AS v.3 for x86 with Update4 | Japanese (EUC) | GNOME-2.2.2 | kinput2-canna-wnn6-v3.1 Canna 3.6-20 FreeWnn 1.11-36.3
XDM | Red Hat Enterprise Linux AS v.4 for 64-bit IBM zSeries | Red Hat Enterprise Linux AS v.4 for 32-bit x86 | Japanese (UTF-8) | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 with patch Canna-3.7p3-7.EL4
SSH X11 Forwarding | Red Hat Enterprise Linux AS v.4 for 64-bit IBM zSeries | Red Hat Enterprise Linux AS v.4 for 32-bit x86 | Japanese (UTF-8) | GNOME-2.8.0 | iiimf-*-12.1.13.EL.2 with patch Canna-3.7p3-7.EL4
XDM | SUSE Linux Enterprise Server 11 for IBM System z | SUSE Linux Enterprise Server 11 for x86 | Japanese (UTF-8) | GNOME-2.24 | scim-1.4.7 scim-anthy-1.2.4 anthy-9100

Note: The XDM and SSH X11 Forwarding Japanese environments were also tested with these Beta releases:

- Red Hat Enterprise Linux 5 Server for 64-bit IBM System z (Beta)
- SUSE Linux Enterprise Server 10 for IBM zSeries (Beta)

Note: System z systems do not have graphical displays. To use graphical Java applications on Ssytem z you must run an X-Server on another system and use XDM or SSH X11 Forwarding on System z. With an XDM connection, the window manager and input method on the System z system is used. With an SSH X11 Forwarding connection, the window manager and input method on the PC-side OS is used.
Note: For SuSE Linux Enterprise Server 11 for Japanese users, an incorrect `fonts.dir` might be generated by the SLES11 installation process. Java uses X11 font settings in `fonts.dir` to access True Type fonts. If the `fonts.dir` is incorrect, Java might not display the correct characters. This problem applies only to the Japanese TrueType fonts Sazanami Gothic, and Sazanami Mincho. To check the `fonts.dir` after installation, enter the following command:

    $ grep "^sazanami-.*misc-sazanami.*10646" /usr/share/fonts/truetype/fonts.dir

You should see results similar to the following output:

    sazanami-gothic.ttf -misc-sazanami gothic-medium-r-normal--0-0-0-0-p-0-iso10646-1
    sazanami-mincho.ttf -misc-sazanami mincho-medium-r-normal--0-0-0-0-p-0-iso10646-1

If your results are not similar, run the following commands as a root user:

    mkdir /tmp/fonts
    cd /tmp/fonts
    cp -i /usr/share/fonts/truetype/sazanami-*.ttf .
    mkfontscale .
    cp fonts.scale /usr/share/fonts/truetype/fonts.scale.sazanami
    cd ~
    /usr/sbin/fonts-config -v -d -f
    rm -rf /tmp/fonts

For verification, use the grep command.

## Displaying Japanese halfwidth Katakana characters

Halfwidth Katakana characters might not be displayed correctly because of the lack of font data for those characters.

## Japanese Kana-Kanji conversion

On Japanese versions of Linux, you can use a Japanese input method such as Canna or FreeWnn.

### Input Method Editor (IME)

Known limitations and solutions for IME users.

If you use an IME on a TextArea or a TextField component with Motif AWT, the composed text is sometimes displayed in the wrong position. To avoid this problem, do not change the component position vertically after you commit a string. If you do encounter this problem, reactivate the IME; the composed text is then displayed at the correct position. The committed text is always displayed at the correct position.

If you are using kinput2 as the input method server, do not use the Close button on the window frame because kinput2 might be stopped by this operation.

If you are using IIIMF as the input method server on Red Hat Enterprise Linux 4, Java requires the IIIMF packages (iiimf-*-12.1.13.EL.2) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 2 or later.

If you are using PC-side IIIMF as the input method server, you might not be able to input any characters. If you see this situation, please contact Red Hat. See Red Hat Bugzilla number RIT77126.

If you are using IIIMF as the input method server, you might experience IIIMF failures or a failure to start. See Red Hat Bugzilla number RIT73533.

### Canna

Limitations using Canna with quoted-insert-mode.

If you switch to quoted-insert-mode by pressing Ctrl + Q, entering control characters might cause unexpected behavior. To avoid this problem, disable quoted-insert-mode by adding the following line to `$HOME/.canna`. If `$HOME/.canna` does not exist, copy `default.canna` to the home directory as `$HOME/.canna` and add the following line:

    (global-unbind-key-function 'quoted-insert)

### FreeWnn

If you are using FreeWnn, the numpad Enter key might not create a new line and a carriage return while the Input Method Editor (IME) is activated. To create a new line and carriage return, deactivate the IME.

# Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

- IBM Director of Licensing
- IBM Corporation
- North Castle Drive
- Armonk, NY 10504-1758
- U.S.A.

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

- Intellectual Property Licensing
- Legal and Intellectual Property Law
- IBM Japan Ltd.
- 1623-14, Shimotsuruma, Yamato-shi
- Kanagawa 242-8502 Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

- JIMMAIL@uk.ibm.com
- [Hursley Java Technology Center (JTC) contact]

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. _enter the year or years_.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

## Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at http://www.ibm.com/legal/copytrade.shtml.

Intel is a trademark of Intel Corporation in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.