A fix is available
APAR status
Closed as program error.
Error description
You try to make changes to an active workload in CPSM. Perhaps you are trying to change the routing algorithm, install a WLMDEF, or force discard a dynamic transaction. Your request fails. On the WUI, if you attempt the change again, you may see MAL Pending (24) messages. . In the AUX trace from the CMAS, you will see trace entries from method WSCL with debug text of ELECTFRA. . This trace entry is telling us that there is a discrepancy with field WRKD_LOCK_SEQ in the workload descriptor. This field is a counter used as part of a locking mechanism. Because CPSM must maintain integrity of a workload definition across all CMASes, the CMASes use this locking mechanism and update the WRKD_LOCK_SEQ field when a change has been made. If this field gets out of sync between different CMASes managing a workload, the ELECTFRA situation can occur. . Additional Keywords/Symptoms: election fraud kixrevsvr
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V5R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: You are modifying elements of an * * active workload in CPSM. Perhaps you * * are trying to change the routing algo- * * rithm, install a WLMDEF, or discard a * * dynamic transaction. Your request * * fails. In the WUI, if you repeat the * * update, you might see message * * . * * EYUVC1272I Action ( action ) failed. * * MAL Pending (24). * * . * * If you format the AUXTRACE from the * * CMAS, you see trace entries from method * * WSCL (EYU0WSCL - WLM Cross-plex Lock * * Facility) with debug text of ELECTFRA. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes must be recycled to pick * * up the new code. Note that CMASes do not * * need to be brought down and restarted at * * the same time. * **************************************************************** To maintain the integrity of a workload's definitions across all CMASes, the workload descriptor for each workload managed by a CMAS contains a counter which is transmitted in the Method Argument List (MAL) for method WSCL when the workload is locked to allow an action to be performed. When the action completes in each CMAS which manages the workload, the task which holds the lock is posted to release the lock, increment the counter, and store the updated count in the local CMAS's workload des- criptor. When a workload lock request is broadcast to the CMASes that manage the workload, each CMAS checks the lock counter against the counter value stored in the local workload descriptor. If the local count is higher than the count transmitted with the lock request, then the lock request is rejected and the ELECTFRA trace is written. A logic error makes it possible that an action could be pro- cessed in one CMAS under a lock requested for another action. This means that the lock counter in that CMAS's workload desc- riptor will only be incremented once, while the counter in other CMASes will have been incremented twice. If an action is broad- cast from that CMAS, the lock request will be rejected by other CMASes because the incoming counter is lower than the counters in the other CMASes' workload descriptors. Installing or discarding a WLMDEF in an active workload and updating the routing algorithm for an active TRANGRP cause a message to be written to the EYULOG, but updating the status of an active TRANGRP, forcing an active affinity, and discarding a dynamic transaction from an active workload do not produce a logging message.
Problem conclusion
Modules EYU0WMDA (WMDA - Force Active Affinity), EYU0WMDF (WMDF - Discard Active WLMDEF), EYU0WMDT (WMDT - Discard Active Dynamic Transaction), EYU0WMUT (WMUT - Update Active TRANGRP State), and EYU0WMDI (WMDI - Install WLMDEF in Active Workload) were updated to increment the counter in the local Workload Descriptor before posting the lock task to release the workload lock. This insures that the counter will be incremented for each action request even if it is processed under the lock for another action. A flag was added to the MAL for module EYU0WSLW (WSLW - WLM Lock Requestor Task). A similar flag was added to the MAL for module EYU0WSRL (WSRL - WLM Remote Lock Service), which will be set when WSRL is broadcast from a CMAS which has the fix for this APAR applied. When WSRL is called with the NO_UPDT_SEQ flag set, it means that the calling CMAS will place the current counter value in the MAL for the action method. WSRL will then set the flag in the MAL for WSLW, indicating that the sequence counter will be updated by the action method when it completes in the local CMAS. If the flag is not set, the calling CMAS did not have this fix applied, and WSLW will then increment the counter when posted by the action method. A message will be written to the CMAS's EYULOG when an active affinity is forced, a dynamic transaction is discarded from an active workload, or the status of an active TRANGRP is changed.
Temporary fix
********* * HIPER * ********* FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM86196
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
80M
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt
Submitted date
2013-04-03
Closed date
2013-07-16
Last modified date
2015-03-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK95862
Modules/Macros
EYU0WADA EYU0WADF EYU0WADT EYU0WAUT EYU0WMCL EYU0WMDA EYU0WMDF EYU0WMDT EYU0WMUT EYU0WMWI EYU0WMWU EYU0WSCL EYU0WSLW EYU0WSRL EYU9WMR3 EYU9WMR4 EYU9WMRU EYUMCWMC EYUMCWME EYUMCWMK
GC34288700 |
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R80M PSY UK95862
UP13/07/22 P F307
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:
04 March 2015