PK05671: EYU0WDIN LOOP GOAL MODE PERCENTILE TOR EYU9XLOP

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A loop occurs in EYU0WDIN at label UPDATE_CELL_CS.. This occurs
  if the WLMSPEC in CPSM has its Algorithm Type set to GOAL and
  the routing region(s) for this workload is in a Service Class
  where the Response Time is specified as PERCENTILE instead of
  AVERAGE RESPONSE TIME.
  CPSM 3.1 only recognizes AVERAGE RESPONSE TIME.
  As the first routed transaction is terminating, WDIN falls
  through to label UPDATE_CELL_CS due to a branch not taken in
  UPDATE_RESPTIM.
  ADDITIONAL KEYWORDS:  WGSC_POLAVG, WGSC_POLTYP, WGSC_POLPRC
  

Local fix

• USE AVERAGE RESPONSE TIME IN THE SERVICE CLASS DEFINITIONS, OR
  SPECIFY QUEUE AS THE ROUTING ALGORITHM IN THE WLMSPEC
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V3R1M0 Users.                *
  ****************************************************************
  * PROBLEM DESCRIPTION: An AICA abend may occur around offset   *
  *                      x'764' in EYU0WDIN when the CICSPlex SM *
  *                      dynamic routing program (EYU9XLOP) is   *
  *                      invoked for Route Termination.          *
  *                                                              *
  *                      The abend occurs if the routing region  *
  *                      is associated with a CICSPlex SM work-  *
  *                      load specification (WLMSPEC) that has   *
  *                      the workload algorithm set to GOAL and  *
  *                      the transaction being routed is         *
  *                      associated with an MVS WLM service      *
  *                      class that has a goal type of 'Response *
  *                      time with percentile'.                  *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be recycled  *
  *                 to pick up the new code.  Note that the      *
  *                 restarts do not need to be done at the same  *
  *                 time.                                        *
  ****************************************************************
  When the CICSPlex SM dynamic routing program is invoked in a
  routing region, method EYU0WTCL (WTCL) is invoked to classify
  the work to be routed. One of the factors set by WTCL, is the
  Performance Index (PI). The PI is a measurement of whether the
  work has been meeting it's goal. A value of 1 indicates the
  work is meeting it's goal, a value less than 1 indicates that
  the work is exceeding the goal and a value greater than 1
  indicates that the work is failing to meet the goal.
  
  The PI is generated based on the MVS WLM service class
  associated with the work. CICSPlex SM can generate the PI
  for MVS WLM service classes that specify average response
  time goals. If the MVS WLM service class specifies some other
  type of MVS WLM response time goal, for example, a percentile
  response time, then WTCL should set the corresponding PI to
  1.
  
  In the reported case, WTCL is calculating a PI and setting a
  flag for a percentile goal. This flag is being checked by
  EYU0WDIN, and the loop is occurring because of an incorrect
  value being used on a compare and swap instruction.
  

Problem conclusion

• WTCL has been change to ensure that a PI of 1 is set for work
  associated with service classes that specify a percentile
  goal. No flags will be set on that will cause WDIN to attempt
  the compare and swap logic that was in error.
  

Temporary fix

•             *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK03844

Modules/Macros

•    EYU0WDIN EYU0WMSC EYU0WTCL
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK03844

     UP05/06/01 P F505

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.