IBM SDK for Linux platforms, Java Technology Edition

Information for Japanese Users

Version 6

Copyright International Business Machines Corporation 2003, 2009.
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
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
AMD64 and Intel EM64T architecture
Tested environments
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
IBM POWER 32-bit architecture
Tested environments
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
IBM POWER 64-bit architecture
Tested environments
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
zSeries 31-bit architecture
Tested environments
Japanese Kana-Kanji conversion
Input Method Editor (IME)
Canna
FreeWnn
zSeries 64-bit architecture
Tested environments
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™ Technology Edition, Version 6.

Intel IA32 architecture

This section contains information for Intel® IA32 architecture users.

Tested environments

The IBM SDK for Linux, v6 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 Technology Edition, Version 6.

Table 1. Tested environments
Distribution Desktop or window manager Input method
Novell Linux Desktop 9 for x86 SP3 KDE3-3.2.1
kinput2-v3.1
Canna-3.7p1
SUSE Linux Enterprise Server 9 for x86 with Service Pack 3 KDE3-3.2.1
kinput2-v3.1
Canna-3.7p1
SUSE Linux Enterprise Server 9 for AMD64 & Intel EM64T with Service Pack 3 KDE3-3.2.1
kinput2-v3.1
Canna-3.7p1
SUSE Linux Enterprise Server 10 for x86 with Service Pack 1 GNOME-2.12.2
scim-1.4.4
scim-anthy-0.8.0
anthy-7307
SUSE Linux Enterprise Server 10 for AMD64 & Intel EM64T with Service Pack 1 GNOME-2.12.2
scim-1.4.4
scim-anthy-0.8.0
anthy-7307
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
Red Hat Enterprise Linux AS v.4 for 32-bit x86 with Update4 GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
Red Hat Enterprise Linux AS v.4 for AMD64/Intel EM64T with Update4 GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
Red Hat Enterprise Linux 5 Server for 32-bit x86 GNOME-2.16.0
scim-1.4.4
scim-anthy-1.2.0
anthy-7900
Red Hat Enterprise Linux 5 Server for 64-bit x86_64 GNOME-2.16.0
scim-1.4.4
scim-anthy-1.2.0
anthy-7900
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

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.

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.3) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 3 or later.

If you are using SCIM as the input method server, character composition should be completed before you change focus. Do not change focus rapidly with key input because Java might not receive the key event properly.

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, v6 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 Technology Edition, Version 6.

Table 2. Tested environments
Distribution Desktop or window manager Input method
SUSE Linux Enterprise Server 9 for AMD64 & Intel EM64T with Service Pack 3 KDE3-3.2.1
kinput2-v3.1
Canna-3.7p1
SUSE Linux Enterprise Server 10 for AMD64 & Intel EM64T with Service Pack 1 GNOME-2.12.2
scim-1.4.4
scim-anthy-0.8.0
anthy-7307
SUSE Linux Enterprise Server 11 for x86_64 GNOME-2.24
scim-1.4.7
scim-anthy-1.2.4
anthy-9100
Red Hat Enterprise Linux AS v.4 for AMD64/Intel EM64T with Update4 GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
Red Hat Enterprise Linux 5 Server for 64-bit x86_64 GNOME-2.16.0
scim-1.4.4
scim-anthy-1.2.0
anthy-7900
Ubuntu 8.04.1 LTS Desktop (AMD64) GNOME-2.22 (with metacity)
scim-1.4.7
scim-anthy-1.2.4
anthy-9100d

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.

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.3) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 3 or later.

If you are using SCIM as the input method server, character composition should be completed before you change focus. Do not change focus rapidly with key input because Java might not receive the key event properly.

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, v6 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 Technology Edition, Version 6.

Table 3. Tested environments
Distribution Desktop or window manager Input method
SUSE Linux Enterprise Server 9 for IBM POWER with Service Pack 3 KDE3-3.2.1
kinput2-v3.1
Canna-3.7p1
SUSE Linux Enterprise Server 10 for IBM POWER with Service Pack 1 GNOME-2.12.2
scim-1.4.4
scim-anthy-0.8.0
anthy-7307
Red Hat Enterprise Linux AS v.4 for 64-bit IBM POWER with Update4 GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
Red Hat Enterprise Linux 5 Server for 64-bit IBM POWER GNOME-2.16.0
scim-1.4.4
scim-anthy-1.2.0
anthy-7900
SUSE Linux Enterprise Server 11 for IBM POWER GNOME-2.24
scim-1.4.7
scim-anthy-1.2.4
anthy-9100

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.

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.3) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 3 or later.

If you are using SCIM as the input method server, character composition should be completed before you change focus. Do not change focus rapidly with key input because Java might not receive the key event properly.

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, v6 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 Technology Edition, Version 6.

Table 4. Tested environments
Distribution Desktop or window manager Input method
SUSE Linux Enterprise Server 9 for IBM POWER with Service Pack 3 KDE3-3.2.1
kinput2-v3.1
Canna-3.7p1
SUSE Linux Enterprise Server 10 for IBM POWER with Service Pack 1 GNOME-2.12.2
sicm-1.4.4
scim-anthy-0.8.0
anthy-7307
SUSE Linux Enterprise Server 11 for IBM POWER GNOME-2.24
scim-1.4.7
scim-anthy-1.2.4
anthy-9100
Red Hat Enterprise Linux AS v.4 for 64-bit IBM POWER with Update4 GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
Red Hat Enterprise Linux 5 Server for 64-bit IBM POWER GNOME-2.16.0
scim-1.4.4
scim-anthy-1.2.0
anthy-7900

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.

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.3) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 3 or later.

