PM33526: CPSM ENHANCEMENT TO IMPROVE WORKLOAD REMOVAL WHEN A CMAS TERMINATES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Currently, when the last routing (TOR) and target (AOR) MAS for
  an installed workload is terminated, CPSM will remove the
  workload from the CICSPlex, and the following message is issued
  .
  EYUWM0410I Workload type (name) has been removed from Context
  (plexname)
  .
  There must be no active MASes in the workload on any LPAR
  anywhere in the CICSPlex.
  .
  However, when a CMAS is terminating, and it knows that the
  dataspaces for it are going to be deleted, it can safely
  broadcast to all the other CMASes that it no longer has a copy
  of the workload. Doing this will help reduce the possibility
  that another CMAS thinks it can get a copy of the installed
  workload from this CMAS, causing it to issue the following
  message:
  .
  EYUWI0086I Workload Specification (specname) exists but cannot
  be imported -- Should Workload installation for routing region
  (masname) continue? (Y=Continue,N=Cancel)
  .
  This APAR is being opened to address this issue.
  .
  KIXREVEPH
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 and V4R2M0 Users      *
  ****************************************************************
  * PROBLEM DESCRIPTION: When a CMAS which installed CPSM WLM    *
  *                      workloads terminates, the CMAS does not *
  *                      remove itself from the workloads.       *
  *                                                              *
  *                      Depending upon when the CMAS is         *
  *                      restarted, this could result in other   *
  *                      CMASes not being able to install        *
  *                      workloads that were installed in the    *
  *                      original CMAS that terminated.  When    *
  *                      this occurs, the partner CMASes will    *
  *                      issue message and prompt EYUWI0086I,    *
  *                      and message EYUWI0090I identifying the  *
  *                      original terminating CMAS.  Note that   *
  *                      for CPSM V4R1M0, message EYUWI0090I     *
  *                      will only be issued if PTF UK62859 is   *
  *                      installed.                              *
  ****************************************************************
  * 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.              *
  ****************************************************************
  When a CMAS terminates while having installed workloads, all
  active CMASes in the network, regardless of whether they have
  workloads installed, keep record of the fact that the
  terminating CMAS has a copy of the workloads.  If subsequently a
  CMAS needs to install any of the workloads, and there is no
  other active CMAS in the network that has a copy of the desired
  workload, then the CMAS will issue message and prompt
  EYUWI0086I, and message EYUWI0090I identifying the terminated
  CMAS.  Note that for CPSM V4R1M0, message EYUWI0090I will only
  be issued if PTF UK62859 is installed.
  
  
  A CMAS which terminates without any routing or target regions
  connected to it for any workload within a CICSplex, should be
  able to remove itself from all active workloads for the
  CICSplex before terminating.
  

Problem conclusion

• Updates have been made to remove all installed workloads for a
  CICSplex from a terminating CMAS, if at the time the CMAS is
  terminating there are no active MASes connected to the CMAS that
  are routing or target regions for any workload within the
  CICSplex.
  
  If workloads are installed and can be removed, then new message
  EYUWM0411I will be issued for each workload that is removed.
  The text of this new message will be similar to the following:
  
    EYUWM0411I Workload Specification (<wlmspec>) has been removed
               from this CMAS for context (<plexname>).
  
  If workloads are installed and cannot be terminated because
  MASes which are routing or target regions are connected to the
  CMAS when it terminates, message EYUWT0053W will be issued.  The
  text of this new message will be similar to the following:
  
    EYUWT0053W Workload Specifications cannot be removed during
               CMAS termination for CICSplex(<plexname>) because
               at least one <routing|target> region is connected
               to the CMAS.
  
  The EYUWT0053W message will be followed by new message
  EYUWT0054I, identifying the first routing or target region found
  that is connected to the terminating CMAS.  The text of the
  message will be similar to the following:
  
    EYUWT0054I MAS <masname> is connected to the CMAS as a
               <routing|target> region in Workload(<wlmspec>) for
               CICSplex(<plexname>).
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM33548

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

  UK70356 UK70365

Modules/Macros

•    EYUMCWMC EYUMCWME EYUMCWMK EYUMCWTC EYUMCWTE
  EYUMCWTK EYUQWMQT EYUQWMWT EYUQWPUD EYUQWTRM EYURWMEB EYURWMQT
  EYURWMWT EYURWPUD EYURWTRM EYUTRWLM EYUUWMEQ EYUYWMQT EYUYWMWT
  EYUYWPUD EYUYWTRM EYUZWMQT EYUZWMWT EYUZWPUD EYUZWTRM EYU0WATJ
  EYU0WINT EYU0WMEV EYU0WMPL EYU0WMQT EYU0WMQW EYU0WMTJ EYU0WMWC
  EYU0WMWD EYU0WMWI EYU0WMWT EYU0WPUD EYU0WTRM EYU0XLES EYU9WMPU
  EYU9WMP3 EYU9WMP4 EYU9WMRU EYU9WMR3 EYU9WMR4
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK70356

     UP11/08/09 P F108

• R70M PSY UK70365

     UP11/08/09 P F108

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.