Changes to externals in this release

CICS® Transaction Server for z/OS®, Version 5 Release 4 changes a number of externals, including commands, transactions, resources, system initialization parameters, messages, trace and user exits.

For a summary of changes across all supported releases, see Changes between releases in the Upgrading information.

Changes to installing

  • All source changes are now made by source replacement. Source updates are no longer made.
  • New optional job, DFHIFTGS, tags the text files in the CICS USSHOME directory with the correct coded character set. The highest expected return code is 0.
  • The DFHALLOC and DFHINST3 jobs have been changed to create the ADFHMOD, SDFHAUTH, and SDFHLOAD data sets as PDSEs. CICS now requires these data sets to be PDSEs.
  • In support for the feature toggle capability, the DFHIHFS0 job has been changed to create an empty featuretoggle.properties file in the dfhconfig directory.
  • MEMLIMIT must be set to 10 GB or greater.
  • Service APAR PH39798: Support for installing maintenance-supplied newest release CICS Type 3 SVC and DFHIRP modules. See Installing newest release CICS Type 3 SVC and DFHIRP modules supplied through maintenance.

Changes to the CICS API

Table 2. Changes to EXEC CICS commands in this release
API This release
CHANGED: New option: NOSUSPEND
FETCH ANY NEW: Used by a parent task to inquire on the status of any completed child task.
FETCH CHILD NEW: Used by a parent task to inquire on the status a specific child task.
FREE CHILD NEW: Used by a parent task to free a specified child token.
REQUEST ENCRYPTPTKT CHANGED:
  • New INVREQ with RESP2 value 257, which indicates that the associated kerberos token originated from a system that does not support message confidentiality.
  • New NOTAUTH with RESP2 value 260, which indicates that the external security manager does not authorize a request to generate a PassTicket for this region.
RUN TRANSID NEW: To initiate a local child transaction that runs asynchronously with the parent transaction.
TRANSFORM DATATOJSON NEW: To convert application data to JSON.
TRANSFORM JSONTODATA NEW: To convert JSON to application data.
VERIFY TOKEN CHANGED: New options OUTTOKEN and OUTTOKENLEN
XCTL CHANGED: New INVREQ with RESP2 value 33 when a public program issues XCTL to another program that is an application entry point. New INVREQ with RESP2 value 34 when a program with an application context issues XCTL to a public program.
CHANGED: New INVREQ with RESP2 value 57, issued when a non-REPLICATOR program attempted to update a VSAM data set that has an AVAILABILITY state of RREPL
LINK (EXCI) CHANGED: New option CHANNEL to support passing a CHANNEL with its set of containers
NEW: EXCI can issue these commands in batch.
CHANGED: The WEB RECEIVE command is enhanced to allow the body of an HTTP server request to be received into 64-bit (above-the-bar) storage. The WEB SEND command is enhanced to allow the body of an HTTP server response to be sent from above-the-bar storage.
Service CHANGED with APAR:
  • APAR PH23078: New NOTAUTH with RESP2 value of 1, indicating one or more required password or password phrase fields are blank.
  • APAR PH31270: New NOTAUTH with RESP2 value of 17, indicating that the USERID is not authorized to use the application.
Table 3. Changes to JCICS API in this release
Class Method This release
AsyncService (interface)
runTransactionId()
getAny()
freeChild()
NEW: to start an asynchronous child task.
NEW: to fetch the results of any completed child task.
NEW: to free a specified child task.
ChildResponse (interface)
getCompletionStatus()
getAbendCode()
getChannel()
NEW: returns the completion status of a child task.
NEW: returns the abend code of a child task.
NEW: returns the channel from a child task.
Future<ChildResponse>
get()
isDone()
NEW: to fetch the results of a completed child task.
NEW: checks if a child task has finished.
Container getDatatype() NEW: to return the data type of a container.

Changes to resource definitions

Table 4. Changes to resource definitions in this release
Resource This release
DB2CONN Service CHANGED (APAR PI98569): A command thread is now used by CICS when CICS attempts to cancel a Db2® thread as part of purge or forcepurge processing of a CICS task.
MQCONN CHANGED: INITQNAME attribute allows use of a symbolic parameter, &APPLID., to identify the APPLID of a CICS region
MQMONITOR NEW: to define MQ monitors such as trigger monitors, MQ bridge monitors, and user-written monitors
PROGRAM CHANGED:
  • The default value of the DATALOCATION attribute is now ANY to reduce the 24-bit storage usage for better CICS system resilience
  • Attribute JVMCLASS changed to support invoking a calling applications in a Liberty JVM server
TRANSACTION CHANGED:
  • RUNAWAY attribute accepts a new, lower limit of 250.
  • The default value of SPURGE and TPURGE is changed to YES.
  • The default value of TASKDATALOC is changed to ANY.
URIMAP Service CHANGED (APAR PH44683): Added support for enabling multiple client URIMAPs that point to the same endpoint (that is, the same host, port and path) in a CICS region.
MQINI(DFHMQINI) DEPRECATED: Replaced with MQMONITOR(DFHQMINI).
Table 5. Changes to CICS resource definition groups in CICS TS 5.4
Group This release
DFH$EXCI CHANGED: New program DFH$AXNS
DFH$NACT CHANGED: File ACCTNAM now specifies RECORDSIZE(80) and KEYLENGTH(18).
DFHCOMPI NEW
DFHEDF CHANGED:
  • New TRANCLASS definition DFHEDFTO
  • New transactions: CEDG and CEDY
DFHEP CHANGED:
  • New program DFHECEAQ
  • New transaction CEPR
DFHLE NEW
DFHPGAIP CHANGED: The default program for program autoinstall DFHPGAPG is changed from DATALOCATION(BELOW) to DATALOCATION(ANY).
DFHWEB CHANGED:
  • Program removed: DFHWBC00
  • Program DFHWBUN now specifies CONCURRENCY(THREADSAFE).
DFHCOMPI NEW COMPATIBILITY GROUP

Changes to the CICS utilities

Table 6. Changes to CICS-supplied utilities in this release
Utility This release
DFHMNDUP CHANGED: Specifying a 2 digit year on the DATE and JOBDATE control parameters now defines a date in the twenty-first century.
DFHPDxxx CHANGED:
  • Renamed with new release identifier.
  • Formatting of the DFHMQINI CICS MQINI control block has been replaced by formatting the DFHMQMNT CICS MQMONITOR control block.
  • Formatting of an EXCI dump has been enhanced as follows:
    • A PG section is added to format channels and containers control blocks.
    • The KE section is enhanced to format a 64 bit PSW and registers.
    • The LD section lists the new modules added for EXCI channels and containers support.
