Contact Free trial Login

IBM CICS Transaction Gateway Connector Release Notes - Mule 3

Support Category: Premium

The IBM CICS Transaction Gateway (IBM CTG) connector provides integration with backend CICS applications using the CICS Transaction Gateway. For Java platforms, CTG implements the JCA resource adapter to connect Java applications to the CICS system. The connector connects Mule applications and the CTG.

1.2.0

June 6, 2019

Compatibility

Software Version

Mule Runtime

3.7, 3.8, 3.9

IBM CICS TG (for Multiplatforms and for z/OS)

9.1 and 9.2

IBM CICS TG SDK

9.1 and 9.2

  • The remote CICS Transaction Gateway must be at the same release level or later than the version of the JCA resource adapter.

  • The JCA resource adapter must match the CICS TG platform. For example, if you have CICS TG for Multiplatforms, you cannot connect with, to, or from a CICS TG that uses the z/OS resource adapter.

The following required JAR files are needed to set up the connector configuration:

  • ccf2.jar (CICS Common Connector Framework)

  • cicsjee.jar (CICS JEE)

  • ctgclient.jar (CTG Client Library)

  • ctgserver.jar (CTG Server Library)

  • geronimo-j2ee-connector_1.6_spec-1.0.jar (JCA 1.6 specification)

    Note: The required JCA 1.6 library overcomes conflicts with JCA 1.5 which is shipped with the Mule runtime.

Features

The Response Time is now configurable. This field is located under Additional Settings in the connector configuration file.

Known Issues

  • Although the inclusion of JCA 1.6 as a required library that is meant to solve compatibility conflicts with the JCA 1.5 (shipped with the Mule runtime), it is currently unknown if this causes side effects.

1.1.4

May 13, 2019

Compatibility

Software Version

Mule Runtime

3.7 and later

IBM CICS TG (for Multiplatforms and for z/OS)

9.1 and 9.2

IBM CICS TG SDK

9.1 and 9.2

  • The remote CICS Transaction Gateway must be at the same release level or later than the version of the JCA resource adapter.

  • The JCA resource adapter must match the CICS TG platform. For example, if you have CICS TG for Multiplatforms, you cannot connect with, to, or from a CICS TG that uses the z/OS resource adapter.

The following required JAR files are needed to set up the connector configuration:

  • ccf2.jar (CICS Common Connector Framework)

  • cicsjee.jar (CICS JEE)

  • ctgclient.jar (CTG Client Library)

  • ctgserver.jar (CTG Server Library)

  • geronimo-j2ee-connector_1.6_spec-1.0.jar (JCA 1.6 specification)

    Note: The required JCA 1.6 library overcomes conflicts with JCA 1.5 which is shipped with the Mule runtime.

Features

  • The Response Time change from version 1.1.1 was reverted. This version is essentially the same as 1.1.0.

Known Issues

  • Although the inclusion of JCA 1.6 as a required library is meant to solve compatibility conflicts with the JCA 1.5 (shipped with the Mule runtime), it is currently unknown if this causes side effects.

1.1.1

May 9, 2019

Compatibility

Software Version

Mule Runtime

3.7 and later

IBM CICS TG (for Multiplatforms and for z/OS)

9.1 and 9.2

IBM CICS TG SDK

9.1 and 9.2

  • The remote CICS TG must be at the same release level or a higher than the version of the JCA resource adapter.

  • The JCA resource adapter must match the CICS TG platform. For example, if you have CICS TG for Multiplatforms, you cannot connect with it, to or from a CICS TG for z/OS resource adapter.

The following required JAR files are needed to set up the connector configuration:

  • ccf2.jar (CICS Common Connector Framework)

  • cicsjee.jar (CICS JEE)

  • ctgclient.jar (CTG Client Library)

  • ctgserver.jar (CTG Server Library)

  • geronimo-j2ee-connector_1.6_spec-1.0.jar (JCA 1.6 specification)

    Note: The required JCA 1.6 library overcomes conflicts with JCA 1.5 which is shipped with the Mule runtime.

Features

  • The Response Time is now configurable. This field is located under Additional Settings in the connector configuration file.

Known Issues

  • Although the inclusion of JCA 1.6 as a required library is meant to solve compatibility conflicts with the JCA 1.5 (shipped with the Mule runtime), it is currently unknown if this causes side effects.

1.1.0

April 4, 2018

Compatibility

Software Version

Mule Runtime

3.8 and 3.9

IBM CICS TG (for Multiplatforms and for z/OS)

9.1 and 9.2

IBM CICS TG SDK

9.1 and 9.2

  • The remote CICS TG must be at the same or a higher release level than the version of the JCA resource adapter.

  • The JCA resource adapter must match the CICS TG platform. For example, if you have CICS TG for Multiplatforms, you cannot connect to it from a CICS TG for z/OS resource adapter.

