We’ve just released the latest z/OS Connect EE open beta. We have added support for identity assertion for API requesters, and looking for your feedback on the IMS Database service provider feature.
- Identity assertion for API requesters
- IMS Database service provider
- JWT support for API requester
- Enhanced SPI for interceptors for monitoring applications
- Cached connections with IMS when using API requester
- Open beta code available for up to 120 days
- Open beta version of the API toolkit
- Open beta build and expiry dates
- Using a server from a previous release of the z/OS Connect EE open beta
- WebSphere Liberty Profile 188.8.131.52
- Angel V11
- Feedback please!
- Useful links
Identity assertion for API requesters
z/OS Connect EE supports identity assertion for API requesters. With the identity assertion support, you can invoke an API requester from a z/OS application with an identity that is provided in the application context.
IMS Database service provider
This feature has been available in earlier versions of the open beta. We value your feedback.
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!
JWT support for API requester
This feature has been available in earlier versions of the open beta. We continue to value your feedback. However, it has not been shipped in this version of the open beta. Should you wish to continue to use JWT support for API requester, you should remain using your existing version of the z/OS Connect EE open beta.
Enhanced SPI for interceptors for monitoring applications
For customers writing interceptors for monitoring applications, the interface Data in the z/OS Connect EE SPI has been updated to provide system of record information for the REST client and WOLA service providers. In addition, the SAF mapped user identity associated with a request can now be obtained, if one exists.
Cached connections with IMS when using API requester
If you use API requester with IMS, you must add a call in your IMS application to close and clear the cached connection. Failing to do this may lead to memory not being reusable until the IMS process terminates.
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
The open beta version of the API toolkit to accompany the open beta z/OS Connect EE runtime is V184.108.40.206. 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 20190902-1446 and appears on the BAQR0000I message.
This version of the z/OS Connect EE open beta is due to expire on 31 December 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.
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 may 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.
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
WebSphere Liberty Profile 220.127.116.11
The version of WebSphere Liberty Profile embedded in this open beta is version 18.104.22.168. 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 V22.214.171.124 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!