Over the past five years the CICS Transaction Gateway team have released a number of SupportPacs to support the development of applications calling CICS using CICS TG APIs. This post provides a summary of these SupportPacs, including detail on the evolution of the API for .NET Framework-based applications.
Click the links to the specific SupportPacs to find further detail and API documentation.
- CA5F: IBM CICS TG 'gateway' intercept plug-in support
- CA0B: 64-bit ECI Version 2 support for CICS Transaction Gateway V8
- CA76: CICS Transaction Gateway V9 SSL connectivity for .NET applications
- CA75: CICS TG 8.0 channel and container support for .NET clients
- CA73: CICS TG V7.2 .NET application support
- CA72: CICS TG: Developing .NET components for CICS connectivity
CA5F: IBM CICS TG 'gateway' intercept plug-in support
CA5F: IBM CICS TG 'gateway' intercept plug-in support is one of our more recent application development SupportPacs, for use when developing and testing Java and JCA applications that call CICS using CICS TG. The SupportPac provides updated versions of the CICS TG Java and JCA APIs which allow applications to be tested without needing a running CICS TG or CICS instance. By supplying an intercept plug-in, a tester can simulate the responses from CICS to verify that the application behaves as expected. The real power of the SupportPac comes when used with integration test tools such as IBM Rational Test Workbench which can record the interactions between an application and CICS and then use those recorded interactions to simulate responses from CICS for application testing. This SupportPac is for use with CICS TG V8.0 or later.
CA0B: 64-bit ECI Version 2 support for CICS Transaction Gateway V8
For developers of C or C++ programs on AIX, we produced CA0B: 64-bit ECI Version 2 support for CICS Transaction Gateway V8 which provides a 64-bit version of the ECI V2 API for AIX to allow 64-bit C or C++ programs to call COMMAREA-based CICS programs. After its initial release the SupportPac was updated to allow ECI calls to be executed asynchronously. The content of the SupportPac was incorporated into CICS TG V9.0 and extended across all non-z/OS platforms to make the asynchronous capability available to both 32-bit and 64-bit programs, and to include support for CICS channels and containers, password phrases and ESI.
CA76: CICS Transaction Gateway V9 SSL connectivity for .NET applications
For use with CICS TG V9.0, CA76: CICS Transaction Gateway V9 SSL connectivity for .NET applications extends the .NET API provided in CICS TG V9.0 to allow Secure Sockets Layer (SSL) technology to be used to provide secure communication between the .NET application and CICS TG. As this SupportPac is based on the CICS TG V9.0 API it benefits from both 32-bit and 64-bit operation without any dependency on ECI V2, and in combination with the IPIC over SSL capabilities provided in V9.0 allows you to secure all communication links in your environment.
CA75: CICS TG 8.0 channel and container support for .NET clients
For use with CICS TG V8.0, CA75: CICS TG 8.0 channel and container support for .NET clients extends the .NET API provided in CICS TG V8.0 to include support for CICS channels and containers. When using the IPIC protocol to communicate with CICS, channels and containers allow the data limits of COMMAREA-based applications to be far exceeded, and applications benefit from automatic code page conversion for character data. The content of the SupportPac was incorporated into CICS TG V8.1 but it is useful if you want to use channels and containers with CICS TG V8.0.
CA73: CICS TG V7.2 .NET application support
For use with CICS TG V7.2, CA73: CICS TG V7.2 .NET application support contains the earliest version of the CICS TG API for .NET, which was later included in CICS TG V8.0. This version of the API allows .NET applications to call COMMAREA-based CICS programs and remains useful if you are using CICS TG V7.2 or developing applications that target version 2 of the .NET Framework.
CA72: CICS TG: Developing .NET components for CICS connectivity
The original .NET SupportPac was CA72: CICS TG: Developing .NET components for CICS connectivity in which I describe how to create a .NET wrapper around the CICS TG ECI V1 API for C. Such a wrapper allows .NET applications to call COMMAREA-based CICS programs when CICS TG is installed on the same machine and you are using the TCP/IP or SNA protocols to communicate with CICS. The SupportPac also includes full source code for the wrapper and despite its age it remains a useful guide to developing your own APIs.
Below is a summary of the 6 SupportPacs I've just described:
|SupportPac||CICS TG version||Application environment||Application platform|
|CA5F||CICS TG V8.0, V8.1 or V9.0||Java and JCA, 32-bit and 64-bit||Windows, Linux, AIX, Solaris, HP-UX, z/OS|
|CA0B||CICS TG V8.0 or V8.1||C and C++, 64-bit||AIX|
|CA76||CICS TG V9.0||.NET, 32-bit and 64-bit||Windows|
|CA75||CICS TG V8.0||.NET, 32-bit||Windows|
|CA73||CICS TG V7.2||.NET, 32-bit||Windows|
|CA72||Any CICS TG, Windows only||.NET, 32-bit||Windows|
Further resources for application developers using CICS Transaction Gateway: