Updating the z/OS Connect Java runtime version

Considerations when updating the z/OS® Connect Java runtime.

  • zosConnect-2.0 If you have specified a custom CCSID for a CICS® service, the configuration must be updated. For more information about how to specify a custom CCSID when you create a CICS service, see How to specify a custom CCSID for a CICS service.
  • If you have specified the enabledCiphers attribute on an ssl element in the server configuration files, the cipher names must be updated to specify names that are valid for your chosen version of Java™. To see a list of supported ciphers, enable SSL trace by setting the following Java property, and make a request.
    -Djavax.net.debug=ssl,handshake,verbose

For documentation about IBM® Semeru Runtime Open Edition and supplemental information, see A launch icon to indicate a link opens a new tab or window. Java SDK documentation.

Updating Java 8 to Java 11 or later

These changes are required when updating from Java 8 to Java 11 or later.
  • Ensure that you use at least the minimum supported service refresh level of Java 11 or later. For more information, see IBM z/OS Connect system requirements.
  • For IBM Semeru Runtime Certified Edition for z/OS version 11 or later, the OpenJDK implementation of charsets is used. As a result, some character set mappings are different for double-byte character string (DBCS) encoding. Test the responses to make sure the application continues to handle the mappings.