|
|
| |
 System i Access
 | | |
IBM 5250 Ideographic (DBCS) Language Support Requirements and Setup
Input methods are used to input characters that are not found on the keyboard. Languages that require more characters than the keyboard contains must use an Input Method Editor (IME) to compose characters. The X Input Method protocol was developed to allow the X Input Method Editors (XIME) to compose and send characters to X applications. Ideographic languages, formerly referred to as Double Byte Character Set (DBCS) languages, will require an IME that is XIM compliant when using ibm5250 to connect to ideographic locale i5/OS sessions. For more technical information on IME, XIM or XIME, see the Links section at the end of this document.
Requirements
IBM 5250 requires the following for ideographic language (DBCS) support
- LANG environment variable is set to the proper locale.
- Input Method editor (IME) that is X Input Method (XIM) compliant, installed and configured for the ideographic language (DBCS) language.
- Monospaced fonts with the proper Single Byte and Double Byte encodings for the language.
- IBM5250*inputMethod resource is correct for the X Input Method Editor (XIME).
- The environment variable XMODIFIERS is set for the XIME.
- The IME is started before launching ibm5250.
Default XIME Setting/Values and Required Fonts
The default IBM5250 XIME values are
IBM5250*inputmethod: XIME
XMODIFIERS=@im= XIME
The following monospaced font sets are required:
For 8x16 and 16x16 FontSet
-*-*-medium-r-normal--*-*-*-*-c-80-(see encodings below) Single Byte
-*-*-medium-r-normal--*-*-*-*-c-160-(see encodings below) Double Byte
For 12x24 and 24x24 FontSet
-*-*-medium-r-normal--*-*-*-*-c-120-(see encodings below) Single Byte
-*-*-medium-r-normal--*-*-*-*-c-240-(see encodings below) Double Byte
To display the available fonts, type:
xlsfonts -fn "FontPattern"
For example, to display the available jisx0201.1976-0 fonts
xlsfonts -fn "-*-*-medium-r-normal--*-*-*-*-c-*-jisx0201.1976-0"
NOTE:
IBM 5250 has only been tested using the default XIM compliant IME's listed below.
|
|
| Language |
Simplified Chinese |
Traditional Chinese |
Japanese |
Korean |
XIME
|
xcin-zh_CN
|
xcin-zh_TW
|
kinput2
|
nabi
|
xx (MRI dir /opt/ibm/iSeriesAccess/mri/xx)
|
zh
|
zh_TW
|
ja
|
ko
|
| LANG |
zh_CN |
zh_TW |
ja_JP |
ko_KR |
Font Encoding SB
|
iso8859-1 |
iso8859-1 |
jisx0201.1976-0 |
iso8859-1 |
Font Encoding DB
|
gb2312.1980-0 |
big5-0 |
jisx0208.1983-0 |
ksc5601.1987-0 |
National Lanugage Version (NLV)
|
2989 |
2987 |
2962 |
2986 |
|
Steps Required to Use an Alternate XIME
Follow the instructions for installation and setup provided by the distribution or XIME project.
You will need the following 2 values provided by the XIME project documentation:
- The resource value IBM5250*inputMethod: value1
- The environment variable XMODIFIERS=@im=value2
Note: Sometimes value1 = value2.
To use a different XIME, you must:
- Change the IBM5250*inputmethod: resource.
As root edit /opt/ibm/iSeriesAccess/mri/xx/ NS3270Tx.rc (Click on xx for values)
and change the default value to value1.
IBM5250*inputmethod: value1
- Change or set the environment variables LANG and XMODIFIERS
(See NOTE below if you want the values set all the time.)
From an X terminal (xterm, kterm etc)
export LANG=xx_XX
export XMODIFIERS=@im=value2
- Start the IME (follow the XIME project documentation and see NOTE below)
From an X terminal (xterm, kterm etc)
<path to XIM>/Alternative_XIM
NOTE:
Check/edit your user files (~/.xinitrc, ~/.bashrc and ~/.profile) and global files (/etc/X11/xinitrc, /etc/barshrc, and /etc/profile), some distributions will source ~/.xim or ~/.i18n to set the LANG and XMODIFIERS environment variables and also start the XIME.
Example: Change XIME for Japanese to use my_IME
If the documentation for my_IME project provided the following information
XMODIFIERS=@im=MY_IME
*inputMethod: my_IME
IME executable name is /newpath/my_ime
The steps would be:
- Switch to root (su -l), edit the /opt/ibm/iSeriesAccess/mri/ja/NS3270Tx.rc
change this line
IBM5250*inputmethod: kinput2
to this
IBM5250*inputmethod: my_IME
- To test, from an X terminal as a regular (non-root) user
export LANG=ja_JP (Set LANG if not already setup)
export XMODIFIERS=@im=MY_IME (Set XMODIERS= new XIME)
- Start the IME and emulator
/newpath/my_ime & (Launch the IME GUI)
ibm5250 JAPANESE_HOST (Launch 5250 emulator)
Troubleshooting
- Check the XIME project or your distributions XIME documentation first.
- Test the XIME with another X application that is XIM aware or compliant.
- Verify the required fonts are installed.
- Verify that IBM5250*inputmethod resourse, LANG and XMODIFIERS are correct.
- Verify the IME is started before launching ibm5250.
|
| |
|
|
|