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
Some documentation pages have recently moved to a new section: Profound AppDev. If you are having trouble finding specific pages, try the documentation search capability or reach out to our Support team!