Upgrading from Version 8 Release 0

This information details changes that you need to consider when upgrading to the current release from V8.0.

Java Version 7

Ensure the PATH environment variable in the STDENV file used during CICS TG initialization contains the location of the IBM® Java™ 7 runtime environment.

Removal of Gateway daemon resource parameters

The uowvalidation parameter is longer supported. This means that LUWs tokens are validated so that they can be used only from the client application connection from which the LUW was started.

If the uowvalidation parameter is specified in the configuration file, the Gateway daemon fails to start. You must remove the uowvalidation parameter from the configuration file

If any of your applications rely on the uowvalidation parameter being turned off, the application receives the ECI_ERR_LUW_TOKEN error when trying to use the LUW token on a connection, to the Gateway daemon, that did not start the LUW.

Removal of ciphersuites=128bitonly parameter

Use of the ciphersuites=128bitonly parameter is deprecated.

SSL keyring settings moved

The SSL key ring settings are now product wide; they have been moved from the SSL protocol handler in the GATEWAY section to the PRODUCT section of the configuration file. The same SSL key ring settings are used for both SSL protocol handler and IPIC server SSL connection definitions. The SSL key ring parameters must be defined in the PRODUCT section in order to use IPIC over SSL. The definition of the SSL key ring parameters in the GATEWAY section is supported, if not using IPIC over SSL, for migration purposes. The SSL key ring settings are: esmkeyring, hwcrypt, keyring, keyringpw, and keyringpwscrambled. The esmkeyring and hwcrypt parameters now take a parameter value when defined in the PRODUCT section.

TLS cipher suites

Cipher suites entered as TLS are no longer converted to SSL when CICS Transaction Gateway starts

Removal of -noshareclasses option

The undocumented -noshareclasses option has been removed. If it is specified, the Gateway daemon fails to start and the following message is written to STDERR:

CTG6582E The command line option -noshareclasses is unknown or requires a value

If there is a requirement to disable Java class caching, the documented Java argument -Xshareclasses:none can be used.

Using the JEE interfaces in nonmanaged mode

The JAR file cicsj2ee.jar file is renamed to cicsjee.jar.

Supported characters in server names

Server names must now use characters from the supported character list to ensure that all CICS® TG functions work correctly. Existing configuration files containing server names using unsupported characters can continue to be used as an aid to migration but might not work in all scenarios. Configuration files containing server names that use unsupported characters should be migrated as soon as possible.

For the list of supported characters, see the relevant page on configuring the server name for the required protocol in Configuring CICS server connections.

IPIC server idle timeout default setting

The default setting of the server idle timeout period for IPIC server connections has been changed to zero, so that the idle timeout period is disabled. Previously, IPIC server connections would be closed if idle for more than 60 minutes. This change affects local mode topologies, and also remote mode topologies which do not configure an IPIC server idle timeout.

Message_Qualifier API removal

The deprecated field Message_Qualifier has been removed from the Java API. Applications that used this field will need to use the getMessageQualifier() and setMessageQualifier() methods instead.


Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tgzos_latest/help/topic/com.ibm.cics.tg.zos.doc//ctgzos/cclaimig81.html