Upgrading between releases with CICS continuous delivery

CICS® continuous delivery provides new functions, capabilities, and technologies between product releases through the service channel or as separate downloads. To take advantage of such additional functions, apply the service APARs (rather than upgrading the release level).

Maintenance to WebSphere® Application Server Liberty is delivered through fix packs periodically. For your convenience, Table 7 lists service APARs that CICS has released to bring its embedded Liberty JVM server to the latest WebSphere Application Server Liberty fix pack level.

Upgrade actions

You can choose to deploy the function on specific CICS regions or across CICSplexes. You can also implement the function on lower-level CICS systems, if supported. Some features are further controlled by the selective use of feature toggles.

  1. Decide which features to apply.

    Use the following tables to plan for additions of function to your CICS environment. A brief introduction is included for some features.

    Note: Features are listed in chronological order, with the most recent additions at the bottom.
    • For Java, OSGi, and Liberty, Table 1 shows additions of CICS Liberty features through continuous delivery, and Table 2 lists all other features.
    • Table 3 lists continuous delivery features for CICS web services.
    • Table 4 lists continuous delivery features for CICS policies.
    • Table 5 lists continuous delivery features related to security.
    • Table 6 lists all other CICS continuous delivery features.

    To learn more about any of the continuous delivery features, see the What's new information for your CICS release, or click the link provided with the APAR to view the APAR details in the IBM Support Portal. See Table 1 in Planning to upgrade for links to the What's new information for supported releases of CICS TS.

  2. If any of the features are managed by feature toggles, decide which ones to enable. See Specifying feature toggles.

Features for Java, OSGi, and Liberty

CICS Liberty features

Table 1 shows, by release, additions of CICS Liberty features through continuous delivery. Some Liberty features are made available to in-service CICS releases with CICS APARs that bring CICS-embedded Liberty JVM server to the latest WebSphere Application Server Liberty fix pack level.

Table 1. Continuous delivery for Liberty features, by release of CICS Transaction Server for z/OS
CICS Liberty feature 5.6 6.1 6.2 6.3
  • microProfile-6.0
  • microProfile-6.1
Not applicable BASE BASE BASE

To view the complete list of CICS Liberty features that are supported by your CICS release, follow these links:

Other features
Table 2. Other continuous delivery features for Java, OSGi, and Liberty, by release of CICS Transaction Server for z/OS
Feature 5.6 6.1 6.2 6.3
<applicationManager autoExpand="true"/> is applied as a default Liberty configuration setting but is not visible in server.xml.

This setting causes application file archives to be automatically expanded into the ${server.config.dir}/apps directory on first use. This avoids expansion of file archives into the Liberty work area on server startup, reducing zFS file I/O and making more efficient use of the Java shared class cache. If you wish to override this setting and switch it off, then you should place the XML element: <applicationManager autoExpand="false"/> in your server.xml file.

PH28793 REMOVED Not applicable Not applicable

Features for CICS web services

Table 3. Continuous delivery features for CICS web services, by release of CICS Transaction Server for z/OS
Feature 5.6 6.1 6.2 6.3
Enabling multiple client URIMAPs that point to the same endpoint PH44683 BASE BASE BASE

Features for CICS policies

Table 4. Continuous delivery features for CICS policies, by release of CICS Transaction Server for z/OS
Feature 5.6 6.1 6.2 6.3
Ability to specify Transaction ID and User ID conditions for policy task rules PH26145 BASE BASE BASE
New policy task rule type, container storage PH29187 BASE BASE BASE
New policy system rule type, transaction dump threshold PH34348 BASE BASE BASE
New option to set the WLMHEALTH time interval is supported by the Set z/OS WLM health open status system rule action Not applicable PH58295 BASE BASE

Features for CICS security

Table 5. Continuous delivery features for CICS security, by release of CICS Transaction Server for z/OS
Feature 5.6 6.1 6.2 6.3
Options on CHANGE PASSWORD and CHANGE PHRASE reveal more sign-on information

New options CHANGETIME, DAYSLEFT, EXPIRYTIME, INVALIDCOUNT, and LASTUSETIME are added to CHANGE PASSWORD and CHANGE PHRASE commands. These options reveal more sign-on information.

PH59546 PH59547 BASE BASE
Key rings can be shared more easily between regions

You can share a key ring owned by one region user ID with another region by granting that other region authority to use the key ring. As a result, the KEYRING SIT parameter now accepts more formats of key ring names. See KEYRING system initialization parameter.

PH49253 PH49261 BASE BASE
Minimum key size can be set during TLS handshakes for increased key strength

A new feature toggle com.ibm.cics.tls.minimumkeystrength allows you to set a minimum key size for ECC, RSA, DSA, and Diffie-Hellman keys during TLS handshakes to increase your key strength.

