IBM CICS Transaction Gateway Connector Release Notes - Mule 4

Support Category: Premium

Anypoint Connector for IBM CICS Transaction Gateway (IBM CTG) 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.

2.3.10

October 8, 2024

What’s New

  • This connector is now compatible with Java 17.

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8, 11, and 17

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

9.1, 9.2 and 9.3

IBM CICS TG SDK

9.1, 9.2 and 9.3

Fixed Issues

Issue Resolution ID

The org.apache.commons:commons-lang3 library is upgraded from version 3.6.0 to 3.17.0 due to library maintenance.

W-15177673

2.3.9

June 23, 2022

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8 and 11

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

9.1 and 9.2

IBM CICS TG SDK

9.1 and 9.2

Fixed Issues

Issue ID

Operations now reconnect after a connection is closed.

W-11015652

2.3.8

March 31, 2022

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8 and 11

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

9.1 and 9.2

IBM CICS TG SDK

9.1 and 9.2

Fixed Issues

Issue ID

Removed the atlantic-commons dependency.

W-10890152

2.3.7

December 28, 2020

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8 and 11

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

9.1 and 9.2

IBM CICS TG SDK

9.1 and 9.2

Fixed Issues

  • Fixed security vulnerabilities. (CONN-7305)

2.3.6

Aug 21, 2020

Compatibility

Software Version

Mule

4.1.1 and later

OpenJDK

8 and 11

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

9.1 and 9.2

IBM CICS TG SDK

9.1 and 9.2

Fixed Issues

Fixed build error in Anypoint Studio. (SE-17178)

2.3.5

May 21, 2020

Compatibility

Software Version

Mule

4.1.1 and later

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

Fixed Issues

Fixed reported security vulnerabilities. (CONN-6152)

2.3.4

November 6, 2019

Compatibility

Software Version

Mule

4.1.1 and later

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

Features

  • You can now log the request and response with IBM CTG. Adding a logger of the class "org.mule.modules.ibmctg.internal.service.CTGServiceImpl" at DEBUG level (in the log4j2.xml file of the Mule App)

Fixed Issues

  • None

2.3.3

October 29, 2019

Compatibility

Software Version

Mule

4.1.1 and later

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

Fixed Issues

  • Username and Password parameters are optional if security is not enabled in the CICS region.

2.3.2

October 7, 2019

Compatibility

Software Version

Mule

4.1.1 and later

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

Fixed Issues

  • Fixed compatibility with Mule 4.2.2.

2.3.1

July 5, 2019

Compatibility

Software Version

Mule

4.0 and later

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

Fixed Issues

  • The connector would sometimes incorrectly assume that the payload was empty for the executeCommArea and executeMultipleChannels operations. (SE-12156)

2.3.0

June 27, 2019

Compatibility

Software Version

Mule

4.0 and later

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

Features

  • Response Time is now configurable. This field is located under Additional Settings in the connector’s configuration. This timeout is the maximum amount of time in milliseconds that a managed connection attempts to wait for a response to a request. A value of 0 represents no timeout. The default is 30000 milliseconds (30 seconds).

Fixed Issues

  • The connector occasionally assumed incorrectly that the input payload was empty. This was fixed so that regardless of the type of InputStream the connector’s operations receive, the connector works correctly. (SE-12156)

2.2.0

May 29, 2019

Compatibility

Software Version

Mule

4.0 and later

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

Features

  • Pooling profile was enabled for connections.

2.1.1

November 29, 2018

Compatibility

Software Version

Mule

4.0 and later

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

Features

  • Added support for Multiple Containers, which are named references to a storage area managed by CICS that can hold any form of application data.

2.0.0

January 19, 2018

IBM CICS Transactions Gateway (IBM CTG) connector is available in Mule 4.0.

Software Version

Mule

4.0 and later

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)

JCA 1.6 is needed as a required library to overcome conflicts with JCA 1.5 shipped with Mule.

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.

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 Mule, it is yet unknown if this causes side effects.