DFH$MOLS CHANGED: Specifying a 2 digit year on the DATE control parameter now defines a date in the twenty-first century.
DFHSTUP CHANGED: Specifying a 2 digit year on the DATE control parameter now defines a date in the twenty-first century.

NEW: option MQMONITOR on SELECT TYPE and IGNORE TYPE control parameters

Changes to the CICS assistants

Table 7. Changes to the CICS web services assistants, XML assistants, and JSON assistants in this release
Assistant This release
DFHJS2LS CHANGED:
  • New parameter DEFAULT-ARRAY-MAXITEMS
  • New option, HYPHENS-AS-UNDERSCORES, on MAPPING-OVERRIDES
  • New option, FULL, on WIDE-COMP3
  • Support for mapping level 4.1
Service CHANGED (APAR PI86039): Added support for mapping level 4.2.
  • MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.2.
  • New parameters: ADDITIONAL-PROPERTIES-DEFAULT, ADDITIONAL-PROPERTIES-MAX, and ADDITIONAL-PROPERTIES-SIZE.

Service CHANGED (APAR PI88519): Added support for mapping level 4.3. MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.3.

Service CHANGED (APAR PI91555): JSON schema to high-level language mapping now supports oneOf, anyOf, allOf and not keywords.

DFHLS2JS CHANGED: Support for mapping level 4.1

Service CHANGED (APAR PI86039): MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.2.

Service CHANGED (APAR PI88519): Added support for mapping level 4.3. MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.3.

Service CHANGED (APAR PI95139): The TRUNCATE-NULL-ARRAY-VALUES parameter has a new option PACKEDZERO, which instructs the assistant to treat a positive signed packed decimal zero (0x0C), a negative signed packed decimal zero (0x0D), or an unsigned packed decimal zero (0x0F) as empty.

DFHLS2SC CHANGED: Support for mapping level 4.1

Service CHANGED (APAR PI86039): MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.2.

Service CHANGED (APAR PI95139): The TRUNCATE-NULL-ARRAY-VALUES parameter has a new option PACKEDZERO, which instructs the assistant to treat a positive signed packed decimal zero (0x0C), a negative signed packed decimal zero (0x0D), or an unsigned packed decimal zero (0x0F) as empty.

DFHLS2WS CHANGED:
  • New parameters, PORT-NAME, BINDING-NAME, and SERVICE-NAME
  • Support for mapping level 4.1

Service CHANGED (APAR PI86039): MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.2.

Service CHANGED (APAR PI88519): Added support for mapping level 4.3. MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.3.

Service CHANGED (APAR PI95139): The TRUNCATE-NULL-ARRAY-VALUES parameter has a new option PACKEDZERO, which instructs the assistant to treat a positive signed packed decimal zero (0x0C), a negative signed packed decimal zero (0x0D), or an unsigned packed decimal zero (0x0F) as empty.

DFHSC2LS CHANGED:
  • New option, HYPHENS-AS-UNDERSCORES, on MAPPING-OVERRIDES
  • New option, FULL, on WIDE-COMP3
  • Support for mapping level 4.1
Service CHANGED (APAR PI86039): Added support for mapping level 4.2.
  • MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.2.
  • New parameters: ADDITIONAL-PROPERTIES-DEFAULT, ADDITIONAL-PROPERTIES-MAX, and ADDITIONAL-PROPERTIES-SIZE.

Service CHANGED (APAR PI88519): Added support for mapping level 4.3. MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.3.

DFHWS2LS CHANGED:
  • New parameters, PORT-NAME, BINDING-NAME, and SERVICE-NAME
  • New option, FULL, on WIDE-COMP3
  • Support for mapping level 4.1
Service CHANGED (APAR PI86039): Added support for mapping level 4.2.
  • MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.2.
  • New parameters: ADDITIONAL-PROPERTIES-DEFAULT, ADDITIONAL-PROPERTIES-MAX, and ADDITIONAL-PROPERTIES-SIZE.

Service CHANGED (APAR PI88519): Added support for mapping level 4.3. MAPPING-LEVEL and MINIMUM-RUNTIME-LEVEL now accept 4.3.

Changes to messages and codes

