Changes to externals in CICS TS 5.3

CICS® TS 5.3 changes a number of externals, including commands, transactions, resources, system initialization parameters, messages, trace and user exits.

This document reflects changes only up to the date when a release was withdrawn from service (end-of-service). Occasionally current APARs can apply also to end-of-service releases. For fix lists that summarize all the APARs for each CICS TS release level, see Fixes by version for CICS products.

Changes to CICS API

Table 1. Changes to EXEC CICS commands in CICS TS 5.3
API CICS TS 5.3
ASSIGN CHANGED: New options ABOFFSET to return the offset of an abend, and INPUTMSGLEN to test for the length of a terminal input string, before you receive the input.
CHANGE PASSWORD Service CHANGED with APAR:
  • APAR PH23078: New NOTAUTH with RESP2 value of 1, indicating that the PASSWORD field, the NEWPASSWORD field, or both are blank.
  • APAR PH31270: New NOTAUTH with RESP2 value of 17, indicating that the USERID is not authorized to use the application.
CHANGE PHRASE Service CHANGED with APAR:
  • APAR PH23078: New NOTAUTH with RESP2 value of 1, indicating that the PHRASE field, the NEWPHRASE field, or both are blank.
  • APAR PH31270: New NOTAUTH with RESP2 value of 17, indicating that the USERID is not authorized to use the application.
DELETE CHANNEL NEW
EXTRACT TCPIP CHANGED: New value, ATTLSAWARE, on SSLTYPE parameter.
QUERY CHANNEL NEW
REQUEST ENCRYPTPTKT NEW
Service CHANGED (APAR PI60604):
  • 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.
REQUEST PASSTICKET NEW
READQ TD CHANGED: The LENGERR condition is raised if an application specifies a negative LENGTH value.
SIGNON TOKEN NEW
TRANSFORM DATATOJSON Service NEW (APAR PI54841): to convert application data to JSON.
TRANSFORM JSONTODATA Service NEW (APAR PI54841): to convert JSON to application data.
VERIFY PASSWORD Service CHANGED with APAR:
  • APAR PH23078: New NOTAUTH with RESP2 value of 1, indicating that the PASSWORD field is blank.
  • APAR PH31270: New NOTAUTH with RESP2 value of 17, indicating that the USERID is not authorized to use the application.
VERIFY PHRASE Service CHANGED with APAR:
  • APAR PH23078: New NOTAUTH with RESP2 value of 1, indicating that the PHRASE field is blank.
  • APAR PH31270: New NOTAUTH with RESP2 value of 17, indicating that the USERID is not authorized to use the application.
VERIFY TOKEN CHANGED: ENCRYPTOKEN parameter returns a 4-byte encryption token when the TOKENTYPE is KERBEROS.

Service CHANGED (APAR PI56774): New options, OUTTOKEN and OUTTOKENLEN, are available.
WEB CONVERSE CHANGED: New INVREQ with RESP2 value of 157, which indicates that CICS is unable to process an HTTP response because the HTTP headers in the response are longer than 4k.
WEB RECEIVE (Client) CHANGED: New INVREQ with RESP2 value of 157, which indicates that CICS is unable to process an HTTP response because the HTTP headers in the response are longer than 4k.
WRITE CHANGED: A CICS message is issued when an EXEC CICS WRITE command is issued to a shared data table fails because the data table is full.
WRITE OPERATOR THREADSAFE
XCTL CHANGED: New INVREQ with RESP2 value 32, which indicates that an XCTL command was issued from a program that would invoke an Enterprise Java application in a Liberty JVM server. This operation is not supported.

Changes to JCICS API

Table 2. Changes to JCICS API in CICS TS 5.3
Class/Interface Method CICS TS 5.3
AbendError   DEPRECATED
Channel delete() NEW: to delete a channel
Channel getContainerCount() NEW: to query a channel
Document Document(byte[] docToken) NEW CONSTRUCTOR: docToken, to use a document that was created in a COBOL program
CICSTransactionRunnable getTranid() NEW: allows a user to signify that the Runnable work should be run under a CICS transaction id of choice, rather than the default transaction id.
CICSTransactionCallable getTranid() NEW: allows a user to indicate that the Callable work should be run under a CICS transaction id of choice, rather than the default transaction id.
Program
xctl()
xctl(byte[] CA)
xctl(Channel chan)
 REMOVED
UnknownCicsError   DEPRECATED

Changes to resource definitions

Table 3. Changes to resource definitions and resource groups in CICS TS 5.3
Resource CICS TS 5.3
DFHCSDUP COPY NEW: to copy a single resource definition from one group to another
DFHCSDUP LIST CHANGED: shows the maintenance level of the CSD
DB2CONN resources 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.
FILE resources REMOVED: PASSWORD attribute is obsolete.
PACKAGESET resources NEW: CICS application resource which represents a Db2 collection.
TCPIPSERVICE resources CHANGED: ATTLSAWARE option added to the SSLTYPE parameter.
Resource group This release
DFHDB2 CHANGED: Program DFHD2SPS added as part of PACKAGESET support.
DFHJAVA CHANGED: New transaction CJSU
DFHSIGN CHANGED: Program DFHSFP is changed from RESIDENT(YES) to RESIDENT(NO).
Table 4. Changes to compatibility groups in CICS TS 5.3
Group CICS TS 5.3
DFHCOMPH NEW GROUP with APAR

Changes to CICS utilities

