Content Freeze
As of July 25th, 2023, there is a content freeze on this page.
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.
# 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
# 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:
http://myIBMi:8080/profoundui/genie?devtype=10&kbdtype=TAB