A fix is available
APAR status
Closed as program error.
Error description
Termination in a MAS uses EXEC CICS SET TASK() FORCEPURGE
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V5R4M0 Users. * **************************************************************** * PROBLEM DESCRIPTION: During termination or restart of the * * CPSM agent in a MAS, WUI or SMSS * * region, one or more MAS tasks may not * * be properly terminated. When that * * occurs, one or both of the following * * messages will be issued: * * * * EYUNL0914E Unable to purge CICSPlex * * SM system task - * * TRANID(<tranid>) * * TASKID(<taskid>). * * * * EYUXL0160E Unable to purge CICSPlex * * SM system task - * * TRANID(<tranid>) * * TASKID(<taskid>). * * * * If the above messages occur when the * * region is being terminated, the tasks * * will terminate at region termination. * * * * If the above messages occur when the * * CPSM agent is being terminated but the * * region remains active, then subsequent * * attempts to restart the CPSM agent in * * the region using the COLM transaction * * may result in abends or further * * failures. This will require that the * * region be terminated in order for the * * CPSM agent to be restarted. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes, MASes and SMSS regions * * must be restarted. Note that the restarts * * do not need to occur at the same time. * **************************************************************** With CICS TS V5.4, tasks that are internally initiated by CICSPlex SM in a MAS, WUI server or SMSS running CICS 0710, are changed to run under a CICS system transaction. During termination or restart of the CPSM agent in a MAS, WUI or SMSS region, CICSPlex SM will notify all components to terminate. For components with tasks that fail to terminate gracefully in a timely manner, CICSPlex SM will eventually issue an EXEC CICS SET TASK SPI command to force purge the tasks. As force purge requests against tasks running under system transactions are not possible through the CICS SPI, such requests will fail against those tasks, resulting in one or more of the following messages: EYUNL0914E Unable to purge CICSPlex SM system task - TRANID(<tranid>) TASKID(<taskid>). EYUXL0160E Unable to purge CICSPlex SM system task - TRANID(<tranid>) TASKID(<taskid>). The tasks will remain active until the region terminates. If the region remains active, any attempt to restart the CPSM agent using the COLM transaction may fail, requiring the region to be restarted to allow the CPSM agent to start.
Problem conclusion
To allow CICSPlex SM to force purge system transactions that fail to terminate, the following changes have been made: - Domain gate DFHXMIQ has been updated to allow CICSPlex SM to force purge CICSPlex SM tasks that fail to terminate in time. - Method EYU0NLRT has been updated to call domain gate DFHXMIQ to force purge CICSPlex SM tasks when the CICS release is greater than CICS 0700. If this is the first force purge issued during termination by either method NLRT or method XLTP, a system dump is requested first. - Method EYU0XLTP has been updated to call domain gate DFHXMIQ to force purge CICSPlex SM tasks when the CICS release is greater than CICS 0700. If this is the first force purge issued during termination by either method XLTP or method NLRT, a system dump is requested first. - Method EYU9XLEV has been updated to reset the dump flags in a MAS region, when the MAS agent is being restarted because of the connected CMAS terminating. - MAS shutdown program EYU9NXTM has been updated to detect immediate shutdowns and bypass waiting for the MAS agent to terminate before returning to CICS. - Messages EYUXL0033I and EYUNL0148W have been updated to reflect the new system dump that may be taken when those messages are issued. - Field level help for resource tables WLMATARG (Active target regions)and WLMAWAOR (Target region in active workload) has been updated for the ROUTINGLOAD field in both resource tables. The update reflects changes to routing behaviour related to the usage of system transactions within CICS TS V5.4.
Temporary fix
Comments
APAR Information
APAR number
PI83584
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
10M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-06-26
Closed date
2017-10-09
Last modified date
2017-11-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI50943 UI50944 UI50945
Modules/Macros
CJC0NLRT CJC0XLTP CJC9XLEV CJD0NLRT CJD0XLTP CJD9XLEV CJE0NLRT CJE0XLTP CJE9XLEV CJF0NLRT CJF0XLTP CJF9XLEV CJG0NLRT CJG0XLTP CJG9XLEV CJH9XLEV DFHXMATH DFHXMIQ DFHXMIQH DFHXMIQT DFHXMIQX DFHXMIQY DFHXMTRI EYU0NLRT EYU0XLTP EYU9NXTM EYUE2484 EYUE2659 EYUK2484 EYUK2659 EYUMCNLC EYUMCNLE EYUMCNLK EYUMCXLC EYUMCXLE EYUMCXLK EYUS2484 EYUS2659
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R100 PSY UI50943
UP17/10/16 P F710
R103 PSY UI50945
UP17/10/16 P F710
R10M PSY UI50944
UP17/10/16 P F710
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 November 2017