Table 5. Changes to CICS-supplied utilities in CICS TS 5.3
Utility CICS TS 5.3
DFHCSDUP CHANGED:
  • Report data sets produced by the LIST function of DFHCSDUP now include release information for the CSD
  • New options: BEFORE and AFTER on ADD, resource type on COPY
  • New command, COPY, to copy a single resource definition from one group to another.
Dump utilities (DFHDU 700 and DFHPD 700) CHANGED: the name of the dump formatting utility changes every release in line with the level number for CICS. For this release, its name is DFHPD700.
CICS trace utility program, DFHTU 700 CHANGED: the name of the trace formatting utility changes every release in line with the level number for CICS. For this release, its name is DFHPDU700.
The DFH0IPCC migration utility CHANGED: creates USERAUTH attribute on the IPCONN definition if a CONNECTION has ATTACHSEC values of LOCAL, IDENTIFY, or VERIFY.
DFHDPLOY NEW: provides a set of commands that can be used in a script to deploy, undeploy, and set the state of CICS applications and CICS bundles.
EYU9XENF CHANGED: shows the job ID or task ID or each connection to the ESSS, and the level of the ESSS program.

Changes to CICS assistants

Table 6. Changes to the CICS web services assistants, XML assistants, and JSON assistants in CICS TS 5.3
Assistant CICS TS 5.3
All Service NEW with APAR PI67641: Support for mapping level 4.1
DFHJS2LS Service CHANGED with APAR:
  • APAR PI57467. New option, HYPHENS-AS-UNDERSCORES, on MAPPING-OVERRIDES.
  • APAR PI47466. New option, FULL, on WIDE-COMP3.
  • APAR PI74752. New option DATA-SCREENING
DFHLS2JS Service CHANGED with APAR:
  • APAR PI74752. New option DATA-SCREENING
  • APAR PI95139. New option PACKEDZERO on TRUNCATE-NULL-ARRAY-VALUES
DFHLS2SC Service CHANGED with APAR:
  • APAR PI74752. New option DATA-SCREENING
  • APAR PI95139. New option PACKEDZERO on TRUNCATE-NULL-ARRAY-VALUES
DFHLS2WS Service CHANGED with APAR:
  • APAR PI74752. New option DATA-SCREENING
  • APAR PI95139. New option PACKEDZERO on TRUNCATE-NULL-ARRAY-VALUES
DFHSC2LS Service CHANGED with APAR:
  • APAR PI57467. New option, HYPHENS-AS-UNDERSCORES, on MAPPING-OVERRIDES.
  • APAR PI47466. New option, FULL, on WIDE-COMP3.
  • APAR PI74752. New option DATA-SCREENING
DFHWS2LS Service CHANGED with APAR:
  • APAR PI57467. New option, HYPHENS-AS-UNDERSCORES, on MAPPING-OVERRIDES.
  • APAR PI47466. New option, FULL, on WIDE-COMP3.
  • APAR PI74752. New option DATA-SCREENING

Changes to messages and codes