PH50175 PH51719 BASE BASE
Ability to use default cipher suite specification file (defaultciphers.xml) for outbound web requests. PH38091 BASE BASE BASE
The default cipher suite specification file (defaultciphers.xml) is extended to apply to URIMAP resources with no ciphers specified. Not applicable PH60212 BASE BASE
HTTP strict transport security (HSTS) is supported

You can now configure a CICS server to use HSTS with a set of com.ibm.cics.web.hsts feature toggles.

PH55369 PH55370 BASE BASE

All other continuous delivery features

Table 6. All other continuous delivery features, by release of CICS Transaction Server for z/OS
Feature 5.6 6.1 6.2 6.3
Enhanced capability for monitoring shared pool TS queue usage

This enhancement makes it easier for you to monitor capacity usage change for shared pool TS queues. When the percentage of entries or elements in use in a pool structure reaches a specified threshold, DFHXQ0422 or DFHXQ0423 is issued. When the percentage of entries or elements in use drops below a threshold, DFHXQ0420 or DFHXQ0421 is issued.

PH28145 BASE BASE BASE
Capability for monitoring auxiliary temporary storage usage

You are now alerted when auxiliary temporary storage data set usage is approaching a high percentage of its capacity so that you have time to free up storage before the auxiliary temporary storage becomes full.

CICS issues message DFHTS1316 when 75% or more of the maximum auxiliary temporary storage is in use, and message DFHTS1317 when storage usage falls below 70% of the maximum auxiliary temporary storage.

PH28145 BASE BASE BASE
Enhanced adapter tracking for CICS Db2® applications

The CICS Db2 attachment facility is enhanced to pass adapter data to Db2. If a CICS task that is accessing Db2 has adapter data in the CICS origin data, the adapter ID is passed as appl-longname and the adapter data is passed as an accounting-string. Db2 writes the data in its SMF accounting records and the data is also available online through the Db2 special registers CURRENT CLIENT_APPLNAME and CURRENT CLIENT_ACCTNG. This capability requires Db2 12 with APAR PH31447 or higher.

PH30252 BASE BASE BASE
Overriding resource definitions

You can provide a consistent approach to the creation of certain resources by applying environment-specific overrides through a resource overrides file. You can override the resource definition for any supported resource type that can be defined by using resource definition online (RDO). You specify the required overrides in a resource overrides file that is loaded during CICS startup. The overrides are applied when CICS resources are installed.

This support is intended for infrequent system-wide changes to tailor the resources for a specific CICS environment.

PH30590 BASE BASE BASE
Messages reporting changes to APPC and IRC log names
To help you diagnose log name mismatches, the following three new messages that report changes to log names are introduced:
  • DFHRM0240
  • DFHRM0241
  • DFHRM0242
PH03691 BASE BASE BASE
Support for passing XID to Db2 PH39766 PH47996 BASE BASE
Improved temporary storage expiry processing APARs PH40863 and PH40409 BASE BASE BASE

CICS APARs for WebSphere Application Server Liberty fix packs

Table 7 shows all the CICS APARs that upgrade the version of Liberty provided with CICS. Only some of these fix packs enable new Liberty features; the others are simply ongoing maintenance. If the fix pack enables new Liberty features in CICS, these features are listed in Table 1.

Complete fixes for WebSphere Application Server Liberty: See IBM Support: Recommended updates for WebSphere Application Server for a complete listing of all the fixes for Liberty with the latest fixes at the top.
Table 7. Fixpacks for WebSphere Application Server Liberty, by release of CICS Transaction Server for z/OS
IBM® WebSphere Liberty fix pack version 5.6 6.1 6.2 6.3
20.0.0.6 PH25960 Not required Not required Not required
20.0.0.9 PH28793 Not required Not required Not required
20.0.0.12 PH31589 Not required Not required Not required
21.0.0.3 PH33137 Not required Not required Not required
21.0.0.6 PH37946 Not required Not required Not required
21.0.0.9 PH39936 Not required Not required Not required
21.0.0.12 PH42501 Not required Not required Not required
22.0.0.3 PH44531 Not required Not required Not required
22.0.0.6 PH46518 PH47428 Not required Not required
22.0.0.9 PH49182 PH49195 Not required Not required
22.0.0.12 PH51960 PH51961 Not required Not required
23.0.0.3 PH53674 PH53675 Not required Not required
23.0.0.6 PH55277 PH55280 Not required Not required
23.0.0.9 PH56753 PH56754 Not required Not required
23.0.0.12 PH58435 PH58436 Not required Not required
24.0.0.3 PH60322 PH60323 Not required Not required
24.0.0.6 PH61768 PH61769 PH61769 Not required
24.0.0.9 PH62972 PH62973 PH62973 Not required
24.0.0.12 PH64437 PH64438 PH64438 Not required
25.0.0.3 PH65265 PH65266 PH65266 Not required
25.0.0.6 PH66877 PH66878 PH66878 Not required