Table 8. Changes to messages and codes in this release
New messages Changed messages Removed messages
 
  • DFH5275 is issued as a warning instead of an error. Its severity indicator is changed from E to W.
 
  • DFHAM4900 indicates an attempt to install an obsolete group.
  • DFHAM4962 indicates that an attempt to install an MQ monitor failed because an MQ monitor with the same name is already installed and is in use.
  • DFHAM4963 indicates that an attempt to install an MQ monitor failed because no MQCONN is installed in the CICS system.
  • DFHAM4964 indicates an attempt to install an obsolete group as part of a list.
  • DFHAM4965 indicates that an attempt to install the MQMONITOR resource failed because a value for MONUSERID was not specified.
  • DFHAM4966 indicates that an attempt to install the MQMONITOR resource failed because the current user is not a surrogate of MONUSERID.
  • DFHAM4967 indicates that obsolete LE definitions installed from a CEE group were installed and CICS will terminate.
   
  • DFHAS0001 indicates that an abend occurred.
  • DFHAS0002 indicates that a severe error occurred.
  • DFHAS0004 indicates that a possible loop was detected.
  • DFHAS0100 indicates that the asynchronous services domain initialization started.
  • DFHAS0101 indicates that the asynchronous services domain initialization ended.
   
  • DFHCA4900 indicates an attempt to install an obsolete group.
  • DFHCA4962 indicates that an attempt to install the MQMONITOR resource failed because an MQMONITOR resource with the same name is already installed and is in use.
  • DFHCA4963 indicates that an attempt to install the MQMONITOR resource failed because no MQCONN is installed in the CICS system.
  • DFHCA4964 indicates an attempt to install an obsolete group as part of a list.
  • DFHCA4965 indicates that an attempt to install the MQMONITOR resource failed because a value for MONUSERID was not specified.
  • DFHCA4966 indicates that an attempt to install the MQMONITOR resource failed because the current user is not a surrogate of MONUSERID.
  • DFHCA4967 indicates that obsolete LE definitions installed from a CEE group were installed and CICS will terminate.
   
  • DFHEX0400 indicates that a PUT container request from an EXCI job was rejected because total storage allocated for the channel will exceed 5% of the MEMLIMIT value for the EXCI job.
   
  • Service DFHFC6045 (APAR PI97207) indicates that an invalid interval value was specified for transaction CFCT.
  • Service DFHFC6046 (APAR PI97207) indicates that CICS has detected that a VSAM file that is defined with the LOGREPLICATE attribute was opened.
   
  • DFHH0001 indicates that potential security issues were identified in the access to the CEDA transaction.
  • DFHH0002 indicates that potential security issues were identified in the configuration of the spool.
  • DFHH0003 indicates that potential security issues were identified in the configuration of TDQs that are defined to the internal reader.
  • DFHH0200 indicates that CICS health checker rules cannot run because of error.
  • DFHH0301 indicates that no potential security issues were identified in the configuration of CEDA.
  • DFHH0302 indicates that no potential security issues were identified in the configuration of the spool.
  • DFHH0303 indicates that no potential security issues were identified in the configuration of TDQs that are defined to the internal reader.
   
  • DFHMP2014 indicates an attempt to install a policy scope in a stand-alone bundle that duplicates an existing policy scope for the same operation.
  • DFHMP2015 indicates that an attempt to install a policy scope in a stand-alone bundle failed because the referenced policy is undefined.
  • DFHMP2016 indicates that an attempt to install a policy scope in a stand-alone bundle failed because the policy name that was specified has an invalid length.
  • DFHMP2017 indicates that an attempt to install a policy in a stand-alone bundle failed because it duplicates an existing policy with region scope.
  • Service DFHMP2018 (APAR PI88500) indicates that an invalid name or value was specified for a static data item in a policy rule.
  • DFHMP2020 and DFHMP2021 indicate that an attempt to create a system policy in the BUNDLE resource failed as a result of an invalid predicate.
  • DFHMP2022 indicates that an attempt to create a system policy in the BUNDLE resource failed because the policy was not installed into only a stand-alone CICS region or a CICS platform.
  • DFHMP2023 indicates that an attempt to restrict the scope of a policy that defines system rules by using a policy scope failed.
  • DFHMP3009 indicates that a system rule defined in a policy that is installed in a single region is triggered.
  • DFHMP3010 indicates that a system rule defined in a policy that is installed on a platform is triggered.
  • Service DFHMP0002 (APAR PI92806) is issued for errors that occurred in DFHMPST.
  • DFHMP2004 is no longer used to report BASESCOPE errors.
  • Service DFHMP2006 (APAR PI88500) is issued also if an event name contains invalid characters.
  • Service DFHMP3009 (APAR PI92806) emits application context information for programs or bundles when a program enable status rule, bundle available status rule, or bundle enable status rule is triggered for a program or bundle deployed with a CICS application.
  • Service DFHMP3010 (APAR PI92806) emits application context information for programs or bundles when a program enable status rule, bundle available status rule, or bundle enable status rule is triggered for a program or bundle deployed with a CICS application.
 
  • DFHMP3011 indicates that emission of policy events was suspended because event processing status is STOPPED.
  • DFHMP3012 indicates that emission of policy events was resumed after event processing is restarted.
   
  • Service DFHMQ0126 (APAR PH22136) indicates that a temporary error occurred when a CKTI trigger monitor attempted to issue an MQOPEN of an initiation queue. The trigger monitor will retry in one minute.
  • Service DFHMQ0127 (APAR PH22136) indicates that a temporary error occurred when a CKTI trigger monitor attempted to issue an MQGET from an initiation queue. The trigger monitor will retry in one minute.
  • Service DFHMQ0128 (APAR PH22136) indicates that following a temporary error, a CKTI trigger monitor has resumed normal processing.
  • DFHMQ0370 indicates the maximum number of MQGET calls that an MQMONITOR can issue per second because the region's z/OS WLM health value is less than 100.
  • DFHMQ0371 indicates that there is no longer a restriction on the number of MQGET calls that MQMONITORs can issue per second.
  • DFHMQ0390 indicates that a request to start an MQMONITOR failed.
  • DFHMQ0391 indicates that a request to start the specified MQMONITOR was processed.
  • DFHMQ0392 indicates that a request to stop the specified MQMONITOR was processed.
  • Service DFHMQ0795 (APAR PH15075) indicates that the CICS-MQ bridge has retrieved a message that has been previously marked and the mark browse interval has expired.
  • Service DFHMQ0796 (APAR PH22136) indicates that following a temporary error, a CKBR bridge monitor has resumed normal processing.
   
  • DFHPA1950 indicates an attempt to read a feature toggle file.
  • DFHPA1951 indicates that a feature toggle file was not found during CICS system initialization.
  • DFHPA1952 indicates that a feature toggle file was found but could not be opened during CICS system initialization.
  • DFHPA1953 indicates that a feature toggle file was opened but could not be read during CICS system initialization.
  • DFHPA1954 indicates formatting errors in a feature toggle file.
  • DFHPA1955 indicates that processing of a feature toggle file failed because of insufficient storage.
  • DFHPA1956 indicates that a feature toggle file was not applied during CICS system initialization.
  • DFHPA1957 indicates the feature toggles that will be used in a CICS region.
  • DFHPA1958 indicates that the feature toggle file does not contain any feature toggles.
   
  • Service DFHRM0240 (APAR PH03691) indicates the local log name that is set during CICS initialization and sent to a remote system when CICS establishes an APPC or IRC connection.
  • Service DFHRM0241 (APAR PH03691) indicates a log name that has been set for an APPC or IRC connection.
  • Service DFHRM0242 (APAR PH03691) indicates a log name that has been deleted for an APPC or IRC connection.
   
  • Service DFHSI1591 (APAR PI97207) indicates that an attempt to attach transaction CFCT failed and that CICS is terminated with a dump.
   
  • Service DFHSJ0007 (APAR PH24443) indicates that an unexpected signal has been received by the JVM server.
  • Service DFHSJ0008 (APAR PH24443) indicates that the JVM server has unexpectedly terminated and is now in an unusable state.
  • Service DFHSJ0938 (APAR PH22887) indicates that the JVM server failed to start.
  • DFHSJ1204 indicates that while installing an application in a Liberty JVM server, CICS did not register a linkable service because the same program name as another linkable service was specified.
  • DFHSJ1205 indicates that while installing an application in a Liberty JVM server, CICS did not register a linkable service because the same program name as another linkable service was specified.
  • DFHSJ1206 indicates an attempt to link to an application in a Liberty JVM server failed and provides a reason code.
  • DFHSJ1207 indicates an attempt to link to a program in a Liberty JVM server failed because no linkable service is defined for this program name.
  • DFHSJ1208 indicates that while installing an application in a Liberty JVM server, an existing PROGRAM definition is installed for the program that is not suitable for use with a linkable service, and indicates the reason why.
  • Service DFHSJ1400 (APAR PI92676) indicates that the Liberty JVM server failed to start because no default Liberty angel process is available.
  • Service DFHSJ1007 (APAR PH12280) is updated to reflect changed system action when CICS detects that an abend has left a JVM in an inconsistent state.
  • Service DFHSJ1208 (APAR PI86767) indicates that while installing an application in a Liberty JVM server, an existing PROGRAM definition is installed for the program that is not suitable for use with a linkable service, and indicates the reason why.
 
  • Service DFHSJ1401 (APAR PI92676) indicates that the Liberty JVM server failed to start because the named Liberty angel process is unavailable.
  • Service DFHSJ1402 (APAR PI92676) indicates that no default Liberty angel process is available, and CICS will verify the availability of the Liberty angel process again in 30 seconds. After five retries, the operator is given the option to continue trying or to disable the JVMSERVER resource.
  • Service DFHSJ1403 (APAR PI92676) indicates that the named Liberty angel process is unavailable, and CICS will verify the availability of the Liberty angel process again in 30 seconds. After five retries, the operator is given the option to continue trying or to disable the JVMSERVER resource.
  • Service DFHSJ1404 (APAR PI92676) is issued after five unsuccessful attempts by CICS to verify that a running Liberty angel process is available for Liberty JVM server startup. It prompts the operator to decide whether to continue waiting for the Liberty angel process to be available or to disable the JVMSERVER resource.
   
 
  • DFHSO1001 includes new error codes to identify NMI errors when CICS attempts to obtain TCPIPSERVICE resource statistics.
 
  • DFHTF0200 indicates that the 3270 datastream received from a terminal emulator client attempted to override a protected field.
  • Service DFHTF0200 (APAR PH25397) has been updated to explain how to correctly process the decimal field position that is returned with the message.
 
  • DFHWU4033 indicates that multiple OVERRIDEWARNINGCOUNT expressions were found in the URI.
  • DFHWU4302 includes new information about using the OVERRIDEWARNINGCOUNT URI parameter to bypass the warning count limit.
 
  • Service EYUBM0349W (APAR PH00907) indicates that the specified resource definition for the named CICSplex cannot be found in the data repository.
  • Service EYUCP0208E (APAR PH17586) indicates that the delete and re-add of a CMAS failed.
  • Service EYUCS0109I (APAR PH00375) indicates that the connection to the specified CMAS could not be completed.
  • EYUVC1030E indicates that an invalid user name or password was used.
  • EYUVC1031I indicates that you must enter a user name and password. This replaces message EYUVC1003 and partially replaces message EYUVC1002, both issued when the user ID or password were left blank. Message EYUVC1002 is still issued on WUIs where CICSPlex® SM Simulated Security is switched off.
  • EYUNX0157 is renamed to EYUXL0157.
  • EYUNX0158 is renamed to EYUXL0158.
  • EYUNX0159 is renamed to EYUXL0159.
  • EYUVC1003 is superseded by new message EYUVC1031I.
  • EYUVC1004 is superseded by new message EYUVC1030E.
  • EYUVC1005 is superseded by new message EYUVC1030E.
  • EYUVC1006 is superseded by new message EYUVC1030E.
  • Service EYUVS0215E (APAR PI87691) indicates that an attempt to create the named JVM server failed.
  • Service EYUVS0216I (APAR PI87691) indicates that the CMCI JVM server has been successfully installed.
  • Service EYUVS0218E (APAR PI87691) indicates that the named CMCI JVM server has been installed but could not be enabled.
  • Service EYUVS0219I (APAR PI87691) indicates that the named CMCI JVM server has been installed and enabled successfully for CMCI.
  • Service EYUVS0220E (APAR PI87691) indicates that an attempt to disable and discard an existing CMCI JVM server failed.
  • Service EYUVS0223I (APAR PH01554) indicates that the CICSPlex SM WUI region is waiting for an installed CMCI JVM server to become enabled.
   
