The versions shown for the API toolkit (OpenAPI 2), z/OS Connect Designer (OpenAPI 3) and z/OS Connect Server (OpenAPI 3) are those available when this blog post was last updated and may be superseded by newer versions. To check if a minimum version is required for a particular OpenAPI capability , refer to the IBM z/OS Connect Documentation.
For more details on the changes, please follow the links provided or look to our change history in the IBM z/OS Connect Documentation.
| Version |
Features |
Liberty Version |
OpenAPI2 - API toolkit /
Standalone Build toolkit |
OpenAPI3 - API plug-ins, Designer / Server image / native server |
|
|
|
23.0.0.12
|
|
- Designer (s390x and amd64)
- Server image (s390x and amd64)
- IBM z/OS Connect Operator - v1.0.7
- IBM z/OS Connect CASE package bundle - V1.0.8
- API provider Gradle plug-in - V1.4.2
- API requester Gradle plug-in - V1.1.3
- An OCI compliant Container Platform - for example, Red Hat® OpenShift® V4.9 or later
|
|
|
-
Support is provided for the PL/I programming language for API requester CICS TS and z/OS applications, along with API provider API First. For more information about using PL/I support for API requester, see Linking by dynamic calls.
-
The IMS mobile related templates (available with z/OS Connect (OpenAPI 2) have been updated to contain the configuration examples that were previously in the ims-services.xml, ims-interactions.xml and ims-connections.xmlfiles.
-
APAR fixes.
|
23.0.0.12
|
|
- Designer (s390x and amd64)
- Server image (s390x and amd64)
- IBM z/OS Connect Operator - v1.0.7
- IBM z/OS Connect CASE package bundle - V1.0.8
- API provider Gradle plug-in - V1.4.1
- API requester Gradle plug-in - V1.1.2
- An OCI compliant Container Platform - for example, Red Hat® OpenShift® V4.9 or later
|
|
|
-
The version of the API requester Gradle plug-in is upgraded to V1.1.1.
-
The IBM z/OS Connect build toolkit (zconbt) is updated to V1.17.
-
The z/OS Connect documentation has been updated to include an OpenAPI 3 artifact compatibility table. For more information, see OpenAPI 3.0 artifact compatibility.
-
The z/OS Connect documentation has been updated to include details about the IBM Documentation search feature. For more information, see Using the IBM Documentation search feature.
-
APAR fixes.
|
23.0.0.9
|
|
- Designer (s390x and amd64)
- Server image (s390x and amd64)
- IBM z/OS Connect Operator - v1.0.7
- IBM z/OS Connect CASE package bundle - V1.0.8
- API provider Gradle plug-in - V1.4.0
- API requester Gradle plug-in - V1.1.1
- An OCI compliant Container Platform - for example, Red Hat® OpenShift® V4.9 or later.
|
|
|
-
From today, z/OS Connect API requester data is now available in OpenAPI 3 native servers, using the z/OS Connect OpenAPI 2 interceptor interfaces. This means you can now monitor z/OS Connect OpenAPI 3 requests in real time, with the exception that early failure data is not available. You can use the monitoring tools that you are currently using for z/OS Connect OpenAPI 2 monitoring. For more information, see Using a real-time monitoring product.
-
Additionally, the audit interceptor can be configured in z/OS Connect OpenAPI 3 native servers to capture SMF 123 subtype 2 V2 records for API requester. This allows you to harness a variety of analysis tools to interpret the information for tracking, audit, or billing purposes. For more information, see Using SMF records to monitor requests.
-
Additional server templates to create z/OS Connect servers to run the completed API provider tutorials. For more information about the server templates, see Supplied server templates.
|
23.0.0.9
|
|
- Designer (s390x and amd64)
- Server image (s390x and amd64)
- IBM z/OS Connect Operator - v1.0.7
- IBM z/OS Connect CASE package bundle - V1.0.8
- API provider Gradle plug-in - V1.4.0
- API requester Gradle plug-in - V1.1.0
- An OCI compliant Container Platform - for example, Red Hat® OpenShift® V4.9 or later
|
|
3.0.75
PH57677
21 Nov 2023
|
|
23.0.0.9
|
|
- Designer (s390x and amd64)
- Server image (s390x and amd64)
- IBM z/OS Connect Operator - v1.0.7
- IBM z/OS Connect CASE package bundle - V1.0.8
- API provider Gradle plug-in - V1.3.0
- API requester Gradle plug-in - V1.0.6
- An OCI compliant Container Platform - for example, Red Hat® OpenShift® V4.9 or later.
|
|
3.0.74
PH56974
25 Oct 2023
|
-
OpenAPI 2 interceptor interfaces for API provider are now available in OpenAPI 3 native servers. For more information, see Using a real-time monitoring or transaction tracking product.
-
The audit interceptor in the z/OS Connect native server can now be configured to capture SMF 123 subtype 1 V2 records for API provider. For more information, see Using SMF records to monitor requests.
-
Updates and new content in the install (build & deploy) topics for the IBM z/OS Connect server image. This section now includes planning, installing (online & offline), upgrading (online & offline), uninstalling, and details the custom resource definitions (CRDs) used by IBM z/OS Connect in a container environment. For more information, see IBM z/OS Connect server image.
-
APAR fixes.
|
23.0.0.6
|
|
- Designer (s390x and amd64)
- Server image (s390x and amd64)
- IBM z/OS Connect Operator - v1.0.7
- IBM z/OS Connect CASE package bundle - V1.0.8
- API provider Gradle plug-in - V1.3.0
- API requester Gradle plug-in - V1.0.5
- An OCI compliant Container Platform - for example, Red Hat® OpenShift® V4.9 or later
|
WebSphere Liberty Profile V23.0.0.12
The version of WebSphere Liberty Profile that is embedded in z/OS Connect V3.0.78 is V23.0.0.12. Find out more from the Liberty documentation.
Angel V21
The version of the Angel shipped with WebSphere Liberty Profile V23.0.0.12 is version 21. If you choose not to update to this level of the Liberty Angel, then the following warning message will appear in your messages.log file:
|
CWWKB0127W: The current angel version is earlier than the version that the server expects. Update the angel version to the latest available version.
|
Find out more.
API toolkit versions (for OpenAPI 2 support)
The latest version of the z/OS Connect API toolkit plug-in to design and create your services and APIs is V3.3.0.4 for Aqua 3.3 users and V3.2.9.14 for Aqua 3.2 users. You should obtain the latest version of the API toolkit from the Aqua download site for your version of Aqua as it includes all the latest features and fixes.
If you unzip the API toolkit zip file on Windows, due to the long filenames of some of the file members, you should use a tool such as 7-Zip or the "jar -x" command. Do not use winzip, winrar, or the Windows own zip extraction tool, as warnings/errors will occur during the unzip and the API toolkit will be unusable. Find out more.
Announcement
Support for Aqua 3.1 ceased on 24th April 2023. For more information, see End of Support Announcement for Aqua 3.1. Users are encouraged to move to the latest Aqua 3.3 platform which is built on Eclipse V4.23 and Java 11.
z/OS Connect Designer (for OpenAPI 3 support)
Available on s390x and amd64 architecture with an OCI-compliant container platform of your choice. For example, Podman, Docker Desktop V19.0.3 or later (or alternative open containers tooling), Red Hat® OpenShift® V4.9 or later.
Designer is a containerized, web-based intuitive interface providing a low-code approach to developing OpenAPI3 specification APIs. Powerful data mapping using JSONATA gives users flexibility to create both basic and complex mappings. All of this is shipped with an embedded server for lifecycle testing of the API. Find out more.
z/OS Connect API requester Gradle plug-in (for OpenAPI 3 support)
Available with the z/OS Connect native server.
Generate and deploy z/OS Connect API requesters to your z/OS Connect native server with the new IBM z/OS Connect API requester Gradle plug-in. For more information, see Calling RESTful APIs from CICS applications.
z/OS Connect API provider Gradle plug-in (for OpenAPI 3 support)
You can develop APIs starting with an OpenAPI 3.0 definition and use the IBM® z/OS® Connect API provider Gradle plug-in to generate the API provider project files and the language copybooks that are required to implement the API.
From IBM z/OS Connect V3.0.69, the supplied Gradle plug-in can be used to generate a complete API provider project, which can then be built and deployed into z/OS Connect. These APIs are then used to call your CICS® COBOL channel and container applications. For more information, see Developing APIs with Gradle.
z/OS Connect Server image (for OpenAPI 3 support)
Available on s390x and amd64 architecture, an OCI-compliant container platform of your choice. For example, Red Hat OpenShift V4.9 or later.
Delivering containerized API deployments enabling users to adopt a micro-service architecture for their APIs that take advantage of the improved security schemes provided by the OpenAPI 3 specification.
The z/OS Connect Server (OpenAPI 3) V3.0.55 or later is also available as a native server for z/OS V2.4, IBM 64-bit SDK for z/OS. Find out more.
Get started today
Use the links below to find out more, and to get started with V3.0.79 now!
What is z/OS Connect OpenAPI 3?
What is z/OS Connect OpenAPI 2?
Download z/OS Connect V3.0.79 now