PI68891: 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 V5R2M0 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 para-        *
  *                 meters' in the "CICS Transaction Server      *
  *                 for z/OS Version 5 Release 2 Installation    *
  *                 Guide" (GC34-7279-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 2 CICSPlex SM Web User Interface     *
  *                 Guide" (SC34-7316-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

• FIX AVAILABLE BY PTF ONLY
  

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
  ×**** PE17/01/25 FIX IN ERROR. SEE APAR PI74676  FOR DESCRIPTION
  

APAR Information

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

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

  PI69978 UI42500

Modules/Macros

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

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R90M PSY UI42500

     UP16/11/15 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.