Table 9. Changes to abend codes in this release
New abend codes Changed abend codes Removed abend codes
  • AASA occurs when CICS detects an unexpected response from a call to the user domain during initialization of a child task.
  • ABSX occurs when CICS detects that a BMS protected field has been updated by the client.
  • AEZ2 occurs when the BUSY condition is not handled.
  • AMPC occurs when CICS detects an unexpected error in the deferred rule evaluation task CMPE.
  • AMPD occurs when an attempt is made to attach a CICS deferred rule evaluation task CMPE, but the transaction is not attached internally by CICS.
  • AXSB occurs when CICS detects that a system transaction has been started from a terminal.
  • 0416 occurs when DFHXCEIP receives an unexpected return code from DFHXCBAM when processing a channels and containers command.
  • 0417 occurs when a PUT container request from an EXCI job has been rejected because total storage allocated for the channel will exceed 5% of the MEMLIMIT value.
  • 0418 occurs when DFHXCBAM receives a purged response when processing a channels and containers command.
  • 0419 occurs when DFHXCBAM receives an unexpected response when processing a channels and containers command.
   

Changes to compiler support

Table 10. Changes to compiler support in this release
Compiler This release
Enterprise COBOL for z/OS Support added for V6.1
Enterprise PL/I for z/OS Support added for V5.1. V4.2 is withdrawn from service.
z/OS V2.1 XL C/C++ V1.13 is withdrawn from service.

Changes to SIT parameters

Table 11. Changes to system initialization parameters in this release
API This release
EDSALIM CHANGED: The minimum value is changed to 64 MB.
ICVR CHANGED: The minimum value is changed from 500 to 250. The default value is changed from 5000 to 2000.
KERBEROSUSER Service NEW (APAR PI85443): Specifies the user ID associated with the Kerberos service principal for the CICS region.
MAXOPENTCBS CHANGED: The minimum value is changed from 1 to 32.
MAXSSLTCBS CHANGED: The default value is changed from 8 to 32.
RACFSYNC CHANGED: The RACFDB2SYNC option is removed and its functionality is included when RACFSYNC =YES is specified.
SECVFYFREQ REMOVED: CICS updates the last used time once a day for each user ID that is used on a CICS region.
SNPRESET NEW: Allows present userid terminals to have a single ACEE.
TCPIP CHANGED: The default value is changed from NO to YES.
WLMHEALTH NEW: Specifies the parameters to be used by CICS on z/OS WLM Health API calls.
XPTKT NEW: Instructs CICS to perform a RACF® check before it generates a PassTicket. The default value is changed from NO to YES.

Changes to JVM profiles

