PI81780: CPSM COMPATABILITY APAR REQUIRED FOR CTS 5.4

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• With the upcoming GA release of CICS
  Transaction Server for z/OS Version 5
  Release 4, a compatibility APAR is
  required for pre-V5R4M0 CPSM regions
  before they start communicating with
  V5R4M0 CPSM regions.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R1M0, V5R2M0 and V5R3M0    *
  *                 Users                                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: A compatibility APAR is required to     *
  *                      tolerate a task load of zero (0) in a   *
  *                      CPSM WLM target region, which can occur *
  *                      due to changes introduced in CICS       *
  *                      Transaction Server for z/OS Version 5   *
  *                      Release 4 (CTS V5R4M0).                 *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be           *
  *                 restarted.  Note that the restarts do not    *
  *                 need to occur at the same time.              *
  *                                                              *
  *                 This fix is being provided across all        *
  *                 pre-V5R4M0 supported releases of CPSM as     *
  *                 follows:                                     *
  *                                                              *
  *                 -  CPSM V4R1M0 - APAR PI81778                *
  *                 -  CPSM V4R2M0 - APAR PI81778                *
  *                 -  CPSM V5R1M0 - APAR PI81780                *
  *                 -  CPSM V5R2M0 - APAR PI81780                *
  *                 -  CPSM V5R3M0 - APAR PI81780                *
  *                                                              *
  *                 While the restarts do not need to occur at   *
  *                 the same time, all pre-V5R4M0 CPSM CMASes    *
  *                 and MASes should be restarted to run with    *
  *                 the PTF that resolves the APAR for its       *
  *                 release, before connecting into a CPSM       *
  *                 network that contains CPSM V5R4M0 CMASes     *
  *                 and MASes.                                   *
  ****************************************************************
  Updates made in CTS V5R4M0 change most CPSM tasks in a MAS
  running with both CICS and CPSM at the CTS V5R4M0 level,
  including all long running MAS tasks, from user to system tasks.
  As such, it is possible for a CPSM target region running both
  CICS and CPSM at the CTS V5R4M0 level, to have a task load of
  zero (0).  Updates are required for pre-CTS V5R4M0 CPSM regions
  to accommodate this:
  
  -  MAS method EYU0WNAL (WNAL), which runs in a CPSM WLM routing
     region during route selection processing, must be updated to
     correct a situation where a task load of zero (0) for a
     target region could result in an affinity not being created.
  
  -  CMAS methods EYU0WABA (WABA) and EYU0WABB (WABB), which run
     in a CMAS to create WLMAWAOR (WABA) and WLMATARG (WABB)
     resource table records when requested through the CPSM API,
     WUI or Explorer, must be updated to correct a situation where
     a task load of zero (0) for a target region could result in
     the ROUTEWGHT attribute being incorrect.
  

Problem conclusion

• Updates have been made to WNAL, WABA and WABB to allow for
  target regions with a task load of zero (0).
  

Temporary fix

Comments

APAR Information

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

  PI81778

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

  UI47509 UI47511 UI47512 PI83329

Modules/Macros

• CJA0WNAL CJB0WNAL CJC0WNAL CJD0WNAL CJE0WNAL CJF0WNAL EYU0WABA
  EYU0WABB EYU0WNAL
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00M PSY UI47512

     UP17/05/26 P F705 ¢

• R80M PSY UI47509

     UP17/05/26 P F705 ¢

• R90M PSY UI47511

     UP17/05/26 P F705 ¢

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.