IBM Support

CICS Transaction Gateway support for remote clients

Troubleshooting


Problem

What clients are permitted to connect to a CICS Transaction Gateway? What APIs are available (EPI, ECI or ESI) when using remote client applications Can I connect a non-Java client (for instance using .NET or C) to a remote Gateway daemon?

Resolving The Problem

Question: What clients are permitted to connect to a CICS Transaction Gateway

Answer:
The Gateway daemon component of the CICS Transaction Gateway (CICS TG) supports access from remote Java clients (such as servlets, EJB session beans, or stand-alone applications) from any platform supported by the CICS TG. To ensure compatibility between a Gateway daemon and a remote Java client the following rules should be noted:

  • The Java client environment must utilize a supported JVM or WebSphere Application Server runtime
  • The Java client must utilize a supported version of the CICS TG class libraries or Resource Adapter (RAR)
  • The version of the CICS TG class libraries or RARs must be at the same maintenance level, or lower than the version of the Gateway daemon. For instance, a Gateway daemon at v7.2.0.0 will interoperate with a Java client using the CICS TG v6.1 class library (or RARs) but not with a Java client using the v8.x.x.x class libraries (or RARs).
    Similarly, a Gateway daemon at v7.2.0.1 can be used with a Java client using the CICS TG v7,2.0.0 class library, but the v7.2.0.2 class libraries (or RARs) would be at a higher maintenance level, so would not be supported.
  • The CC03 supportpac provides access to CICS TG resource adapters and the maintenance levels of each resource adapter is documented in the download page http://www.ibm.com/support/docview.wss?uid=swg24008817
  • The operating system utilized by the Java client must be supported by the version of CICS TG class library in use on the client machine
  • Using CICS TG for z/OS resource adapters with CICS TG for Multiplatforms Gateway daemons and vice versa is not supported. It is preferable to use the resource adapters from the CICS_TG_install_directory>/deployable directory of the CICS TG installation where possible, as these will be at the same maintenance level as the Gateway daemon.

Note: The version of the CICS TG can be viewed within the product.xml file, or on distributed platforms can be displayed using the command 'cicscli -v'. When using the CICS JCA resource adapters the associated CICS TG version is documented in the <resourceadapter-version> tag in the ra.xml file.

The supported software for the CICS TG is available on-line at http://www.ibm.com/support/docview.wss?uid=swg21239203

Question: What APIs are available (EPI, ECI or ESI) when using a remote Java client.

Answer: The APIs available are determined by the platform on which the Gateway daemon is installed, the CICS system in use, and the protocol used to communicate with the CICS system. See the information center for the CICS Transaction Gateway product you are using for more details:http://www.ibm.com/software/sw-library/en_US/products/G158593Z87967N09/

Question: Can I connect a non-Java client (for instance using C or .NET) to a remote Gateway daemon.

Answer: Yes, remote non-Java client connectivity is available for C or .NET clients. This requires CICS TG V7.2 or later.

[{"Product":{"code":"SSGMJ2","label":"CICS Transaction Gateway"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Component":"CTG","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF035","label":"z\/OS"},{"code":"PF027","label":"Solaris"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"9.1;9.0;8.1;8.0;7.2","Edition":"","Line of Business":{"code":"LOB70","label":"Z TPS"}}]

Product Synonym

CTG

Document Information

Modified date:
05 January 2026

UID

swg21137783