PI69978: CPSM WUI VIEWS DO NOT SUPPORT SCOPING ON SEVERAL WORKLOAD RELATED VIEWS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• You are trying to use the CPSM WUI ( Web User Interface ) to
  display WLM ( Workload Management ) information. You want to
  limit the information displayed to only certain regions or
  groups of regions. The current views do not support setting a
  SCOPE so that only certain regions are returned. This APAR will
  address that issue in several views.
  .
  Additional Symptom(s) Search Keyword(s): KIXREVGJT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All CICSPlex SM V5R3M0 Users                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * For most of the WUI views, you are able to use CONTEXT,      *
  * SCOPE, as well as other filters to reduce the number of      *
  * instances obtained for a chosen resource table.              *
  *                                                              *
  * However, the SCOPE filter is not supported for the following *
  * two resource tables:                                         *
  *                                                              *
  * - WLMAWAOR: Target region in active workload                 *
  *                                                              *
  * - WLMAWTOR: Active workload routing regions                  *
  *                                                              *
  * In addition, the SCOPE filter may be specified for the       *
  * WLMAROUT resource table, but it was not being honored.       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * After applying the PTF that resolves this APAR, all CMASes   *
  * must be restarted.  Note that the restarts do not need to    *
  * occur at the same time.                                      *
  *                                                              *
  * After applying the PTF that resolves this APAR, the view set *
  * must be imported into the WUI server repository in order to  *
  * pick up the changes.                                         *
  *                                                              *
  * The view set can be imported via the AUTOIMPORTDSN and       *
  * AUTOIMPORTMEM WUI server initialization parameters or the    *
  * IMPORT (from a dataset) function of the COVC WUI control     *
  * transaction.                                                 *
  *                                                              *
  * If COVC is used to import the view set insure that the TYPE  *
  * operand is set to ALL or VIEWSET and that the Import option  *
  * is set to OVERWRITE.                                         *
  *                                                              *
  * For details on the AUTOIMPORTDSN and AUTOIMPORTMEM WUI       *
  * server initialization parameters see 'Specify the Web User   *
  * Interface server initialization parameters' in the "CICS     *
  * Transaction Server for z/OS Version 5 Release 3 Installation *
  * Guide" (GC34-7414-00).                                       *
  *                                                              *
  * For details on the COVC IMPORT function see 'The CICSPlex SM *
  * Web User Interface transaction (COVC)' in the "CICS          *
  * Transaction Server for z/OS Version 5 Release 3 CICSPlex SM  *
  * Web User Interface Guide" (SC34-7451-00).                    *
  *                                                              *
  * The updated starter set objects that need to be imported are *
  * named:                                                       *
  *                                                              *
  *   EYUSTARTWLMAWAOR - EYUxA1X0                                *
  *   EYUSTARTWLMAWTOR - EYUxA1X1                                *
  *   EYUSTARTWLMAWORK - EYUxA1WZ                                *
  *                                                              *
  * Replace x with the required language version to be imported: *
  *                                                              *
  *   E - English, K - Japanese, S - Chinese                     *
  *                                                              *
  * Insure that the import references the SEYUVIEW dataset that  *
  * was updated by the PTF that resolves this APAR.              *
  ****************************************************************
  When you open or refresh the WUI view (EYUSTARTWLMAWAOR) for
  resource table (WLMAWAOR), method WABA (EYU0WABA - Browse Active
  AORs in WorkLoad) is driven to obtain all the information
  related to active target regions within the CICSplex. As part of
  WABA MAL (Method Argument List), various type of filters are
  passed to WABA to reduce the number of instances obtained.
  
  However, unlike other resource tables, the SCOPE value is not
  passed. As a result, all matching active target regions within
  the CICSplex are returned.
  
  The similar issue also applies to resource table WLMAWATOR, view
  EYUSTARTWLMAWTOR and its method WABT (EYU0WABT - Browse Active
  TORs in WorkLoad).
  
  Additionally, the SCOPE filter may be specified for resource
  table WLMAROUT, and it is passed to its method WABU (EYU0WABU -
  Browse Active Routers) as part of WABU MAL. However, it was not
  being honored properly.
  

Problem conclusion

Temporary fix

Comments

• To support scope resolution for resource tables, WLMAWAOR and
  WLMAWTOR, the following changes have been made:
  
  - Method EYU0WABA has been updated to support scope resolution
    in view EYUSTARTWLMAWAOR
  
  - Method EYU0WABT has been updated to support scope resolution
    in view EYUSTARTWLMAWTOR
  
  - WUI views, EYUSTARTWLMAWTOR and EYUSTARTWLMAWAOR, have been
    updated to support scope as a filter
  
  - WUI view, EYUSTARTWLMAWORK has been updated to pass CICSplex
    name to EYUSTARTWLMAWAOR and EYUSTARTWLMATOR as the default
    scope
  
  - Method EYU0WABU has been updated to honor scope value
  

APAR Information

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

  PI68891

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

  UI42501

Modules/Macros

• EYU0WABA EYU0WABT EYU0WABU EYU9WMP3 EYU9WMP4 EYU9WMPU EYU9WMR3
  EYU9WMR4 EYU9WMRU EYUA2484 EYUA2485 EYUC2484 EYUC2485 EYUE2484
  EYUE2485 EYUEA1WZ EYUEA1X0 EYUEA1X1 EYUKA1WZ EYUKA1X0 EYUKA1X1
  EYUL2484 EYUL2485 EYUP2484 EYUP2485 EYUSA1WZ EYUSA1X0 EYUSA1X1
  EYUT2484 EYUT2485 EYUY2484 EYUY2485
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00M PSY UI42501

     UP16/11/19 P F611

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.