Open ServerConnect can accept and process client requests written in Japanese if you have the JCM installed. The JCM is provided on a separate tape. It does the workstation-to-mainframe-to-workstation translations necessary to process requests containing Japanese characters.
The Open ServerConnect environment must be customized to process Japanese requests. A system programmer customizes your environment when Open ServerConnect is installed. Open ServerConnect loads the customization module when TDINIT is called.
Customization information includes client login information from the client login packet that TRS forwards to the mainframe along with the client request. Among the client information contained in the login packet is the name of the client character set. See “The login packet” for details.
The following options are set during customization:
The native language used at the mainframe
DBCSs; whether double-byte kanji characters are used
Information about single-byte character sets
The use of this option depends on whether DBCS is used:
If double-byte characters are used, this option indicates whether single-byte characters are treated as hankaku katakana or as lowercase alphabetic characters. The default, as shipped, is hankaku katakana.
If double-byte characters are not used, this option names the default (single-byte) character set. In the current version, the default character set is iso-1.
If the native language is Japanese, TDINIT loads the JCM.
An Open ServerConnect program can retrieve customization information with the function TDGETUSR.
Once the JCM is loaded, it gets control whenever an Open ServerConnect program receives a client request containing TDSCHAR or TDSVARYCHAR data. TDSCHAR and TDSVARYCHAR are the datatypes used to represent Japanese characters in workstation character sets. The JCM converts the workstation Japanese characters to the character set used on the mainframe. Once mainframe processing is completed, the JCM converts results back to the original workstation character set before returning them to the client.
The JCM uses translate tables to convert workstation characters to mainframe characters.
When an Open ServerConnect program receives a client request in Japanese that contains character datatypes, it gives control to the JCM. The JCM looks up the client character set in the translate tables.
If the JCM finds a translate table for the client character set, the JCM converts the data and names into the equivalent mainframe characters. After processing is complete, the JCM converts results back to the workstation characters before returning results to the client.
If the client does not specify a character set in the login packet, or if the JCM cannot find a translate table for the client character set, the program fails, and Open ServerConnect sends the client an error message.
