---
schema_version: "1"
id: 995fc5b47ddc4e5237175dae21040adc03bcf50e550bbc77692d28243b6c144a
title: Upgrading and Migrating IBM CTG Connector to Version 3.0
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/ibm-ctg-connector/latest/ibm-ctg-connector-upgrade-migrate.md
canonical_url: https://docs.mulesoft.com/ibm-ctg-connector/latest/ibm-ctg-connector-upgrade-migrate
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 59b81b781a74f4c801481c601ca4c9976b9734d209eb21c18af17dcaa833190c
description: MuleSoft Documentation Site
release: "3.0"
latest: true
---
---
product: IBM CTG Connector
version: 3.0
is-latest-version: true
---

# Upgrading and Migrating IBM CTG Connector to Version 3.0

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Upgrade Anypoint Connector for IBM CICS Transaction Gateway (IBM CTG Connector) to version 3.x.

## Supported Upgrade Paths

<table><colgroup><col> <col></colgroup><thead><tr><th>From Version</th><th>To Version</th></tr></thead><tbody><tr><td><div><div><p>2.x</p></div></div></td><td><div><div><p>3.0.x</p></div></div></td></tr></tbody></table>

## Changes in This Release

This release contains the following changes:

- The IBM CTG connection no longer fails on the first request.

- The `.isPresent()` check is added to the optional data field to prevent potential null pointer
  exceptions.

- The `org.apache.commons:commons-lang3` dependency is upgraded to version 3.18.0 to address
  security vulnerabilities.

## Requirements

Ensure that you meet these requirements before you perform the upgrade:

<table><colgroup><col> <col></colgroup><thead><tr><th>Application/Service</th><th>Version</th></tr></thead><tbody><tr><td><p>Mule</p></td><td><p>4.4.0 and later</p></td></tr></tbody></table>

## Upgrade Prerequisites

Before you perform the upgrade, create a backup of your files, data, and configuration in case you
need to restore to the previous version.

## Upgrade Steps

Follow these steps to perform the upgrade:

1.  In Anypoint Studio, create a Mule project.

2.  In **Mule Palette**, click **Search in Exchange**.

3.  In **Add Dependencies to Project**, enter `ibm ctg` in the search field.

4.  In **Available modules**, select **IBM CTG** and click **Add**.

5.  Click **Finish**.

6.  Verify that the IBM CTG Connector dependency version is 3.0 in the `pom.xml` file in the Mule
    project.

Studio upgrades the connector automatically.

## Post-Upgrade Steps

After you install the latest version of the connector, verify that your error handling is updated to
work with the minor changes in error codes in this version of the connector.

## Verify the Upgrade

After you install the latest version of the connector, follow these steps to verify the upgrade:

1.  In Studio, verify that there are no errors in the **Problems** or **Console** views.

2.  Verify that there are no problems in the project `pom.xml` file.

3.  Test the connection to verify that the operations work.

## Revert the Upgrade

If it is necessary to revert to the previous version of IBM CTG Connector, change the
`mule-ibm-ctg-connector` dependency version in the project’s `pom.xml` file to the previous version.

You must update the project’s `pom.xml` file in Anypoint Studio.

## See Also

- [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)

- [Salesforce Help](https://help.salesforce.com)