PH20686: CPSM: WORKLOAD ROUTING NOT HONORING WLMHEALTH VALUE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• In a CICSplex environment, while testing CPSM workload routing
  the WLMHEALTH value doesn't seem to be honored. When the CICS
  region (MAS) is started, CICS is opening WLM Health fully to
  100%. Then at a later point if it is closed via a SET WLMHEALTH
  IMMCLOSE request, the WLM Health value should get set to 0%.
  However it does not seem to take effect and therefore remains
  at 100%. If you set WLMHEALTH open again and then re-close it,
  it does properly take effect.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: CICSPlex SM V5R4M0 or V5R5M0 users.          *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS WLMHEALTH is closed through the    *
  *                      use of a SET WLMHEALTH IMMCLOSE         *
  *                      command, but the new health value is    *
  *                      not made available to CICSPlex SM.      *
  *                      CPSM Workload Management (WLM)          *
  *                      routing remains unaffected.             *
  ****************************************************************
  * RECOMMENDATION: All CICSPlex SM MAS regions must be          *
  *                 restarted to activate this fix.              *
  *                 The restarts do not need to occur at the     *
  *                 same time.                                   *
  ****************************************************************
  A CICS system is started, and the WLM Health level for the
  region begins to open. The MAS agent startup for the region
  is delayed, which allows the WLMHEALTH value to reach 100%
  before the MAS agent is started.
  Subsequently, a SET WLMHEALTH IMMCLOSE command is performed.
  This immediately reduces the WLMHEALTH value in the CICS region
  to 0, and this is reported by CICS through message DFHMN0115I.
  
  CICSPlex SM does not respond to this change. It is expected
  that an EWHEALTH notification event is constructed and
  broadcast to the CMAS network, but this does not occur.
  The z/OS WLM Health value for the MAS remains at 100%; the
  change to 0% is not respected.
  
  This occurs only when:
  - The MAS does not use Sysplex Optimized Workload Management.
  - The first instance of DFHMN0115I issued after the MAS agent
    initialised reports that the new health value is 0.
  
  If WLM Health is opened again and a new msgDFHMN0115I is issued
  then the correct values will be seen and used from that point
  onward.
  

Problem conclusion

• The CICSPlex SM MAS agent code has been modified in methods
  NLRT and NLXD to ensure that an EWHEALTH notification event
  is constructed and broadcast for every change in the CICS
  WLMHEALTH value.
  

Temporary fix

Comments

APAR Information

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

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

  UI67470 UI67471

Modules/Macros

• CJH0NLRT EYU0NLRT EYU0NLXD
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R10M PSY UI67470

     UP20/01/23 P F001

• R20M PSY UI67471

     UP20/01/23 P F001

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.