Page tree
Skip to end of metadata
Go to start of metadata

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

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
  • No labels