Previous Topic: Establish Client/Server SupportNext Topic: Define Server Transactions and Programs

Starting Your Product › Configuring Runtime: IMS and CICS › Establish Client/Server Support › Customize Code Page Translation

Customize Code Page Translation

The TIRXLAT function translates view data passed between the client and server from the client's code page to the server's code page, and vice versa. It uses the client's code page value, passed from the client to the server, and the host's code page value to locate a translation table. For additional information about code pages and internationalization considerations, see the Client Server Encyclopedia User Guide.

Since AllFusion Gen 7, the dynamic runtime modules TIRCRUNC (CICS) and TIRCRUNI (IMS) replace runtimes TIRENTC (CICS) and TIRENTI (IMS). Applications built with releases earlier than AllFusion Gen 7 must still use TIRENTC and TIRENTI runtimes.

In many parts of the world, a country or company may use several code pages. If your installation uses a code page on the z/OS system that differs from the supplied default, a JCL procedure is provided to build a code page specific version of the dynamic runtime modules TIRCRUNC and TIRCRUNI. The procedure is called MKCRUN for AllFusion Gen 7 and later releases and MKTIRE for earlier releases. The CEHBSAMP data set includes a sample of MKCRUN.

You may benefit from rebuilding the TIRCRUNC and TIRCRUNI runtimes using the MKCRUN procedure even when you use a code page on the z/OS system that matches the supplied default because the runtime contains extra code page pairs you may not need. MKCRUN removes the pairs.

Note: The debug version of either TIRCRUNC or TIRCRUNI should be used and the output sent to support only when Technical Support asks you to do so. Do not use it any other time. For more information about how to enable tracing, see Debugging Applications.

Note: If TIRCRUNC and TIRCRUNI do not contain the translation table the client and server are using, the CICS transactions abend with an IEFT abend error and IMS transactions abend with a U3500. Use MKCRUN JCL to build a version of TIRCRUNx modules that support the required code page combination.

For information about the list of supported code tables, see the User Exit Reference Guide.