We’ve just released the latest z/OS Connect EE open beta. There are some important changes to the open beta which you should be aware of.
- Using a server from a previous release of the z/OS Connect EE open beta
- JWT support for API requester
- IBM MQ service provider
- IMS Database service provider
- More information about API requester security in the IBM Knowledge Center
- Open beta code available for up to 120 days
- Open beta version of the API toolkit
- Open beta build and expiry dates
- WebSphere Liberty Profile 18.104.22.168
- Angel V11
- Useful links
- Feedback please!
Using a server from a previous release of the z/OS Connect EE open beta
If you are using a server from a previous release of the z/OS Connect EE open beta, the first time you start your server with this release of the open beta, you will need to specify the
--clean option on your started task PARMS statement, for example:
/S BAQSTRT,PARMS=' serverName --clean'. This is to delete all persistent cached information and pick up updated OSGi bundles shipped in this release.
Find out more about the
If you fail to specify the
--clean option your server may not function correctly and you may see the following errors in your messages.log, STDERR, and FFDC:
[ERROR ] CWWKF0002E: A bundle could not be found for com.fasterxml.jackson.core.jackson-annotations/2.9.5.
[ERROR ] CWWKF0002E: A bundle could not be found for com.fasterxml.jackson.core.jackson-databind/2.9.5.
[ERROR ] CWWKF0002E: A bundle could not be found for org.yaml.snakeyaml/1.11.0.
[ERROR ] CWWKF0002E: A bundle could not be found for com.fasterxml.jackson.dataformat.jackson-dataformat-yaml/2.9.5.
[ERROR ] CWWKF0002E: A bundle could not be found for com.fasterxml.jackson.core.jackson-core/2.9.5.
Subsequent starts of the server do not require the
JWT support for API requester
z/OS Connect EE API requester JWT support can now be used when a CICS, IMS, or z/OS application calls a RESTful API that requires a JWT. On behalf of the CICS, IMS or z/OS application, z/OS Connect EE acts as a client to request a JWT from an authentication server and access the API with the JWT.
Furthermore, z/OS Connect EE API requester also provides the capability that allows a CICS, IMS or z/OS application to call a RESTful API that is secured by using both JWT and OAuth 2.0, where JWT is used to authenticate a client, and OAuth 2.0 is used to authorize the client to access the API.
IBM MQ service provider
The IBM MQ service provider is now built into the z/OS Connect EE server, so you do not need to copy it from an IBM MQ installation. The new IBM MQ service provider adds support for generating service archive files with the Build Toolkit. The resulting .sar files can then be deployed directly to the z/OS Connect EE server. APIs can then be created in the API toolkit to call these services.
A Quick Start Scenario has been created to enable you to quickly configure an end-to-end solution using the new MQ service provider.
IMS Database service provider
With the IMS Database service provider, you can create services which query IMSâ„˘ databases by using SQL statements. Using the open beta API toolkit, you can create an IMS database service by specifying database connection information and an SQL query. You can then deploy the service, and create APIs to test it, all from within the API toolkit.
In this release of the open beta you can create and test a database service.
The open beta API toolkit has been enhanced with the following features:
- You can create an IMS database service with a SQL query and a database connection profile. The following must be prepared prior to using the API toolkit to create the IMS database service:
- The SQL SELECT query must be prepared and tested.
- The database connection profile must be prepared in the defined XML format. A database connection profile template is provided.
- The service editor allows renaming, including, excluding, and setting default values for request and response fields.
- IMS database services can be deployed to a z/OS Connect EE server for testing from within the API Toolkit.
In this beta, only access to IMS databases through SQL SELECT queries are supported. SQL INSERT, UPDATE, and DELETE commands are not supported.
IBM does not warrant that any version of the program that is formally released or made commercially available (if any) will be similar to, or compatible with, early release versions. Please let us know what you think about the IMS Database service provider, we value your feedback!
More information about API requester security in the IBM Knowledge Center
The Security section of the IBM Knowledge Centre has been enhanced for API requesters to provide more information about the security methods supported by z/OS Connect EE. The new content provides more conceptual information that will help you to choose the most suitable configuration for your installation.
Open beta code available for up to 120 days
This version of the open beta is available for up to 120 days. We hope this will allow time for you to evaluate the new features offered through our beta and to provide us feedback on what you do and don’t like with these features. Please use the z/OS Connect EE open beta forum to provide your feedback.
Open beta version of the API toolkit
We now provide a matching open beta version of the API toolkit to accompany the open beta z/OS Connect EE runtime. This open beta version of the toolkit will currently only run on Windows. 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 example, to try out the IMS Database service provider, you must use this open beta version of both the API toolkit and z/OS Connect EE runtime.
Open beta build and expiry dates
The build date for this version of the z/OS Connect EE open beta runtime is 20190605-1250 and appears on the BAQR0000I message.
This version of the z/OS Connect EE open beta is due to expire on 3 October 2019 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.
WebSphere Liberty Profile 22.214.171.124
The version of WebSphere Liberty Profile embedded in this open beta is version 126.96.36.199. 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 logfile.
The version of the angel shipped with WebSphere Liberty Profile V188.8.131.52 is version 11.
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 up 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.
While we hope you enjoy these new features, do understand that features delivered in the open beta are not always delivered in the GA product. Please provide feedback on these new features using the z/OS Connect EE open beta forum as 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!