If you are using SCIM as the input method server, character composition should be completed before you change focus. Do not change focus rapidly with key input because Java might not receive the key event properly.

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, v6 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 Technology Edition, Version 6.

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 3 SUSE Linux Enterprise Server 9 for x86 with Service Pack 3 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 3 SUSE Linux Enterprise Server 9 for x86 with Service Pack 3 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 3 SUSE Linux Enterprise Server 9 for x86 with Service Pack 3 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 3 SUSE Linux Enterprise Server 9 for x86 with Service Pack 3 Japanese (UTF-8) KDE3-3.2.1
kinput2-v3.1
Canna-3.7p1
XDM SUSE Linux Enterprise Server 10 for IBM zSeries with Service Pack 1 SUSE Linux Enterprise Server 10 for x86 with Service Pack 1 Japanese (UTF-8) GNOME-2.12.2
scim-1.4.4
scim-anthy-0.8.0
anthy-7307
SSH X11 Forwarding SUSE Linux Enterprise Server 10 for IBM zSeries with Service Pack 1 SUSE Linux Enterprise Server 10 for x86 with Service Pack 1 Japanese (UTF-8) GNOME-2.12.2
scim-1.4.4
scim-anthy-0.8.0
anthy-7307
XDM Red Hat Enterprise Linux AS v.4 for 31-bit IBM S/390 with Update4 Red Hat Enterprise Linux AS v.4 for 32-bit x86 with Update4 Japanese (UTF-8) GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
XDM Red Hat Enterprise Linux AS v.4 for 64-bit IBM zSeries with Update4 Red Hat Enterprise Linux AS v.4 for 32-bit x86 with Update4 Japanese (UTF-8) GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
SSH X11 Forwarding Red Hat Enterprise Linux AS v.4 for 31-bit IBM S/390 with Update4 Red Hat Enterprise Linux AS v.4 for 32-bit x86 with Update4 Japanese (UTF-8) GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
SSH X11 Forwarding Red Hat Enterprise Linux AS v.4 for 64-bit IBM zSeries with Update4 Red Hat Enterprise Linux AS v.4 for 32-bit x86 with Update4 Japanese (UTF-8) GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
XDM Red Hat Enterprise Linux 5 Server for 64-bit IBM System z® Red Hat Enterprise Linux 5 Server for 32-bit x86 Japanese (UTF-8) GNOME-2.16.0
scim-1.4.4
scim-anthy-1.2.0
anthy-7900
SSH X11 Forwarding Red Hat Enterprise Linux 5 Server for 64-bit IBM System z Red Hat Enterprise Linux 5 Server for 32-bit x86 Japanese (UTF-8) GNOME-2.16.0
scim-1.4.4
scim-anthy-1.2.0
anthy-7900
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: 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.

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.3) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 3 or later.

If you are using SCIM as the input method server, character composition should be completed before you change focus. Do not change focus rapidly with key input because Java might not receive the key event properly.

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, v6 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 Technology Edition, Version 6.

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 3 SUSE Linux Enterprise Server 9 for x86 with Service Pack 3 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 3 SUSE Linux Enterprise Server 9 for x86 with Service Pack 3 Japanese (UTF-8) KDE3-3.2.1
kinput2-v3.1
Canna-3.7p1
XDM SUSE Linux Enterprise Server 10 for IBM zSeries with Service Pack 1 SUSE Linux Enterprise Server 10 for x86 with Service Pack 1 Japanese (UTF-8) GNOME-2.12.2
scim-1.4.4
scim-anthy-0.8.0
anthy-7307
SSH X11 Forwarding SUSE Linux Enterprise Server 10 for IBM zSeries with Service Pack 1 SUSE Linux Enterprise Server 10 for x86 with Service Pack 1 Japanese (UTF-8) GNOME-2.12.2
scim-1.4.4
scim-anthy-0.8.0
anthy-7307
XDM Red Hat Enterprise Linux AS v.4 for 64-bit IBM zSeries with Update4 Red Hat Enterprise Linux AS v.4 for 32-bit x86 with Update4 Japanese (UTF-8) GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
SSH X11 Forwarding Red Hat Enterprise Linux AS v.4 for 64-bit IBM zSeries with Update4 Red Hat Enterprise Linux AS v.4 for 32-bit x86 with Update4 Japanese (UTF-8) GNOME-2.8.0
iiimf-*-12.1.13.EL.5
Canna-3.7p3-7.EL4
XDM Red Hat Enterprise Linux 5 Server for 64-bit IBM System z Red Hat Enterprise Linux 5 Server for 32-bit x86 Japanese (UTF-8) GNOME-2.16.0
scim-1.4.4
scim-anthy-1.2.0
anthy-7900
SSH X11 Forwarding Red Hat Enterprise Linux 5 Server for 64-bit IBM System z Red Hat Enterprise Linux 5 Server for 32-bit x86 Japanese (UTF-8) GNOME-2.16.0
scim-1.4.4
scim-anthy-1.2.0
anthy-7900
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: 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.

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.3) or higher. These packages are included in Red Hat Enterprise Linux 4 Update 3 or later.

If you are using SCIM as the input method server, character composition should be completed before you change focus. Do not change focus rapidly with key input because Java might not receive the key event properly.

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 in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

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

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 information. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this information 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:

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 measurement 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.

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.