Support for East Asian Languages



Genie supports Asian languages such as Traditional and Simplified Chinese and Japanese, including both DBCS and Unicode data streams. However, some additional configuration is required for these languages.

Selecting the Workstation Device Type and Keyboard Language Type

Genie uses the following environment variables in the HTTP server configuration file:

  • PUI_GENIE_DEV_TYPE: Workstation device type. This should be set to the same value used in your TN5250 green screen sessions. Valid values and their descriptions are in table Supported Workstation Types and Models  here. The default value if not set is 8 (3477-FC), which is generally not appropriate for East Asian languages.

  • PUI_GENIE_KBD_TYPE: Keyboard language type. This should be set to the same value used in your TN5250 green screen sessions. Valid values and their descriptions are here. The default value if not set is that from system value QKBDTYPE.

The appropriate values can be found by using the DSPDEVD command to inspect a device used in a TN5250 green screen session. The variables can be set using the SetEnv HTTP server configuration directive as shown in the examples below.

Configuring the HTTP Server for DBCS

The HTTP server configuration directive CGIAPIDBCS should be set to OFF in order to correct issues in the HTTP server's handling of DBCS characters, as explained here.

Examples

To set the configuration directives, edit the HTTP server configuration file at /www/INSTANCE_NAME/conf/httpd.conf. The default instance name is PROFOUNDUI, but can be customized at installation time. The configuration directives should be added to the global area of the configuration file – outside of any <Directory>, <Files>, <VirtualHost>, or other blocks.

For Japanese
# Device type 10 = 5555-C01 SetEnv PUI_GENIE_DEV_TYPE 10 SetEnv PUI_GENIE_KBD_TYPE JPB CGIAPIDBCS OFF # This directive is set at installation time, based on the Host Code Page value DefaultFsCCSID 5035



For Traditional Chinese (Hong Kong)
# Device type 10 = 5555-C01 SetEnv PUI_GENIE_DEV_TYPE 10 SetEnv PUI_GENIE_KBD_TYPE TAB CGIAPIDBCS OFF # This directive is set at installation time, based on the Host Code Page value DefaultFsCCSID 1377

The values set in the HTTP server configuration can be overridden for individual Genie sessions using query string parameters "devtype" and "kbdtype". For example:

Override Configuration Settings
http://myIBMi:8080/profoundui/genie?devtype=10&kbdtype=TAB