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.
- 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.
- 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
| 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
| 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
| 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 |
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
|
PH55369 | PH55370 | BASE | BASE |
All other continuous delivery features
| 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:
|
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.
| 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 |