Table 12. Changes to JVM profiles in this release
Option This release
_DFH_UMASK CHANGED: Applies for the lifetime of the JVM server, not only during startup.
CICS_WLP_MODE NEW: Choose the level of integration between CICS and Liberty.
com.ibm.cics.jvmserver.cmci.user.agent.allow.list Service NEW with APAR, compatible with: Liberty JVM server
com.ibm.cics.jvmserver.cmci.user.agent.allow.list.monitor.interval Service NEW with APAR, compatible with: Liberty JVM server
com.ibm.cics.jvmserver.trace.specification Service NEW with APAR, compatible with: All JVM Environments
com.ibm.ws.zos.core.angelName Service CHANGED (APAR PI92676): Specify a named angel process for the Liberty JVM server to connect to upon startup.
com.ibm.ws.zos.core.angelRequired Service NEW (APAR PI92676): Enforce the requirement to connect to the Liberty angel process when the Liberty JVM server is being enabled.
PURGE_ESCALATION_TIMEOUT Service NEW (APAR PH12280), compatible with: All JVM Environments

New JVM server option to specify the interval between the disable actions that CICS performs when a JVM server encounters a TCB failure.

Changes to control tables

Table 13. Changes to resource definitions in this release
Resource This release
DFHXCOPT CHANGED:
  • The default for the CICSSVC parameter has changed from 0 to 216.
  • New parameter LOCALCCSID, which specifies the default CCSID for the EXCI job.
  • The TRACE parameter has a new value of 3 to allow for level 3 tracing.

Service CHANGED with APAR: The EXCI SURROGCHK parameter has been removed. Surrogate checking is always done. Specifying SURROGCHK=YES in the EXCI options table, DFHXCOPT, is accepted for compatibility.

Changes to CICS SPI

Table 14. Changes to the system programming interface commands in this release
Command This release
CREATE MQMONITOR NEW: To create an MQMONITOR resource in the CICS region
DISCARD MQMONITOR NEW: To remove an installed MQMONITOR resource
EXTRACT STATISTICS CHANGED: New options: ASYNCSERVICE, LASTRESETABS, and MQMONITOR
INQUIRE ASSOCIATION CHANGED: New options for previous transaction data: PTCOUNT, PTSTARTTIME, PTTASKID, PTTRANSID

Service CHANGED (APAR PH42306): Enhanced support for Liberty. The association data user ID value now reflects the final user ID value used in secure Liberty transactions, instead of the initial user ID.

INQUIRE DSNAME CHANGED: New CVDA value RREPL on the AVAILABILITY option, which indicates that full access to the data set is restricted to replication programs; other programs have only read access
INQUIRE EPADAPTER CHANGED: New CVDA's: DSIE on DATAFORMAT option and TDQUEUE on ADAPTERTYPE option
INQUIRE MQMONITOR NEW: To inquire on the information about an MQMONITOR resource
INQUIRE PROGRAM CHANGED:
  • New option REPLICATION, which indicates a replication program with full access to VSAM data sets in RREPL state
  • New CVDA value DYNAMIC on the CHANGEAGENT and INSTALLAGENT options, which indicates that the program was changed or installed due to an @CICSProgram annotation in a Liberty application
INQUIRE SYSDUMPCODE CHANGED: New options: DSPLIST and JOBLIST
INQUIRE SYSTEM CHANGED: New option REGIONUSERID to return the CICS region user ID
INQUIRE WEBSERVICE CHANGED: MAPPINGLEVEL and MINRUNLEVEL now accept the value 4.1.

Service CHANGED (APAR PI86039): MAPPINGLEVEL and MINRUNLEVEL now accept the value 4.2.

Service CHANGED (APAR PI88519): MAPPINGLEVEL and MINRUNLEVEL now accept the value 4.3.

INQUIRE WLMHEALTH NEW: To retrieve information about the z/OS WLM health indicators set for a CICS address space.
INQUIRE XMLTRANSFORM CHANGED: MAPPINGLEVEL and MINRUNLEVEL now accept the value 4.1.

Service CHANGED (APAR PI86039): MAPPINGLEVEL and MINRUNLEVEL now accept the value 4.2.

Service CHANGED (APAR PI88519): MAPPINGLEVEL and MINRUNLEVEL now accept the value 4.3.

PERFORM SHUTDOWN CHANGED: New option RESTART, to enable the MVS Automatic Restart Manager (ARM) to restart a CICS region if the region shuts down normally.
PERFORM STATISTICS RECORD CHANGED: New options: ASYNCSERVICE and MQMONITOR
SET DISPATCHER CHANGED: RUNAWAY option accepts a new, lower limit of 250
SET DSNAME CHANGED: New CVDA value RREPL on the AVAILABILITY option, to allow only replication programs to have full access to a data set and other programs to have only read access
SET MQMONITOR NEW: To enable or disable an MQMONITOR resource, and to start or stop and set automatic restart of the MQ monitor
SET PROGRAM CHANGED: New option REPLICATION to specify a replication program and allow the program full access to VSAM data sets in RREPL state
SET SYSDUMPCODE CHANGED: New options: DSPLIST and JOBLIST
SET SYSTEM CHANGED: RUNAWAY option accepts a new, lower limit of 250
SET TASK Service CHANGED (APAR PI98569): CICS processing of a task purge is enhanced to ensure that a Db2 cancel thread command is issued to cancel a thread that is active in Db2 at the time the task that is using the thread is purged or forcepurged.
SET TRANSACTION CHANGED: RUNAWAY option accepts a new, lower limit of 250
SET WLMHEALTH NEW: To change the z/OS WLM health value process settings of a CICS address space server.

Changes to CICS-supplied transactions

Table 15. Changes to CICS-supplied transactions in this release
Transaction This release
CEDG and CEDY NEW: Transactions CEDG and CEDY, read-only forms of CEDF and CEDX, are now available.
CEMT - main terminal CHANGED:

Service CHANGED (APAR PI98569): CEMT SET TASK: CICS processing of a task purge is enhanced to ensure that a Db2 cancel thread command is issued to cancel a thread that is active in Db2 at the time the task that is using the thread is purged or forcepurged.

CFCT Service NEW (APAR PI97207): Provides tie-up records for VSAM files to a replication log at specified intervals.
CHCK NEW: Health Checker long running system task
CKBR Service CHANGED (APAR PH22136): CKBR now handles temporary errors that occur when issuing MQOPEN and MQGET requests. Rather than terminating, CKBR will retry every minute for up to an hour. If the error is not resolved after an hour, the monitor transaction will then terminate.
CKTI CHANGED: CKTI now handles abends produced when starting user transactions. If an abend occurs when the CKTI transaction attempts to start the user transaction, rather than terminating, CKTI will now send the trigger message to the dead-letter queue, and trigger monitor processing continues.

