We've just released the latest z/OS Connect EE open beta which is available now to download from our recently moved
open beta website.
The following new features are included in this open beta:
Open beta now available for up to 180 days
The z/OS Connect EE open beta cycle duration is extended to 180 days. This change will make it easier for you to evaluate new beta features and offer your feedback on how to improve the open beta experience. We value your feedback!
Enhancement to the IBM MQ service provider
The IBM MQ service provider is enhanced to write the following fields to the Data SPI: TIME_SOR_SENT, TIME_SOR_RECV, SOR_IDENTIFIER, SOR_REFERENCE, and SOR_RESOURCE. This data can be written to SMF 123.1 records and consumed by monitoring interceptors.Find out more.
Enhancement to the RESTful service administration interface
The RESTful service administration interface is updated to version 1.2.0 and adds version information to services for all service providers. This new version also adds connectionRef, transid, transidUsage, and ccsid information for services that use the CICS® service provider.Find out more.
Enhancement to the IMS service provider
The IMS service provider has been enhanced to enable Policy override of the interaction properties imsInteractionTimeout, imsLtermOverrideName, and imsTranExpiration.
Find out more.
Enhancement to policy rules
z/OS Connect EE is enhanced so a policy rule can be configured to perform an action when a specific header is present on an API request, regardless of the value of that header.Find out more.
Bidirectional support
The z/OS Connect EE runtime and API toolkit have been enhanced with the capability to support CICS services which have their data formatted as bidirectional text (BiDi). Configurations for processing and rendering BiDi text are specified with attributes in a zosconnect_bidiConfig element in server.xml.
Find out more.
We encourage you to download this latest refresh, and we welcome your feedback on any features of the open beta.
Useful information about this open beta refresh:
Recent change to Cross-Origin Resource Sharing (CORS)
The API toolkit and JavaScript clients require that CORS is enabled on the z/OS Connect EE server to allow you to connect to and test APIs on that server. Since z/OS Connect EE was released, Liberty support for CORS has been enhanced, allowing more control of the CORS headers used. z/OS Connect EE has been updated to no longer send the CORS headers, and the Liberty-supplied capability must now be used.
To enable API toolkit connections, you must have a cors definition in your server.xml. When you create a server by using one of the server templates supplied with the product, a cors element that enables API toolkit connections, is automatically added to the server.xml configuration file. The following excerpt from the server.xml shows a cors element definition that allows API toolkit connections.
You must ensure that your server.xml includes the following configuration:
<cors id="defaultCORSConfig"
domain="/"
allowedOrigins="*"
allowedMethods="GET, POST, PUT, DELETE, OPTIONS"
allowedHeaders="Origin, Content-Type, Authorization, Cache-Control, Expires, Pragma"
allowCredentials="true"
maxAge="3600" />
You may want to customize this configuration further to, for example, restrict the allowed origins.
If you have JavaScript clients that access z/OS Connect EE resources, you may need to further customize your cors element definition. For example, theallowedHeaders attribute, on the cors element, must specify all headers that you want to be permitted on any request. The CORS access control headers themselves do not need to be listed.
Find out more.
Download website for z/OS Connect EE open beta
Our download website for z/OS Connect EE open beta recently moved to a new location. Therefore, please update any bookmarks you have pointing to the old site.
Open beta build and expiry dates
The build date for this version of the z/OS Connect EE open beta runtime is 20210303-1808 and appears on the BAQR0000I message.
This version of the z/OS Connect EE open beta is available for up to 180 days and due to expire on 30 August 2021 and appears on the BAQR9999I message.
However, do not panic! A newer version of the open beta with additional enhancements will be available to download before this version expires.
Open beta version of the API toolkit
The open beta version of the API toolkit to accompany the open beta z/OS Connect EE runtime is V3.9.9.1. This open beta version of the toolkit currently only runs 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.
You are strongly recommended to use this version of the API toolkit with the open beta z/OS Connect EE runtime to enjoy the full suite of new features available in both the toolkit and runtime, and also to ensure you maintain compatibility.
For bidirectional support, you must use this level of the API toolkit (or later).
WebSphere Liberty Profile 21.0.0.1
The version of WebSphere Liberty Profile embedded in this open beta is version 21.0.0.1.
The version level of the WebSphere Liberty Profile appears in both the top of the z/OS Connect EE messages.log file, and also in the STDOUT log file.
Angel V15
The version of the angel shipped with WebSphere Liberty Profile 21.0.0.1 is version 15.
If you choose to remain at a lower version of the angel, you will see the following warning message in your z/OS Connect EE messages.log file when you start your server:
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.
Java 8 required to run z/OS Connect EE
Java 8 is the only supported level of Java with this version of the open beta. Your z/OS Connect EE server will not start if Java 8 is not used. It will fail with message "CWWKE0042E: The correct Java version is not running. The runtime environment requires Java 8 or higher".
Find out more.
Feedback please!
Note that features delivered in the open beta are not always delivered in the GA product. Please provide feedback on these new features using the API Enablement forum including "z/OS Connect EE open beta" in the title of your post. Your feedback will help influence our decisions.
Get started today
Use the links below to find out more, and to get started with the open beta now!