IBM Support

Creating Alternative ASCII <> EBCDIC Translation Routine for EZASOKET Users

Question & Answer


Question

The usage of the translation routines supplied as part of the product is described in the IP Sockets Application Programming Interface Guide and Reference, IP CICS Sockets Guide, and IP IMS Sockets Guide manuals. However, the translation tables used are fixed, and require submission of a new requirements request to provide alternative translations. Such a change is not practical for custom character sets.

Cause

The current translation routines (EZACIC04, EZACIC14, EZACIC05, and EZACIC15) are delivered as object code only members, with no mechanism provided to customize the tables used.

Answer

The attached file contains assembler source code for an alternative translation routine. It is populated with the translation tables currently shipped in the SEZATCPX library. This member can be customized as desired for an application to:

  • Provide one of the predefined tables to be used in a manner similar to the existing translation routines.
  • Provide the ability to have the calling program select which table to use (from the complete list supplied) at run time.
  • Change the code point values to use in one (or more) of these tables.
  • Add new translation tables.
  • Any combination of the above.

Additional details (including sample calling sequences) are provided in the comments at the beginning of the file.

Note: This sample is included in the SEZAINST library for z/OS 1.9 and above.

ezacictr.txt

[{"Product":{"code":"SSSN3L","label":"z\/OS Communications Server"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"All","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"1.6;1.7;1.8","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Not Applicable","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"4.1;3.2;3.1;2.3;2.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Product":{"code":"SSEPH2","label":"IBM Information Management System (IMS)"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":null,"Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"5.1;6.1;7.1;8.1;9.1;10.1;11.1","Edition":"Enterprise","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
23 August 2018

UID

swg21256665