Table 7. Changes to messages and codes in CICS TS 5.3
New messages Changed messages Removed messages
 
  • Service DFH5275 (with APAR PI82179) is issued as a warning instead of an error. Its severity indicator is changed from E to W.
  • DFH7006, because the integrated translator can now be used with EXCI programs written in PL/I.
  • DFHAM4961 indicates that the installation of a JVM server has failed because the PROFILEDIR was too long.
  • Service DFHAM4865S
  
  • DFHAP0006 indicates that an abend occurred at offset X. The module, application, version, and platform details are included.
    
  • DFHCA4961 indicates that the installation of the JVMSERVER resource failed because the PROFILEDIR specified is too long.
  • Service DFHCA4865S
  
  • DFHDB2080 indicates that an abend has occurred in the set packageset program DFHD2SPS.
  • DFHDB2083 indicates that the set packageset program DFHD2SPS is disabled.
  • DFHDB2084 indicates that a link to the set packageset program DFHD2SPS failed.
  • DFHDB2087 indicates that a resource definition for the set packageset program DFHD2SPS was not found.
  • DFHDB2088 indicates that a fetch for the set packageset program DFHD2SPS failed.
  • DFHDB2089 indicates that the CICS-DB2® set packageset program issued an EXEC SQL SET CURRENT PACKAGESET command, which failed with an SQL code.
  • DFHDB8300 indicates that a CICS bundle has failed to install the PACKAGESET.
  • DFHDB8301 indicates that a CICS bundle has failed to install a PACKAGESET because the resource name was not specified or is more than 128 characters in length.
  • DFHDB8302 indicates that an abnormal end (abend) or program check has occurred in a module. This implies that there may be an error in the CICS code. Alternatively, unexpected data was input, or storage was overwritten.
  • DFHDB8303 indicates that a CICS bundle has successfully installed a named PACKAGESET on a named platform, as either enabled or disabled.
  • DFHDB8304 indicates that a CICS bundle has successfully installed the named PACKAGESET of a named application, version, and platform, as either enabled or disabled.
  • DFHDB8305 indicates that the named PACKAGESET on a named platform was enabled or disabled.
  • DFHDB8306 indicates that the named PACKAGESET of a named application, version, and platform was enabled or disabled.
  • DFHDB2003 now indicates which DB2 subsystem is already connected to.
 
  • DFHDB8307 indicates that the PACKAGESET on the named platform was discarded.
  • DFHDB8308 indicates that the PACKAGESET of the named application, version, and platform was discarded.
  • DFHDB8309 indicates that the CICS bundle has failed to install one PACKAGESET because another PACKAGESET is already installed on the platform. Only one PACKAGESET can be installed on a platform.
  • DFHDB8310 indicates that the CICS bundle failed to install one PACKAGESET because another PACKAGESET is already installed for the application, version, and platform. Only one PACKAGESET can be installed as part of an application.
  • DFHDB8311 indicates that the CICS bundle has failed to install a PACKAGESET.
    
 
  • DFHEC1013 now includes optional inserts when the value specified for the CICSEPSchemaVersion or CICSEPSchemaRelease attribute is invalid.
  
 
  • DFHEP2003 now includes optional inserts for when the value specified for the CICSEPSchemaVersion or CICSEPSchemaRelease attribute is invalid.
  • DFHEP2007 now includes optional inserts for when the value specified for the CICSEPSchemaVersion or CICSEPSchemaRelease attribute is invalid.
  
  • DFHFC0432 indicates that a data table request for a given file has failed because the table is full. The reason for it being full is included. Previously, this information was returned only on a NOSPACE condition on EXEC CICS WRITE.
  • DFHFC6044 indicates that a file in a bundle has moved to disabled status.
  • 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.
  • DFHFC0952 has a formatting change, which might require an update to programs that read this CICS message.
  
  • Service DFHH0001 (with APAR PI76965) indicates that potential security issues were identified in the access to the CEDA transaction.
  • Service DFHH0002 (with APAR PI76965) indicates that potential security issues were identified in the configuration of the spool.
  • Service DFHH0003 (with APAR PI76965) indicates that potential security issues were identified in the configuration of TDQs that are defined to the internal reader.
  • Service DFHH0200 (with APAR PI76965) indicates that CICS health checker rules cannot run because of an error.
  • Service DFHH0301 (with APAR PI76965) indicates that no potential security issues were identified in the configuration of CEDA.
  • Service DFHH0302 (with APAR PI76965) indicates no potential security issues were identified in the configuration of the spool.
  • Service DFHH0303 (with APAR PI76965) indicates that no potential security issues were identified in the configuration of TDQs that are defined to the internal reader.
    
  • DFHKE0108 and DFHKE0109 indicate that CICS detected hardware earlier than IBM® z9® during initialization. CICS initialization stops.
    
  • DFHLD0110 indicates a mismatch between the CICS release being started during initialization and the release of the CICS nucleus modules. CICS initialization stops.
  • DFHLD0519 indicates that the installation of LIBRARY failed because a LIBRARY of that name is already installed. The LIBRARY name is included.
    
  • Service DFHMP2018 (with APAR PI88500) indicates that an invalid name or value was specified for a static data item in a policy rule.
  • DFHMP3007 and DFHMP3008 indicate that the task for operation of application version on platform exceeded a policy threshold. Details are included for transaction ID, operation, application, version, platform, bundle ID, policy name, rule name, rule type, category, threshold, and current count.
  • Service DFHMP2018
  • Service DFHMP3009
  • Service DFHMP3010
  • Service DFHMP3011
  • Service DFHMP3012
  • DFHMP2003 now includes an optional insert when the length of the policy name is invalid.
  • DFHMP2004 now includes optional inserts if the value specified for the policySchemaVersion or policySchemaRelease attribute is invalid.
  • Service DFHMP2006 (with APAR PI88500) is issued also if an event name contains invalid characters.
  
  • DFHMQ0245 indicates that the CICS-MQ Adapter is already active.
  • DFHMQ0793 indicates that you can check for associated messages to determine whether the WebSphere® MQ message was reprocessed or moved to another queue. Previous messages might explain why the remote system could not commit.
  • Service DFHMQ0331I
  • Service DFHMQ0334I
  
  • DFHPG0114 indicates that an application entry point for operation was set because PROGRAM was replaced or deleted.
  • DFHPG0313 indicates that a PROGRAM was made unavailable as an application entry point for operation.
  • DFHPG0314 indicates an application entry point for an operation was disassociated with a PROGRAM.
  • DFHPG0503 indicates that the public version of the application entry point program for operation of the application has changed to a different version on a different platform. This supersedes the previous version on a previous platform.
  • DFHPG0113 now returns more information about the status of the application entry point. The application entry point can be set as disabled and unavailable, or disabled. The program that was adopted by the application as a program entry point can be either replaced or deleted.
 
  • DFHPI0997 now identifies the web service that is in error. You can now use the message to identify which web service timed out, particularly when multiple services are defined in the requester pipeline.
  • 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.
    
  • DFHSJ1107 indicates that a specific version of a bundle was enabled or disabled.
  • DFHSJ1108 indicates that an attempt to install a bundle into a jvmserver failed.
  • DFHSJ1109 indicates that an attempt to determine the highest semantic version of a bundle failed while processing a SET BUNDLE PHASEIN command.
  • DFHSJ1110 indicates that the phase in of a new version of a bundle completed successfully.
  • Service DFHSJ1204 (with APAR PI63005) indicates that while installing an application in a Liberty JVM server, CICS registered a linkable service.
  • Service DFHSJ1205 (with APAR PI63005) 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.
  • Service DFHSJ1206 (with APAR PI63005) indicates an attempt to link to an application in a Liberty JVM server failed and provides a reason code.
  • Service DFHSJ1207 (with APAR PI63005) indicates an attempt to link to a program in a Liberty JVM server failed because no linkable service is defined for this program name.
  • Service DFHSJ1208 (with APAR PI63005, changed with 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.
  • DFHSJ0911 now returns an error in creating a JVM server if the PROFILEDIR is over the maximum length of 240 characters.
  • Service DFHSJ1007 (with APAR PH12280) is updated to reflect changed system action when CICS detects that an abend has left a JVM in an inconsistent state.
  • DFHSJ1104 now specifies whether the OSGi bundle has not been installed or if it has not been enabled.
  • DFHSJ1105 now includes the bundle version.
  • Service DFHSJ1208
  • DFHSM0121 indicates that the RENTPGM parameter is set to PROTECT and, as a result, reentrant programs are loaded into read-only storage. Previously, a message was issued only if RENTPGM is set to NOPROTECT.
    
  • DFHSO0147 indicates the TCP/IP listener task has received a connection from a client that is not secure. The TCPIPSERVICE is defined with SSL(ATTLSAWARE) so new connections must be secured by AT-TLS.
  • Service DFHSO0123
  
  • DFHSR0002 indicates that an abend occurred at offset X. The module, application, version and platform details are included.
    
  • Service DFHTF0200 (with APAR PI54386) 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.
  
Four new messages show the status of CICS internal trace and GTF trace. These messages are shown whether the trace is stopped and started through system initialization parameter (INTTR and GTFTR), transaction (CETR and CEMT), or EXEC CICS command.
  • DFHTR0130 indicates that internal trace is being started. DFHTR0140 GTF trace is being started. DFHTR0141 GTF trace was stopped.
  • DFHTR0131 indicates that internal trace was stopped.
  • DFHTR0140 indicates that GTF trace is being started.
  • DFHTR0141 indicates that GTF trace was stopped.
  • DFHTR3004 indicates that the auxiliary trace print program, DFHTU700, could not obtain the necessary storage to generate the trace summary table. The print job continues, but the trace summary table is not produced.
  • DFHWB0804
  • DFHWB0805
  • DFHWB0806 indicates that an application entry point for an operation was associated or disassociated with a URIMAP, and now includes the operation name as an insert.
  • DFHWB0807
  • DFHWB0808
  • DFHWB0809 indicates that an application entry point for an operation was associated or disassociated with a URIMAP.
  • DFHWB0810 indicates that a URIMAP was made available or unavailable as an application entry point for an operation.
  • DFHWB1580
  • DFHWB1581 indicates that an application entry point for the operation of an application was set disabled and unavailable because URIMAP was deleted. The version and platform names are included.
  • DFHWB1582 indicates that an application entry point for the operation was set disabled and unavailable because URIMAP was deleted.
A number of messages provide information about using transactions as application entry points:
  • DFHXM0604 indicates that the specified application has set a transaction as an entry point because the resource is already defined as an entry point.
  • DFHXM0605 indicates that the specified application has set a transaction as an application entry point.
  • DFHXM0606 indicates that the application has removed the entry point from the transaction.
  • DFHXM0607 indicates that the transaction resource name is invalid.
  • DFHXM0608 indicates the availability status of a transaction after a change to an application entry point.
  • DFHXM0609 indicates that an application has changed the availability status of a transaction application entry point.
  • DFHXM0610 indicates that an application has changed the association of an application entry point from an application with a specified transaction.
  • DFHXM0611 indicates that an application entry point is unavailable because the specified transaction was deleted.

  • DFHXS1206 indicates the number of invalid attempts that preceded input of a valid password. The count of password failures is reset and CICS continues.

  • DFHXS1500 indicates that a PassTicket request failed because the request was not authorized by the external security manager.

    
  • 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 EYUXC0026S
  • Service EYUXC0027I
  • Service EYUXE0038I
  • Service EYUXE0039I
  • Service EYUXE0040I
  • Service EYUXE0041I
  • Service EYUXE0042I
  • Service EYUXE0043E
  • Service EYUXE0044E
  • Service EYUXE0045I
  • Service EYUXE0046E
  • Service EYUXE0047E
  • Service EYUXE0023E
  • EYUXL0905E now includes service level and prefix information.
  
Table 8. Changes to abend codes in CICS TS 5.3
New abend codes Changed abend codes Removed abend codes
  • Service ABSX (APAR PI54386) occurs when CICS detects that a BMS protected field was updated by the client.
  • AD31 occurs if an unexpected EXCEPTION response occurred on a local call to a directory manager (DD) domain to locate a PACKAGESET control block.
  • AD32 occurs when an error (INVALID or DISASTER response) has occurred on a local call to a directory manager (DD) domain to locate a PACKAGESET control block.
  • AD33
  • AD35 occurs when the CICS-DB2 attachment facility fails to link to the set packageset program DFHD2SPS because it is disabled.
  • AD36 occurs when the CICS-DB2 attachment facility fails to link to the set packagset program DFHD2SPS because no program definition was found.
  • AD37 occurs when the CICS-DB2 attachment facility fails to link to the set packagset program DFHD2SPS because the program could not be loaded.
  • AD38 occurs when the CICS-DB2 attachment facility fails to link to the set packagset program DFHD2SPS because the program is defined as remote.
  • AD39 occurs when the CICS-DB2 attachment facility fails to link to the set packagset program DFHD2SPS.
  • AD4A occurs when the CICS-DB2 set packageset program issues a EXEC SQL SET CURRENT PACKAGESET command fail.
  • Service AMPC
  • Service AMPD
  • AWBD occurs if a web receive either received an exception response, or failed to authenticate the user.
    

Changes to installing

  • CICS checks during initialization for the required level of hardware.
  • CICS checks during initialization that no CICS nucleus module comes from an earlier release than the release that is currently being started. This has an impact if you are using IBM HourGlass see DFHLD0110 during CICS TS 5.3 initialization when using HourGlass.
  • You can place CICS DFHRPL libraries, such as SDFHLOAD, and dynamic program LIBRARY concatenations in the EAS of an EAV DASD volume.

Changes to security

Table 9. Changes to security in CICS TS 5.3
Area CICS TS 5.3
TLS
PassTickets
Kerberos
Other authentication changes
Performance
Audit
Enhanced protection
Customization
Liberty
Obsolete security-related options

Changes to RACF classes

Table 10. Changes to RACF classes related to CICS user IDs in CICS TS 5.3
User ID CICS TS 5.3
KERBEROSUSER NEW with APAR PI85443
Table 11. Changes to other RACF classes in CICS TS 5.3
Class Profile CICS TS 5.3
PTKTDATA IRRPTAUTH.applid.userid NEW with APAR: PI60653
SURROGAT userid.DFHEXCI NEW with APAR: PH09898

Changes to CICS support for application programming languages

CICS TS 5.3 supports:
  • High Level Assembler for MVS and VM and VSE V1.6 and later
    5696-234
  • Enterprise COBOL for z/OS®
    Versions 6.1, 6.2 and 6.3, 5655-EC6
    Versions 5.1 and 5.2, 5655-W32
    Version 4.2, 5655-S71
  • z/OS V2.1/V2.2/V2.3 XL C/C++
    5655-121, Optional feature of z/OS
  • z/OS V1.10/V1.11/V1.12/V1.13 XL C/C++
    5694-A01, Optional feature of z/OS
  • IBM 64-bit SDK for z/OS, Java™ Technology Edition
    Version 8, 5655-DGH
    Version 7 Release 1, 5644-W44
    Version 7, 5644-W44
  • Enterprise PL/I for z/OS
    Versions 5.1, 5.2, and 5.3, 5655-PL5
    Version 4.5, 5655-W67
  • REXX for CICS TS
Table 12. Changes to the CICS translator in CICS TS 5.3
Procedure CICS TS 5.3
DFHZXTCL NEW: Translates, compiles, and link-edits EXCI COBOL application programs using the integrated CICS translator.
DFHZXTDL NEW: Translates, compiles, and link-edits EXCI C application programs using the integrated CICS translator.
DFHZXTEL NEW: Translates, compiles, and link-edits EXCI C++ application programs using the integrated CICS translator.
DFHZXTPL NEW: Translates, compiles, and link-edits EXCI PL/I application programs using the integrated CICS translator.

Changes to SIT parameters

Table 13. Changes to system initialization parameters in CICS TS 5.3
SIT CICS TS 5.3
ENCRYPTION DEPRECATED: Replaced by MINTLSLEVEL, although ENCRYPTION remains available for compatibility with previous releases.

REMOVED OPTION: SSLV3
HTTPSERVERHDR NEW: Sets the value for HTTP Server field
HTTPUSRAGENTHDR NEW: Sets the value for HTTP User-Agent field
KERBEROSUSER Service NEW (APAR PI85443): Specifies the user ID associated with the Kerberos service principal for the CICS region.

The default is the region user ID.
MINTLSLEVEL NEW: Replaces ENCRYPTION.

NEW OPTION with APAR: TLS10ONLY
NQRNL NEW: Specifies that z/OS global resource serialization uses RNL processing for enqueue and dequeue requests from CICS.
SNPRESET Service NEW (APAR PI85452): Allows userid terminals that are associated with the same user ID to share a single ACEE.
SOTUNING NEW: Controls the performance tuning for HTTP connections.
STGPROT CHANGED: The default is changed to YES.
TRTABSZ CHANGED: The default is increased to 12MB.
ENCRYPTOKEN CHANGED: ENCRYPTOKEN parameter returns a 4-byte encryption token when the TOKENTYPE is KERBEROS.
XPTKT Service NEW (APAR PI60604): Instructs CICS to perform a RACF check before it generates a PassTicket. The default is NO.

Changes to JVM profiles

Table 14. Changes to JVM profiles in CICS TS 5.3
Option CICS TS 5.3
_DFH_UMASK NEW:

Compatible with all types including the classpath JVM server
CICS_WLP_MODE Service NEW (APAR PI58375): Compatible with Liberty JVM server

Choose the level of integration between CICS and Liberty.
com.ibm.cics.jvmserver.unclassified.tranid NEW compatible with: Liberty JVM server and OSGi JVM server

Can be used to change the default transaction used for unclassified work run in a JVM server.
com.ibm.cics.jvmserver.unclassified.userid NEW compatible with: Liberty JVM server and OSGi JVM server

Can be used to change the default userid under which unclassified work is run in a JVM server.
com.ibm.cics.jvmserver.wlp.defaultapp NEW: Instructs CICS to install a default application which can be used to verify that the server has installed and started correctly.
com.ibm.cics.jvmserver.wlp.jta.integration NEW: Enables CICS JTA integration with Liberty, when Liberty JTA transactions are present.
com.ibm.cics.jvmserver.wlp.optimize.static.resources.extra NEW: If com.ibm.cics.jvmserver.wlp.optimize.static.resources=true, then you can provide a custom list of extra static resources for optimization.
DISPLAY_JAVA_VERSION CHANGED: This option now defaults to true.
JVMTRACE CHANGED: default location changed from WORK_DIR to WORK_DIR/applid/jvmserver unless LOG_PATH_COMPATABILITY=true
LOG_FILES_MAX NEW: Allows you to specify how many JVM server log files should be retained in the USS filing system
LOG_PATH_COMPATIBILITY NEW: The default value for this behavior is LOG_PATH_COMPATIBILITY=false which provides a consolidated log output behavior. When LOG_PATH_COMPATABILITY=true, the JVMSERVER will revert to previous release behavior, which is not to consolidate log output.
OSGI_CONSOLE NEW: adds the JARs necessary to attach and run an OSGi console to your OSGi framework in the JVMSERVER
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.
STDOUT CHANGED: default location changed from WORK_DIR to WORK_DIR/applid/jvmserver unless LOG_PATH_COMPATABILITY=true
STDERR CHANGED: default location changed from WORK_DIR to WORK_DIR/applid/jvmserver unless LOG_PATH_COMPATABILITY=true
TZ CHANGED: TZ setting is now respected for JVMSERVER timestamped files

Changes to control tables

Table 15. Changes to control tables in CICS TS 5.3
Control table CICS TS 5.3
DFHMCT TYPE=INITIAL CHANGED: TSQUEUE option includes information about requests to shared temporary storage queues.
DFHMCT TYPE=RECORD CHANGED: allows for the new DFHTEMP fields to count TS queue requests.
DFHXCOPT 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 16. Changes to the system programming interface commands in CICS TS 5.3
Command CICS TS 5.3
INQUIRE DISPATCHER OBSOLETE: ACTJVMTCBS and MAXJVMTCBS options
INQUIRE ENQMODEL THREADSAFE
INQUIRE EPADAPTER Service CHANGED (APAR PI55134): New CVDA, DSIE on DATAFORMAT option.
INQUIRE IPCONN CHANGED: The value in the PARTNER option on the INQUIRE IPCONN command is affected by the new system initialization parameter, HTTPUSRAGENTHDR.
INQUIRE JOURNALMODEL THREADSAFE
INQUIRE JOURNALNAME THREADSAFE
INQUIRE JVMSERVER CHANGED: when running INQUIRE JVMSERVER on a JVM server with an instance of Liberty inside it, the baseline level of current thread count will not be 0, even if no threads are running. This is because threads are now pooled within Liberty for efficiency.
INQUIRE PROGRAM Service CHANGED (APAR PI63005): 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 REQID CHANGED: INTERVAL and TIME options are no longer mutually exclusive.
INQUIRE RRMS THREADSAFE
INQUIRE STORAGE THREADSAFE
INQUIRE STREAMNAME THREADSAFE
INQUIRE SUBPOOL THREADSAFE
INQUIRE SYSTEM CHANGED: New value on CICSTSLEVEL to reflect latest version, release, or modification number. New value on RELEASE to reflect latest level of CICS code.
INQUIRE TASK THREADSAFE
INQUIRE TASK LIST THREADSAFE
INQUIRE TCLASS THREADSAFE
INQUIRE TCPIP THREADSAFE
INQUIRE TCPIPSERVICE THREADSAFE
INQUIRE TDQUEUE THREADSAFE
INQUIRE TRANCLASS THREADSAFE
INQUIRE TRANSACTION CHANGED:

New options: APPLICATION, APPLMAJORVER, APPLMICROVER, APPLMINORVER, AVAILSTATUS, OPERATION, PLATFORM
INQUIRE TSMODEL THREADSAFE
INQUIRE TSPOOL THREADSAFE
INQUIRE TSQUEUE/TSQNAME THREADSAFE
INQUIRE UOW THREADSAFE
INQUIRE UOWENQ THREADSAFE
INQUIRE WEB THREADSAFE
DISCARD ENQMODEL THREADSAFE
DISCARD JOURNALMODEL THREADSAFE
DISCARD JOURNALNAME THREADSAFE
DISCARD TCPIPSERVICE THREADSAFE
DISCARD TDQUEUE THREADSAFE
DISCARD TRANSCLASS THREADSAFE
DISCARD TSMODEL THREADSAFE
PERFORM SECURITY REBUILD THREADSAFE
PERFORM SSL REBUILD THREADSAFE
PERFORM STATISTICS RECORD OBSOLETE: BEAN, CORBASERVER, JVMPOOL, JVMPROFILE, and REQUESTMODEL options
SET BUNDLE NEW: new COPY option to register a new version of an OSGi bundle with the OSGi framework to replace any version currently registered.
SET BUNDLE PHASEIN CHANGED: New option: COPY
SET DISPATCHER OBSOLETE: ACTJVMTCBS and MAXJVMTCBS options
SET ENQMODEL THREADSAFE
SET JOURNALNAME THREADSAFE
SET TCLASS THREADSAFE
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 TCPIP THREADSAFE
SET TCPIPSERVICE THREADSAFE
SET TDQUEUE THREADSAFE
SET TRANCLASS THREADSAFE
SET TSQUEUE THREADSAFE
SET UOW THREADSAFE
SET WEB THREADSAFE

Changes to CICS-supplied transactions

Table 17. Changes to CICS-supplied transactions in CICS TS 5.3
Transaction Security Category CICS TS 5.3
CEMT 2
  • Service CHANGED (APAR PI55134): Support for DSIE XML format added to the CEMT INQUIRE EPADAPTER command.
  • CHANGED: New options added to the CEMT INQUIRE TRANSACTION command: APPLICATION, APPLMAJORVER, APPLMINORVER, APPLMICROVER, OPERATION, PLATFORM, AVAILSTATUS
  • Service CHANGED (APAR PI63005): The CMET INQUIRE PROGRAM command supports a 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.
  • CHANGED: New option PHASEIN added to CEMT SET BUNDLE.
  • Service CHANGED (APAR PI98569): CEMT SET TASK has been enhanced as follows: 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 1 Service NEW (APAR PI97207): Provides tie-up records for VSAM files to a replication log at specified intervals.
CHCK 1 Service NEW (APAR PI76965): Health Checker long running system task
CMPE 1 Service NEW (APAR PI83667): Policy deferred rule evaluation task

Changes to CICS monitoring

Table 18. Changes to monitoring data in CICS TS 5.3
Data CICS TS 5.3
Performance data in group DFHCICS NEW: new field, NCGETCT, to count the number of EXEC CICS GET COUNTER and GET DCOUNTER requests issued by a task.
Performance data in group DFHTASK NEW: new field 429, DSAPTHWT, for the dispatcher to allocate pthread wait time.

NEW: new fields to count the number of TS GET and TSS PUT requests issued by a user task

CHANGED: field 044 (TSGETCT) counts the number of TS GET requests to either auxiliary or main temporary storage. Field 092 (TSTOTCT) includes the number of requests to shared TS queues, as counted in fields TSGETSCT (READQ shared) and TSPUTSCT (WRITEQ shared).
Performance data in group DFHTEMP NEW FIELDS: TSGETSCT, TSPUTSCT

CHANGED: TSTOTCT includes the count for the new TSGETSCT and TSPUTSCT fields.
Transaction resource class data CHANGED:
  • All TS queues: The length of the transaction resource record is extended by 120 bytes for each TS queue.
  • MNR_TSQUEUE_GET, MNR_TSQUEUE_PUT and MNR_TSQUEUE_PUT_AUXQ: No longer count the number of GET and PUT requests to a shared TS queue. This is now done in the new fields MNR_TSQUEUE_GET_SHR and MNR_TSQUEUE_PUT_SHR.
  • MNR_TSQUEUE_GET_ITEML, MNR_TSQUEUE_PUT_ITEML and MNR_TSQUEUE_PUT_ITEML: No longer include the length of items written to a shared TS queue. This is now done in the new fields MNR_TSQUEUE_GET_SHR_ITEML and MNR_TSQUEUE_PUT_SHR_ITEML.
  • NEW FIELDS: MNR_TSQUEUE_GET_SHR, MNR_TSQUEUE_PUT_SHR, MNR_TSQUEUE_GET_SHR_ITEML and MNR_TSQUEUE_PUT_SHR_ITEML to count the number of TS GET and TS PUT requests issued by a user task, and to count the total length of all items got from, or written to, this shared TS queue.

Changes to statistics

Table 19. Changes to statistics in CICS TS 5.3
Statistics CICS TS 5.3
Monitoring domain: global statistics NEW FIELDS: MNGCPUT, MNGTONCP, and MNGOFLCP, to show the accumulated transaction CPU time for each completed transaction
Pipeline definition NEW FIELD: PIPELINE JSON_JAVA_PARSER, in Resource statistics, indicates the optimization attribute for a PIPELINE that uses a configuration file that contains a provider_pipeline_json element.
TCP/IP: global statistics NEW FIELDS: to show the effects of performance tuning for HTTP connections
Transactions: resource statistics NEW FIELD: XMR_TRAN_ENTRYPOINT identifies a transaction as an application entry point
Transient data: resource statistics - intrapartition transient data queues NEW FIELD: TQRPNITM reports the peak depth of the transient data queue.
URIMAP definitions: global statistics NEW: new field, WBG_URIMAP_DIRECT_ATTACH, reports the number of HTTP requests that are processed by direct alias attach instead of through the CWXN transaction.

Changes to GLUEs and TRUEs

Table 20. Changes to global user exits and task-related user exits in CICS TS 5.3
Exit CICS TS 5.3
Message domain exit XMEOUT CHANGED: Change to application version format affecting UEPINSA
XRSINDI CHANGED: New values UEIDEARB and UEIDPKST for UEPIDTYP parameter

New parameter UEPPLATTK
Exit XSNON NEW: new parameter, UEPSGTYP, identifies if the SIGNON was by USERID or TOKEN.
Task manager TCB indicators in DFHUEPAR CHANGED: UERTSOTR (T8 for Liberty threads)

Changes to XPI

Table 21. Changes to the exit programming interface in CICS TS 5.3
Functional area Call CICS TS 5.3
Program management The BIND_CHANNEL call on DFHPGCHX NEW to bind a channel to a task.
Monitoring The SET_TRACKING_DATA call on DFHMNTDX NEW to sets the transaction tracking origin data tag for the issuing task.

Changes to user-replaceable programs

Table 22. Changes to the user-replaceable programs in CICS TS 5.3
Program CICS TS 5.3
DYRABNLC

Distributed routing program

 CHANGED: DYRABNLC is now set when connections are unavailable to Db2, IMS, IBM MQ, or VSAM RLS
DFHBMSX Service NEW (APAR PI54386): 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 was detected when issuing BMS RECEIVE MAP commands.
DFHDSRP CHANGED:

New tokens in DFHDYPDS copybook: DYRCLOUD, DYRPLATFORM. DYRAPPLICATION, DYRAPPLVER, DYRAPPLMAJOR, DYRAPPLMINOR, DYRAPPLMICRO, and DYROPERATION

DYRVER token is incremented by 1.

Changes to CICS policies

Table 23. Changes to policy system rules in CICS TS 5.3
System rule CICS TS 5.3
All system rules Service CHANGED (APAR PI88500): Introduced support for static data capture items and event names for policy events
Db2 connection status NEW with APAR PI83667
File open status NEW with APAR PI83667
File enable status NEW with APAR PI83667
Message NEW with APAR PI83667
Transaction abend NEW with APAR PI83667
Transaction class tasks NEW with APAR PI83667
User tasks NEW with APAR PI83667
Table 24. Changes to policy task rules in this release
Task rule This release
All task rules Service CHANGED (APAR PI88500): Introduced support for static data capture items and event names for policy events

Changes to dump

Table 25. Changes to CICS dump in CICS TS 5.3
  CICS TS 5.3
Formatted system dump NEW: the TK keyword allows you to include a summary table for all tasks, or a specified task, in a formatted system dump. A new module, DFHTKDUF, is added to the CICS-supplied sample system dump formatting program.

Changes to samples

Table 26. Changes to the samples provided with CICS in CICS TS 5.3
Sample CICS TS 5.3
DFH$DPLY NEW: Annotated DFHDPLOY JCL to deploy, undeploy, and optionally set a sample bundle and application in a CICSplex. The sample is supplied in CICSTS53.CICS.SDFHSAMP.

Changes to CICSPlex SM resource tables

Table 27. Changes to the resource tables provided by CICSPlex SM in CICS TS 5.3. There are also some changes to the help text to reflect changes to fields and options, or in response to feedback.
Resource table CICS TS 5.3
ATTR CHANGED: update to validity and not modifiable bit mappings for E700
BUNDLE CHANGED: new PHASEIN action
CRESDB2P NEW: Topology base table for Db2 packageset resource table
DB2PKGST NEW: Db2 packagesets
EPADAPT Service CHANGED (APAR PI55134): new DSIE value for DATAFORMAT

CICSPlex® SM view: CICS operations views > Application operations views > Event processing adapter
ERMCDB2P NEW: CICSPlex SM notification resource table for resource map events for Db2 packagesets
FILEDEF CHANGED: PASSWORD field is obsolete
HTASK CHANGED:

Includes counts for requests to a named counter server

New fields: TSGETSCNT, TSPUTSCNT, NCGETCNT, WBJSNRQL, WBJSNRPL and DSAPTHWT

JVMSERV CHANGED: SRVTHRWTIME field data type changed to a store clock
LOCTRAN CHANGED: new fields: APPLICATION, PLATFORM, OPERATION, APPLMAJORVER, APPLMINORVER, APPLMICROVER and AVAILSTATUS fields
METAPARM CHANGED: updated the validity bit mappings for E700
MONITOR CHANGED: update MNGAUTRT and MNGPUTRT field data types to an interval timestamp delta. New fields: MNGCPUT, MNGTONCP and MNGOFLCP
OBJACT CHANGED: updated the validity bit mappings for E700
OBJECT CHANGED: updated the validity bit mappings for E700
PROGDEF CHANGED: updated the JVMCLASS field for OSGi and Liberty
REMTRAN CHANGED: new fields: APPLICATION, PLATFORM, OPERATION, APPLMAJORVER, APPLMINORVER, APPLMICROVER and AVAILSTATUS
TASK CHANGED:

Includes counts for requests to a named counter server

New fields: WBSRSPBL field. Added TSGETSCNT, TSPUTSCNT, NCGETCNT, WBJSNRQL, WBJSNRPL and DSAPTHWT
TASKASSC CHANGED: new fields: ODSERVERPORT and ODTCPIPS
TASKTSQ CHANGED: new fields: TSQGETSHR, TSQPUTSHR, TSQPUTSHR and PUTSHRITEML
TCPIPGBL CHANGED: new fields: SOTUNING, TIMATACCLIM, LTIMPAUSLIST, STOPPINGPERS, TIMSTOPPERS, LTIMSTOPPERS, TIMMNONPERS, TIMDISCATMAX and PAUSINGLIST
TCPIPS CHANGED: new value ATTLAWARE on SSLTYPE
URIMAP CHANGED: summary option for fields APPLICATION, PLATFORM and OPERATION changed to DIFF
URIMAPGBL CHANGED: DRCTATTCOUNT field
WLPSERV NEW: Liberty JVM server LINK enabled services

Changes to CICSPlex SM parameters

Table 28. Changes to CICSPlex SM parameters in CICS TS 5.3
Parameter CICS TS 5.3
CACHEDSNUM Service NEW with APAR PH00673: Specifies the number of data spaces that the CMAS creates for each CICSPlex SM component. For use under the direction of IBM Support.

Changes to CICSPlex SM WUI server initialization parameters

Table 29. Changes to the WUI server initialization parameters used by CICSPlex SM in CICS TS 5.3
System parameter CICS TS 5.3
CMCIAUTH NEW: Specifies the settings for the CMCI TCPIPSERVICE AUTHENTICATE attribute.
CMCISSL NEW: Specifies the settings for the CMCI TCPIPSERVICE SSL attribute.
TCPIPSSL Service CHANGED (APAR PI94706): New value ATTLSBASIC, to support Application Transparent Transport Layer Security (AT-TLS).

Changes to documentation

Upgrading
CHANGED: Redesigned into a summary of changes and actions between releases.
STABILIZED PDFs
  • Upgrading from CICS TS Version 3.1
  • Upgrading from CICS TS Version 3.2
  • Upgrading from CICS TS Version 4.1
  • Upgrading from CICS TS Version 4.2
  • Upgrading from CICS TS Version 5.1
  • Upgrading from CICS TS Version 5.2