We’ve just released the latest z/OS Connect EE open beta. We have added support for greater than 32K length string fields, and looking for your feedback on the JWT support for API requester, and IMS Database service provider features.

Greater than 32K length string fields now supported for API requester

For API requester, support for greater than 32K length string fields is now available in the z/OS Connect EE open beta. Two new build toolkit properties, characterVarying and characterVaryingLimit, control how variable-length character data is mapped to a language structure. Together with defaultCharacterMaxLength, these properties allow strings with a maximum length of 16777214 to be mapped as fixed-length strings, null-terminated strings, or as two related elements: data-length and data.

Find out more.

JWT support for API requester

This feature has been available in earlier versions of the open beta. We value your feedback.

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.

Find out more.

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.

Find out more.

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!

Find out more.

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 V3.9.6.5. 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 20190701-1005 and appears on the BAQR0000I message.

This version of the z/OS Connect EE open beta is due to expire on 29 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.

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 --clean option.

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 --clean option.

WebSphere Liberty Profile 19.0.0.3

The version of WebSphere Liberty Profile embedded in this open beta is version 19.0.0.3. 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.

Angel V11

The version of the angel shipped with WebSphere Liberty Profile V19.0.0.3 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.

Feedback please!

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!


What’s in this release?

Download the open beta now

Join The Discussion

Your email address will not be published. Required fields are marked *