Service CHANGED (APAR PH22136):CKTI now handles temporary errors that occur when issuing MQOPEN and MQGET requests. Rather than terminating, CKTI will retry every minute for up to an hour. If the error is not resolved after an hour, the monitor transaction will then terminate.

CMPE NEW: Policy deferred rule evaluation task
COHT, COIE, COIR, COI0, CONA, COND, CONH, CONL, CONM, COWC CHANGED to Category 1 transactions

Changes to CICS monitoring

Table 16. Changes to monitoring data in this release
Data This release
DFHPROG group CHANGED: The following abend codes are now written to the ABCODEO and ABCODEC monitoring fields:
  • ASPF
  • ASPN
  • ASPO
  • ASPP
  • ASPQ
  • ASPR
  • ASP1
  • ASP2
  • ASP3
  • ASP7
  • ASP8
DFHCICS group

NEW FIELDS: MPSRACT, MPSRECT, PTSTART, PTTRANNO, PTTRAN, and PTCOUNT

CHANGED: OTRANFLG field has new transaction origin type for asynchronous transactions: X'16' ASRUNTRAN

Service CHANGED (APAR PH42306): Field 089 (USERID) is changed for Liberty such that the user ID value now reflects the final user ID value used in secure Liberty transactions, instead of the initial user ID.

DFHTASK group

NEW FIELDS: ASTOTCT, ASRUNCT, ASFTCHCT, ASFREECT, ASFTCHWT, ASRNATWT, and LPARNAME

CHANGED: TRANFLAG field has new transaction origin type for asynchronous transactions: X'16' Asynchronous services domain (AS)-run transaction

Transaction resource class data

NEW FIELDS: MNR_PTD_ATTACH_TIME, MNR_PTD_TRANNUM, MNR_PTD_TRANID, and MNR_PTD_COUNT

Identity class data

NEW FIELDS: MNI_PTD_ATTACH_TIME, MNI_PTD_TRANNUM, MNI_PTD_TRANID, and MNI_PTD_COUNT

Changes to statistics

Table 17. Changes to statistics in this release
Statistics This release
Asynchronous services statistics NEW: Statistics are provided for asynchronous services.
TCP/IP global statistics CHANGED: New fields added:
  • Current number of non-persistent inbound sockets (SOG_CURR_NPERS_INB_SOCKETS)
  • Peak number of non-persistent inbound sockets (SOG_PEAK_NPERS_INB_SOCKETS)
  • Peak number of persistent inbound sockets (SOG_PEAK_PERS_INB_SOCKETS)
  • Total number of non-persistent inbound sockets created (SOG_NPERS_INB_SOCKETS_CREATED)
  • Peak number of outbound sockets (SOG_PEAK_BOTH_OUTB_SOCKETS)
  • Total number of times outbound sockets reused (SOG_TIMES_OUTB_REUSED)
  • Total number of persistent outbound sockets created (SOG_PERS_OUTBOUND_CREATED)
TCP/IP services statistics CHANGED: New fields added:
  • Current Maximum Backlog (SOR_CURR_MAX_BACKLOG)
  • Total Connections (SOR_TOTAL_CONNS)
  • Requests processed (SOR_REQUESTS)
  • Made non-persistent at MAXPERSIST (SOR_NONP_AT_MAXPERSIST)
  • Disconnected after maximum uses (SOR_DISC_AT_MAX_USES)
  • Made non-persistent at task limit (SOR_NONP_AT_TASK_LIMIT)
  • Disconnected at task limit (SOR_DISC_AT_TASK_LIMIT)
  • Current backlog (SOR_CURR_BACKLOG)
  • Connections dropped (SOR_CONNS_DROPPED)
  • Time connection last dropped (SOR_CONN_LAST_DROPPED)
MQ monitor statistics NEW: Statistics are provided for MQMONITOR resources.
z/OS Communications Server: Global statistics CHANGED: New fields added:
  • BMS 3270 Validation (A03BMVL)
  • Number of BMS 3270 Validation Failures Abended (A03BMAB)
  • Number of BMS 3270 Validation Failures Ignored (A03BMIG)
  • Number of BMS 3270 Validation Failures Logged (A03BMLG)

Changes to user-replaceable programs

Table 18. Changes to the user-replaceable programs in this release
Program This release
DFHBMSX NEW: The DFHBMSX URM is called to enable 3270 data stream validation at CICS initialization. The URM is also called when a 3270 data stream validation error has been detected when issuing BMS RECEIVE MAP commands.
DFHWBOPT Service NEW (APAR PH16992): Handler program that can be invoked to process HTTP OPTIONS requests.

Changes to samples

Table 19. Changes to the samples provided with CICS in this release
Sample This release
DFH$MOLS CHANGED: Specifying a 2 digit year on the DATE control parameter now defines a date in the twenty-first century.
DFH$UMOD CHANGED: CICSPlex SM module names updated in the sample.
DFH0STEP CHANGED: Changed to collect and print new asynchronous services statistics.

Changes to toggle-enabled features

Table 20. Changes to toggle-enabled features in this release
Feature toggle This release
com.ibm.cics.bms.ids={true|false} NEW: Allows CICS to detect if a 3270 emulator has invalidly modified a protected field generated by a BMS map. See BMS 3270 Intrusion Detection Service.
com.ibm.cics.cmci.jvmserver={true|false} Service NEW (APAR PI87691): Allows you to set up the CMCI without the CMCI JVM server. See Configuring the CMCI JVM server.
com.ibm.cics.cpsm.bas.largecicsplex={true|false} Service NEW (APAR PH19761): Allows you to constrain large resource deployments lists for BAS to a single data space instead of spreading across multiple data spaces.
com.ibm.cics.cpsm.wlm.botrsupd.enabled={true|false} Service NEW (APAR PH14812): Allows you to disable updates to the Coupling Facility when the task load falls below the lower tier threshold of the CICSPlex SM tuning parameter, BOTRSUPD.
com.ibm.cics.cpsm.wlm.surgeresist={true|false} Service NEW (APAR PH30768): When applied to CICSPlex SM WLM routing regions, this feature toggle takes effect for the QUEUE and GOAL WLM algorithms when using CICSPlex SM sysplex optimized workload routing. It has no effect when applied to target regions.

When the feature toggle is set to true, surges of extremely high frequency, short duration transactions can be mitigated by reducing the likelihood that recently selected target regions are reselected. Enabling this feature toggle increases the average routing cost per transaction, but restores the routing behavior of CICSPlex SM before APAR PH30768 is applied. See Changes to CICSPlex SM sysplex optimized workload routing behavior.

