A fix is available
APAR status
Closed as program error.
Error description
XMAT increments and decrements the Task Load count for System Tasks for RS domain. These counts should only be adjusted for non-system tasks. . NOTE: This does NOT mean that regions with the fix applied and regions without the fix applied would have a dramatic task count difference. System tasks are not counted as part of the load count for CPSM WLM routing anyway. The problem being addressed here is that without the fix, when a system task ends, we incorrectly decrement the task count. However, upon the next attach of a user task, the count corrects itself. If the region is idle and no new user tasks are being attached, the count corrects itself at the next CPSM heartbeat, which occurs every 15 seconds. So in a region with a steady flow of work, there would only be a fraction of a second where the task count was too low by one task before the count was correct again.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Users of CICS Transaction Server for z/OS * * V5.1, V5.2 and V5.3. * **************************************************************** * PROBLEM DESCRIPTION: CPSM Workload Manager may be passed * * incorrect CICS task counts when the * * target region (AOR) is in Sysplex * * Optimized Routing state. * **************************************************************** CPSM Workload Manager is passed incorrect CICS task counts when the target region (AOR) is in Sysplex Optimized Routing state. This can cause routing regions to perceive a target region as being more lightly loaded than it actually is. This effect is caused by the initialisation and termination of a CICS system task which should have no recognizable effect on the task load count for a CICS region. However, due to a logic error in the CICS Region Status Transaction Manager program (DFHXMTA), the region status transaction manager gate module (DFHRSXM), is being called both for initialisation and termination of a CICS system transaction causing the load count reported in the region status record to be one less than its actual value.
Problem conclusion
This has been addressed by adding a check to DFHXMTA to only call DFHRSXM if the task being initialised or terminated is not a CICS system task.
Temporary fix
Comments
APAR Information
APAR number
PI76740
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
800
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-02-16
Closed date
2017-04-03
Last modified date
2017-05-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PI76937 UI46106 UI46107 UI46108 UI46111 UI46112 UI46113 UI46114
UI46115 UI46116
Modules/Macros
DFHRSXM DFHRSXMT DFHXMAB DFHXMAT DFHXMER DFHXMERT DFHXMRSD DFHXMRSH DFHXMRSL DFHXMTA DFHXMXE
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R000 PSY UI46114
UP17/04/05 P F704 ¢
R002 PSY UI46115
UP17/04/05 P F704 ¢
R003 PSY UI46116
UP17/04/05 P F704 ¢
R800 PSY UI46106
UP17/04/05 P F704 ¢
R802 PSY UI46107
UP17/04/05 P F704 ¢
R803 PSY UI46108
UP17/04/05 P F704 ¢
R900 PSY UI46111
UP17/04/05 P F704 ¢
R902 PSY UI46112
UP17/04/05 P F704 ¢
R903 PSY UI46113
UP17/04/05 P F704 ¢
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.1","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.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
01 May 2017