PM73511: CPSM DPL LOCKED AFFINITIES PERIST EVEN AFTER UOW TERMINATION FOR DEFAULT TRANGRP, $$DTGA$$

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When WFMG builds the active affinity list element (WLMAFFET)
  for the affinity the TRANGRP name in the UOW affinity key is
  copied from the TRANGRP Descriptor field WTGD_TGRPNAME.
  However this field is not set in the descriptor for the default
  TRANGRP, $$DTGA$$.  Later during the ENDUOW call to WDIN, the
  UOW affinity key is built from values in the Transaction Data
  Area (WTDA), and we have special code to set the name of the
  default TRANGRP in the WTDA when appropriate.
  

Local fix

• No Local Fix
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R2M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    The default TRANGRP defined by your  *
  *                      workload's WLMSPEC resource establishes *
  *                      LOCKED affinities with a lifetime of    *
  *                      UOW.  You notice that active affinities *
  *                      are not being removed when a unit of    *
  *                      work ends.                              *
  ****************************************************************
  * 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.                               *
  ****************************************************************
     When module EYU0WFMG (WFMG - WLM Affinity Services) builds
  the active affinity list element (WLMAFFET) for the affinity
  the TRANGRP name in the UOW affinity key is copied from the
  TRANGRP Descriptor field WTGD_TGRPNAME.  However this field is
  not set in the descriptor for the default TRANGRP, $$DTGA$$.
     Later during the ENDUOW call, module EYU0WDIN (WDIN - Route
  Program Initialization / Termination) builds the UOW affinity
  key from values in the Transaction Data Area (WTDA), where the
  TRANGRP name was set to $$DTGA$$ explicitly if the work is
  being routed under the control of the default TRANGRP.  Since
  the requested key value does not match the original key, a
  status value of RECORD_NOT_FOUND is returned, and the active
  affinity will not be removed.
  

Problem conclusion

•    Module EYU0WMDB (WMDB - Workload Descriptor Build) was
  modified to initialize the default TRANGRP name to $$DTGA$$
  when a CMAS builds a workload, or imports an existing work-
  load from another CMAS.
     Module EYU0WMWS (WMWS - WLM CMAS Warm Start) was modified
  to set the name of the default TRANGRP to $$DTGA$$ when a CMAS
  restarts while MASes are active.
  

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:

  UK82771

Modules/Macros

•    EYU0WMDB EYU0WMWS
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R70M PSY UK82771

     UP12/10/23 P F210

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.