com.ibm.cics.db2.origindata={true|false} Service NEW (APAR PH49408): Gives you the option to disable the passing of adapter origin data to Db2 for adapter tracking.
com.ibm.cics.http.options.handler={program_name} Service NEW (APAR PH16992): Allows you to specify the name of the HTTP Options handler program. See HTTP method reference for CICS web support.
com.ibm.cics.rls.delete.ridfld={true|false} Service NEW (APAR PH07596): Enables surrogate user checking for spool commands.
com.ibm.cics.tls.minimumkeystrength={1024|2048} Service NEW (APAR PH50175): Sets the minimum key size allowed during TLS handshakes.

Changes to global user exits and task-related user exits

Table 21. Changes to global user exits and task-related user exits in CICS TS 5.4
Exit This release
XDUREQ CHANGED: New parameters UEPDLISI and UEPJLISI
XDUREQC CHANGED: New parameters UEPDLISO and UEPJLISO
XRSINDI CHANGED: New value UEIDMQMN for UEPIDTYP parameter

Changes to security

Table 22. Changes to security in CICS TS 5.4
Area This release
Identification
Authentication
  • CHANGED: The default of XPTKT system initialization parameter is changed from NO to YES.
  • NEW: Kerberos mutual authentication
  • NEW with APAR PI87691: CICS Explorer support for MFA
  • NEW with APAR PI91554: Liberty options oauth-2.0, JWT and OpenID Connect
  • NEW with APAR PI92676: Wait for angel at JVM server startup
  • NEW with APAR PI98174: Multiple Liberty servers per CICS region using an angel
Integrity CHANGED: Support for IBM® z/OS Communications Server IDS
Confidentiality
  • NEW with APAR PH20063: SNI support in CICS TS communications with an HTTP server over TLS connections
  • NEW with APAR PH50175: Sets the minimum key size allowed during TLS handshakes
Auditing NEW: Support for IBM Health Checker for z/OS
Performance NEW: Preset user ID on a terminal can share ACEE
Deprecated and removed
  • REMOVED: SECVFYFREQ system initialization parameter
  • REMOVED with APAR PH09898: Surrogate checking is always done. Specifying SURROGCHK=YES in the EXCI options table, DFHXCOPT, is accepted for compatibility.
Table 23. Changes to RACF classes related to command security in CICS TS 5.4. These changes are new resource identifiers for SPI commands. See CICS resources subject to command security checking and Resource and command check cross-reference for a list of all of the SPI commands and the RACF ACCESS required for each one.
Command This release
CREATE MQMONITOR DISCARD MQMONITOR INQUIRE MONITOR SET MONITOR NEW: resource identifier MQMON
SET PROGRAM NEW: resource identifier REPLICATION.

ACCESS(ALTER) is required for REPLICATION option.

INQUIRE SYSDUMPCODE SET SYSDUMPCODE NEW: resource identifier SYSDUMPCODE.

ACCESS(CONTROL) is required for SET with JOBLIST option.

INQUIRE WLMHEALTH SET WLMHEALTH NEW: resource identifier WLMHEALTH. Requires APAR PI84397.
Table 24. Changes to RACF classes related to CICS user IDs in CICS TS 5.4
User ID This release
Region user ID CHANGED: Security for submitting a JCL job to the internal reader.
KERBEROSUSER NEW with APAR PI85443
Table 25. Changes to other RACF classes in CICS TS 5.4
Class Profile This release
PTKTDATA IRRPTAUTH.applid.userid NEW XPTKT system initialization parameter
SURROGAT userid.DFHEXCI NEW with APAR PH09898

Changes to CICS policies

Table 26. Changes to CICS policies in CICS TS 5.4
Change This release
All system rules

Support for static data capture items and event names for policy events

NEW with APAR PI88500
Bundle available status system rule NEW with APAR PI92806
Bundle enable status system rule NEW with APAR PI92806
Db2 connection status system rule NEW
File open status system rule NEW
File enable status system rule NEW
IPIC connection status system rule NEW with APAR PI92806
Message system rule NEW
MRO connection status system rule NEW with APAR PI92806
Program enable status system rule NEW with APAR PI92806
Transaction abend system rule NEW
Transaction class tasks system rule NEW
User tasks system rule NEW
All task rules RENAMED: CICS policy task threshold rules are renamed to policy task rules.
All task rules

Support for setting Transaction ID and User ID conditions for task rules

NEW with APAR PH26145
All task rules

Support for static data capture items and event names for policy events

NEW with APAR PI88500

Changes to CICSPlex SM resource tables

Table 27. Changes to the resource tables provided by CICSPlex SM in this release
Resource table This release
CICSRGN CHANGED:
  • new REGIONUSERID attribute
  • new RESTART parameter for the SHUTDOWN action
CRESMQMN NEW: A CICSPlex SM Topology Manager object that describes an instance of a MQMONITOR definition in a CICS system.
DB2CONN CHANGED: New fields added: PPSIGNONS, PTCREATE
DB2ENTRY CHANGED: New fields added: PSIGNONS, TCREATE
DSNAME CHANGED: new value RREPL for AVAILABILITY
EPADAPT CHANGED: new DSIE value for DATAFORMAT
HTASK CHANGED: New fields added: ASTOTCT, ASRUNCT, ASFTCHCT, ASFREECT, ASFTCHWT, ASRNATWT, LPARNAME, MPSRECT, MPSRACT, PTCOUNT, PTTRAN, PTSTART, and PTTRANNO
MQMINGRP NEW: resource table for MQMONITOR resource definitions in a resource group
MQMON NEW: A CICS resource that describes an IBM MQ monitor in an active CICS system being managed by CICSPlex SM.
MQMONDEF NEW: resource table for MQMONITOR resource definitions
MVSWLM CHANGED: New attributes added: MNGWLMAD, MNGWLMHL, MNGWLMHT, MNGWLMIN, and MNGWLMOS
TASK CHANGED: New fields added: ASTOTCT, ASRUNCT, ASFTCHCT, ASFREECT, ASFTCHWT, ASRNATWT, LPARNAME, MPSRECT, and MPSRACT
TCPIPGBL CHANGED: new fields added: CINSCKSNPERS, INSCKSNPERS, OUTSCKSREUSE, OUTSOCKSPERS, PINSCKSNPERS, PINSCKSPERS, and POUTSCKSBOTH
TCPIPS CHANGED: new fields added: CMAXBACKLOG, CONNLASTDROP, CONNSDROPPED, CURRBACKLOG, DISCATTLIM, DISCATUSELIM, NPERSATMAXP, NPERSATTLIM, REQUESTS, and TOTALCONNS
WLMATARG CHANGED: New WLMHLTH attribute
WLMAWAOR CHANGED: New WLMHLTH attribute

