IBM Support

PM86196: UNABLE TO MAKE CHANGES TO INSTALLED CPSM WORKLOAD. MAL PENDING.

A fix is available

Subscribe

You can track all active APARs for this component.

 

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:

    PM85761

  • 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
    

Publications Referenced
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