The following are required JAR files to set up the connector configuration:

  • ccf2.jar (CICS Common Connector Framework)

  • cicsjee.jar (CICS JEE)

  • ctgclient.jar (CTG Client Library)

  • ctgserver.jar (CTG Server Library)

  • geronimo-j2ee-connector_1.6_spec-1.0.jar (JCA 1.6 Specification)

    Note: The required JCA 1.6 library overcomes conflicts with JCA 1.5 which is shipped with the Mule runtime.

Features

  • Calls with multiple containers - The connector now allows users to invoke CICS programs using channels with multiple Containers.

Fixed in this Release

  • Transactions not working after first call - Transactions after the first one were not being rollbacked properly in some scenarios. This was fixed and now transactions work as expected.

Known Issues

  • Although the inclusion of JCA 1.6 as a required library is meant to solve compatibility conflicts with the JCA 1.5 shipped with the Mule runtime, it is yet unknown if this causes side effects.

1.0.2

January 19, 2018

Software Version

Mule Runtime

3.8 and 3.9

Java

8

IBM CICS TG (for Multiplatforms and for z/OS)

9.1 and 9.2

IBM CICS TG SDK

9.1 and 9.2

Notes:

  • The remote CICS TG must be at the same or a higher release level than the version of the JCA resource adapter.

  • The JCA resource adapter must match the CICS TG platform. For example, if you have CICS TG for Multiplatforms, you cannot connect to it from a CICS TG with the z/OS resource adapter.

The following JAR files are required to set up a connector configuration:

  • ccf2.jar (CICS Common Connector Framework)

  • cicsjee.jar (CICS JEE)

  • ctgclient.jar (CTG Client Library)

  • ctgserver.jar (CTG Server Library)

  • geronimo-j2ee-connector_1.6_spec-1.0.jar (JCA 1.6 specification)

    Note: The required JCA 1.6 library overcomes conflicts with JCA 1.5 which is shipped with the Mule runtime.

Features

  • Authentication - The connector uses under the hood, the IPIC (IP interconnectivity) protocol to establish communication with CICS regions over TCP/IP. This type of client also supports SSL authentication.

  • Execution of CICS Programs - The connector allows users to invoke CICS programs:

    • Using Channels and Containers.

    • Using a COMMAREA. Data transfers are limited to 32 KB.

  • Transactions - The connector leverages XA transactions by means of Mule’s transactional scope and the Bitronix Transaction Manager components.

  • DataSense - The connector supports adding metadata using through the Custom Metadata Tab option. Using the Copybook feature, a user can import a schema that describes the data structure going in and out of CTG so as to be used by a DataWeave component.

Fixed in this Release

  • None.

Known Issues

  • Although the inclusion of JCA 1.6 as a required library is meant to solve compatibility conflicts with JCA 1.5 that is shipped with the Mule runtime, it is unknown if this causes side effects.

1.0.0

September 28, 2017

Compatibility

Software

Version

Mule Runtime

3.8 and 3.9

IBM CICS TG (for Multiplatforms and for z/OS)

9.1 and 9.2

IBM CICS TG SDK

9.1 and 9.2

Notes:

  • The remote CICS TG must be at the same or a higher release level as the version of the JCA resource adapter.

  • The JCA resource adapter must match the CICS TG platform. For example, if you have CICS TG for Multiplatforms, you cannot connect to it from a CICS TG for the z/OS resource adapter.

Required JAR files to configure this connector:

  • ccf2.jar (CICS Common Connector Framework)

  • cicsjee.jar (CICS JEE)

  • ctgclient.jar (CTG Client Library)

  • ctgserver.jar (CTG Server Library)

  • geronimo-j2ee-connector_1.6_spec-1.0.jar (JCA 1.6 specification)

    Note: The required JCA 1.6 library overcomes conflicts with JCA 1.5 which is shipped with the Mule runtime.

Features

  • Authentication - The connector uses the IPIC (IP interconnectivity) protocol to establish communication with CICS regions over TCP/IP. This type of connection also supports SSL authentication.

  • Execution of CICS Programs - The connector allows users to invoke CICS programs:

    • Using Channels and Containers.

    • Using a COMMAREA. Data transfers are limited to 32 KB.

  • Transactions - The connector leverages XA transactions by means of Mule’s transactional scope and the Bitronix Transaction Manager components.

  • DataSense - The connector supports adding metadata using through the Custom Metadata Tab option. Using the copybook feature, you can import a schema that describes the data structure going in and out of CTG for use with DataWeave.

Fixed in this Release

  • None.

Known Issues

  • Although the inclusion of JCA 1.6 as a required library is meant to solve compatibility conflicts with the JCA 1.5 shipped with the Mule Runtime, it is yet unknown if this causes side effects.

Was this article helpful?

💙 Thanks for your feedback!

Edit on GitHub