Changes to CICSPlex SM system parameters

Table 28. Changes to the system parameters used by CICSPlex SM in this release
System parameter This release
CACHEDSNUM NEW with APAR PH00673: For use under the direction of IBM Support.
RESTART NEW
STALLASYCNT NEW: to enable the tracking and STALL detection of asynchronous tasks.
STALLASYTSK NEW: to enable the tracking and STALL detection of asynchronous tasks.

Changes to CICSPlex SM WUI server initialization parameters

Table 29. Changes to the WUI server initialization parameters used by CICSPlex SM in this release
WUIPARM parameter This release
TCPIPHOSTNAME Service DEPRECATED (APAR PH47103):

The hostname of the WUI server is the name of the host where the WUI is executing. It is no longer set by the TCPIPHOSTNAME WUI initialization parameter. The WUI uses relative URLs, and not embedded host names.

TCPIPHOSTNAME is still required, but the value is ignored. This parameter is retrained for compatibility and will be removed in a later release.

TCPIPHTTPHOST Service DEPRECATED (APAR PH47103):

The hostname of the WUI server is the name of the host where the WUI is executing. The WUI uses relative URLs, and not embedded host names.

If a value is specified on TCPIPHTTPHOST, it is ignored. This parameter is retrained for compatibility and will be removed in a later release.

TCPIPSSL Service CHANGED (APAR PI94706): New value ATTLSBASIC, to support Application Transparent Transport Layer Security (AT-TLS).

Changes to CICSPlex SM

Change of behavior in reporting the routing load of empty target regions in CICSPlex SM
Before CICS TS 5.4, a target region always has a non-zero routing load value because of the standard CICSPlex SM long running tasks. In CICS TS 5.4, these tasks are invisible to routing load queries because they are converted into CICS system tasks. As a result, in a scope containing CICS regions of different releases, more transactions are routed to the apparently less loaded target regions of CICS TS 5.4. Regions of CICS TS 5.4 might appear to handle more dynamic traffic than regions in earlier releases, but the overall workload throughput is not affected.
Service Changes to CICSPlex SM sysplex optimized workload routing behavior
(APAR PH30768) The default behavior of CICSPlex SM workload management routing algorithms has been updated to increase the likelihood that work is routed to healthy, local target regions. This change applies only to the QUEUE and GOAL algorithms, not to the link neutral variants (LNQUEUE and LNGOAL).
Change in how the MAS agent user ID is determined
Beginning with CICS TS V5.4, the MAS agent user ID is always the CICS region user ID. PLTPIUSR no longer matters in determining the MAS agent user ID.
Service Changes to CICSPlex SM sysplex optimized workload routing behavior
(APAR PH30768) The default behavior of CICSPlex SM workload management routing algorithms has been updated to increase the likelihood that work is routed to healthy, local target regions. This change applies only to the QUEUE and GOAL algorithms, not to the link neutral variants (LNQUEUE and LNGOAL). See Changes to CICSPlex SM sysplex optimized workload routing behavior for details.
Record size increase of EYUHIST* data sets
The record size of EYUHIST* data sets is increased from RECORDSIZE(3460 3464) to RECORDSIZE(3536 3540). The EYUJHIST sample is updated to reflect this change.
COxx tasks
Tasks that are internally initiated by CICSPlex SM in a MAS and that have transaction IDs beginning with the characters CO are changed to execute as CICS system tasks.
Service CICSPlex SM BAS
NEW (APAR PH19761): It is disabled by default.

The CICSPlex SM BAS component is now able to use all available BAS data space storage by spreading large resource deployment lists for BAS across multiple data spaces instead of being constrained to a single data space. This feature is controlled by the feature toggle com.ibm.cics.cpsm.bas.largecicsplex.

Changes to documentation

Changes to PDF

CICS TS 5.4 made extensive changes to the organization of documentation in PDF and those changes are explained here. Some PDF manuals were renamed to reflect the terminology used in IBM Documentation. Some PDF manuals were reorganized to make them shorter and more modular, or to merge multiple volumes into one single volume. Table 30 shows the changes.

Table 30. Changes to name or organization of the PDF manuals at CICS TS 5.4
PDF Change for CICS TS 5.4
Application Programming Guide Renamed to Developing CICS Applications.
Application Programming Reference Renamed to API (EXEC CICS) Reference.
CICSPlex SM Resource Tables Reference Combined into a single volume.
Customization Guide
  • Renamed to Developing CICS System Programs.
  • XPI reference section split into a separate PDF called XPI Function Reference.
  • User exit reference section split into a separate PDF called Global User Exit Reference.
External Interfaces Guide Information about EXCI split into a separate PDF called Using EXCI with CICS.
Installation Guide Renamed to Installing CICS TS for z/OS.
Operations and Utilities Guide
  • Renamed to Administering CICS.
  • Utilities reference section split into a separate PDF called Utilities Reference.
Messages and Codes
  • Codes split into a separate PDF called CICS Codes.
  • Messages combined into a single volume.
Performance Guide
  • Monitoring data reference section split into a separate PDF called Monitoring Data Reference.
  • Statistics reference section split into a separate PDF called Statistics Reference.
Problem Determination Guide Renamed to Troubleshooting CICS.
Recovery and Restart Guide Included in Administering CICS.
Resource Definition Guide
  • Guidance information is included in Configuring CICS TS for z/OS.
  • Resource reference section split into a separate PDF called Resource Reference.
Supplied Transactions
  • Guidance information is included in Administering CICS.
  • Renamed to Supplied Transactions Reference.
System Definition Guide
  • Renamed to Configuring CICS TS for z/OS.
  • Parameter reference section split into a separate PDF called System Initialization Parameter Reference.

PDFs are delivered in IBM Documentation, not in IBM Publications Center.

PDFs no longer have manual numbers.

PDFs have descriptive filenames instead of codes.

The following PDFs are stabilized and no longer produced:
  • Business Transaction Services
  • CICSPlex SM Managing Resource Use
  • CICSPlex SM Web User Interface Guide
  • Debugging Tools Interfaces Reference
  • Diagnosis Reference
  • Distributed Transaction Programming Guide
  • External Interfaces Guide
  • Front End Programming Interface User's Guide
  • Internet Guide
  • Trace Entries
Online and offline documentation
  • NEW: IBM Documentation Offline is now automatically translated.
  • CHANGED: Upgrading information is provided in full in the latest CICS TS product documentation.
CICS Explorer®
CHANGED: CICS Explorer documentation is published independently from the CICS TS documentation.