Release Notes®

These release notes provide information about IBM® z/OS® Connect.

This product contains the following versioned components:

Component	Version
IBM z/OS Connect server	3.0.80
z/OS Connect Designer	3.0.80
z/OS Connect Operator	1.0.8
IBM z/OS Connect API provider Gradle plug-in	1.4.3
IBM z/OS Connect API requester Gradle plug-in	1.1.4

What's new

The Open Container Initiative (OCI) compliant z/OS Connect Designer image.
The OCI-compliant IBM z/OS Connect server image.
The OpenAPI 3 feature in the IBM z/OS Connect native z/OS server.
The IBM z/OS Connect API requester Gradle plug-in feature in the IBM z/OS Connect native z/OS server.
The IBM z/OS Connect API provider Gradle plug-in feature.

Read more in the z/OS Connect enhancements announcement.

Known issues and limitations

IBM z/OS Container Platform restriction

There is a known issue with the use of AsyncIO and IBM z/OS Connect running in a container on z/OS. If you have an angel process started which provides access to the AsyncIO feature that your IBM z/OS Connect container connects to, you need to replace the bootstrap.properties in your z/OS Connect API image with the following.

org.osgi.framework.system.packages.extra=com.ibm.zos.smf,com.ibm.jzos,com.ibm.jzos.fields,com.ibm.os390.security
org.osgi.framework.command.execpermission=/bin/chmod 0550 ${abspath}
com.ibm.ws.tcpchannel.useZosAio=false

This can be done by creating a bootstrap.properties file in your z/OS Connect API project directory and adding the following line to the Dockerfile.

COPY --chmod=755 bootstrap.properties /config/bootstrap.properties

Ensure that the Dockerfile is tagged ISO8859-1 by running the following command before running the Build a z/OS Connect API image step of the Installing and uninstalling an IBM z/OS Connect server image with Podman procedure.

chtag -tc ISO8859-1 bootstrap.properties

OpenAPI 3 support for API provider

z/OS Connect Designer supports most OpenAPI features, but the following features are not currently supported:

Response range definitions 1XX, 2XX, 3XX, 4XX, and 5XX as described here: https://swagger.io/docs/specification/describing-responses/.
OpenAPI documents containing response ranges cannot be imported by using z/OS Connect Designer.
Operation definitions for HEAD and TRACE HTTP methods.
OpenAPI documents containing such operations can be imported by using z/OS Connect Designer. HEAD and TRACE operations are ignored.
Remote or URL references as described here: https://swagger.io/docs/specification/using-ref/.
OpenAPI documents containing references to external definitions cannot be imported by using z/OS Connect Designer.
When mapping array items, only the immediate parent array fields are available for mapping.

JSONata

The following functions are not implemented:

From https://docs.jsonata.org/path-operators:
- ^(...) (Order-by)
From https://docs.jsonata.org/other-operators:
- ... ~> | ... | ...| (Transform)
From https://docs.jsonata.org/numeric-functions:
- $formatInteger()
- $parseInteger()
From https://docs.jsonata.org/string-functions,
- These functions recognize patterns only as strings "xxx", not delimited with slashes /xxx/.

Java

The IBM_JAVA_ZOS_TDUMP JAVA environment variable is deprecated with Java V8.