PI15826: COMPAT APAR FOR CICS EXPLORER 5.2.0.0 TO SUPPORT LNKSWSCG REMOVE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When CICS Explorer 5.2.0.0 or higher is used to remove the
  association between a WLMSPEC and a CICS system group
  (LNKSWSCG), the request may fail.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 and V4R2M0 Users      *
  ****************************************************************
  * PROBLEM DESCRIPTION: When CICS Explorer 5.2.0.0 or higher is *
  *                      used to remove the association between  *
  *                      a WLMSPEC and a CICS system group       *
  *                      (LNKSWSCG), the request may fail.       *
  *                                                              *
  *                      The failure most likely will result in  *
  *                      the following error messages:           *
  *                                                              *
  *                        Unable to remove the routing          *
  *                        association from a system group.      *
  *                        See the Error Log view for more       *
  *                        information.                          *
  *                                                              *
  *                        The version of CICS you are connected *
  *                        to does not support the API that is   *
  *                        required to remove the workload       *
  *                        routing association from a system     *
  *                        group. You must upgrade your version  *
  *                        of CICS to complete this task. For    *
  *                        more details, visit http://...        *
  *                                                              *
  *                        com.ibm.cics.core.model.              *
  *                        CICSSystemManagerException:           *
  *                        com.ibm.cics.sm.comm.sm.              *
  *                        UnsupportedMethodOverrideException:   *
  *                        Method override not supported for     *
  *                        this CICS server version.             *
  *                                                              *
  *                      If the above messages are displayed,    *
  *                      examination of the auxtrace files for   *
  *                      the WUI/CMCI server address space will  *
  *                      show the following CICS exception trace *
  *                      entries:                                *
  *                                                              *
  *                        AP A46D WUXML *EXC* invalidDeleteTag  *
  *                        AP A217 WUIPG *EXC* badWUPFM          *
  *                                                              *
  *                      Note that when the Explorer is          *
  *                      connected to a CTS 4.1 WUI/CMCI server, *
  *                      the following error may be returned     *
  *                      instead:                                *
  *                                                              *
  *                        com.ibm.cics.sm.comm.sm.              *
  *                        SMConnectionException:                *
  *                        LNKSWSCG, INVALIDPARM, PARM           *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all WUI/CMCI severs must be            *
  *                 restarted.  Note that the restarts do not    *
  *                 need to occur at the same time.              *
  ****************************************************************
  When the association between a WLMSPEC and a CICS system group
  is removed, the INHERIT parameter must be passed with the
  request to indicate whether the CICS systems associated with the
  group should continue to be associated with the WLMSPEC
  (INHERIT=KEEP) or should no longer be associated with the
  WLMSPEC (INHERIT=NONE).  Module DFHWUIPG does not support a
  parameter being passed for this request, which causes the
  request to fail.
  

Problem conclusion

• DFHWUIPG has been updated to properly support the INHERIT
  parameter when a request is made through the Explorer to remove
  the association between a WLMSPEC and a CICS system group.
  

Temporary fix

• 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:

  PI15827 UI18811 UI18812 UI18813 UI18814

Modules/Macros

• DFHWUIPG DFHWUTRI
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UI18812

     UP14/07/04 P F407

• R600 PSY UI18811

     UP14/07/04 P F407

• R70M PSY UI18814

     UP14/07/04 P F407

• R700 PSY UI18813

     UP14/07/04 P F407

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.