PK77912: A WLMDEF DISCARD DOES NOT DELETE THE WLMDEF'S SCOPE WHICH CAN RESULT IN MSGEYUWI0084E

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You will see the message +EYUWI0084E WLM Query Workload was
  unable to locate object (2), key (CICSAPPL), update ignored
  after a DISCARD of the WLMDEF is done.
  It looks like CPSM does not make any changes to update the
  WLMSDEF's scope and leave it be in some of our lists.
  These lists are what an exporting CMAS uses to send information
  to an importing CMAS. The importing CMAS builds its initial
  information about AORs by the current scopes of the WLMSPEC
  and installed  WLMDEFs.  Then it processes the information
  from the exporting CMAS, which as a result of a DISCARD may have
  an entry to an AOR that is no longer part of the current scopes.
  This then will trigger the message +EYUWI0084E.
  Additional Symptom(s) Search Keyword(s):
  KIXREVMV
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V3R2M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When an active WLMDEF is discarded from *
  *                      a CPSM WLM workload, if a target region *
  *                      (AOR) that is within the WLMDEF's SCOPE *
  *                      is not part of any other SCOPE          *
  *                      associated with the workload, it will   *
  *                      not be removed from the workload.  This *
  *                      may result in message EYUWI0084E being  *
  *                      issued by other CMASes when they        *
  *                      subsequently import the workload.       *
  *                                                              *
  *                      The text of the EYUWI0084E message will *
  *                      be similar to the following:            *
  *                                                              *
  *                        EYUWI0084E  WLM Query Workload was    *
  *                                    unable to locate object   *
  *                                    (2), key (<aorname>),     *
  *                                    update ignored.           *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be restarted.  Note    *
  *                 that the restarts do not need to occur at    *
  *                 the same time.                               *
  ****************************************************************
  When a WLMDEF is discarded, method EYU0WMDF (WMDF) is called in
  all CMASes that have the workload installed to process the
  discard request.  As part of its processing, WMDF should call
  method EYU0WMRA (WMRA) to process the target regions that are
  part of the WLMDEF's SCOPE.  If a target region that is part of
  the SCOPE is not associated with any other SCOPEs still active
  for the workload, WMRA will remove the target region from the
  workload.  A logic error in WMDF results in WMRA not being
  called.  As a result, the CMASes where WMDF runs will not remove
  target regions if appropriate.
  
  When a subsequent CMAS imports the workload from a CMAS where
  the target region was not removed properly, that CMAS will
  export to the importing CMAS an indication that the target
  region should be part of the workload.  Since the importing CMAS
  will have already built its target region list based upon the
  workload's active SCOPEs, it will not build an entry for the
  target region that should have been removed.  When it processes
  the indication from the exporting CMAS that the target region
  should be included, it will fail that request, issuing the
  EYUWI0084E error message.  The workload import will then
  continue.
  

Problem conclusion

• WMDF has been updated to properly call WMRA when a WLMDEF is
  discarded.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

  PK78006

• APAR is sysrouted TO one or more of the following:

  UK42920

Modules/Macros

•    EYU0WMDF
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R50M PSY UK42920

     UP09/01/10 P F901

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.