PK08291: WUI EYUSTARTCICSRGN.DETAILED CICS MVS TCB VALUES UNDER DUMP

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• WUI view EYUSTARTCICSRGN.DETAILED contains a link with text:
  " Monitoring, dump and trace details" .  This links to the
  EYUSTARTCICSRGN.DETAIL1 view and the ' Dump values " section
  contains the CICS MVS TCB information.  This information is
  not related to CICS Dump values and needs to be moved to the
  correct location so users can locate CICS MVS TCB information.
  .
  Additional Symptom(s) Search Keyword(s): MAXOPENTCBS SUBTSKS
  subtasks H8 J8 EYUSTART CICSRGN starter set viewset
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V3R1M0 Users.                *
  ****************************************************************
  * PROBLEM DESCRIPTION: The CICSPlex SM Web User Interface      *
  *                      (WUI) detailed CICS Region view         *
  *                      EYUSTARTCICSRGN.DETAIL1 is described as *
  *                      containing 'Monitoring, dump and trace  *
  *                      details'. On this view, within the DUMP *
  *                      section, are a number of TCB related    *
  *                      attributes.                             *
  *                                                              *
  *                      These TCB related attributes have       *
  *                      nothing to do with 'Dump values' and    *
  *                      should be moved elsewhere.              *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and WUI Servers must be     *
  *                 recycled to pick up the new code.  Note that *
  *                 the restarts do not need to be done at the   *
  *                 same time.                                   *
  *                                                              *
  *                 Users of the CICSPlex SM supplied starter    *
  *                 set view sets and menus must reimport the    *
  *                 starter set view set and menu definitions    *
  *                 into each Web User Interface (WUI) server's  *
  *                 repository in order to pick up the changes.  *
  *                                                              *
  *                 The starter set view sets and menus can be   *
  *                 reimported either via the AUTOIMPORTTDQ WUI  *
  *                 server initialization parameter or the       *
  *                 IMPORT function of the COVC WUI transaction. *
  *                 If COVC is used to reimport the starter set, *
  *                 ensure that the OVERWRITE WUI server         *
  *                 initialization parameter or the IMPORT       *
  *                 function of the COVC WUI transaction.        *
  *                                                              *
  *                 For details on the AUTOIMPORTTDQ parameter   *
  *                 and the COVC IMPORT function see 'Specify    *
  *                 the Web User Interface server initialization *
  *                 parameters' and 'The CICSPlex SM Web User    *
  *                 Interface transaction (COVC)' in the         *
  *                 CICSPlex SM Web User Interface Guide         *
  *                 (SC34-6461-00).                              *
  ****************************************************************
  The EYUSTARTCICSRGN view set contains a view (DETAILED1) that
  contains TCB attributes within a section titled 'Dump Section'.
  These attributes are not appropriate for this section.
  

Problem conclusion

• The following changes have been made:
  
  - EYUSTARTCICSRGN has been changed as follows :
  
    - The TCB related attributes on the DETAILED1 view have been
      removed.
    - The DETAILED and DETAILED2 views have been updated to show a
      link titled 'Dispatcher and TCB details' which links to new
      view DETAILED4.
    - A new view DETAILED4 has been added. This contains:
  
       - TCB related values previously on the DETAILED1 view.
       - A link to 'General Dispatcher information' (new view set
         EYUSTARTDSPGBL).
       - A link to 'TCB information' (new view set EYUSTARTTCBGL)
  
  - Menu EYUSTARTREGION has been changed, so that it now contains
    the following items in the 'CICS region operations views'
    section :
  
       - CICS regions
       - Dynamic storage areas
       - MVS storage areas (links to new view set EYUSTARTMVSESTG)
       - Transaction classes
       - CICS system dump codes
       - Transaction dump codes
       - Global CICS dispatcher information (links to new view
         set EYUSTARTDSPGBL)
       - CICS dispatcher TCB modes (links to new view set
         EYUSTARTDSPMODE)
       - CICS dispatcher TCB pools (links to new view set
         EYUSTARTDSPPOOL)
       - Global MVS TCB information (links to new view set
         EYUSTARTMVSTCBGL)
       - MVS TCBs (links to new view set EYUSTARTMVSTCB)
       - MVS workload management (links to new view set
         EYUSTARTMVSWLM)
  
  - The following new view sets have been added :
  
    - EYUSTARTMVSESTG which contains MVS storage element
      information.
    - EYUSTARTDSPGBL which contains general CICS Dispatcher
      information.
    - EYUSTARTDSPMODE which contains CICS Dispatcher TCB mode
      information.
    - EYUSTARTDSPPOOL which contains CICS Dispatcher TCB pool
      information.
    - EYUSTARTMVSTCBGL which contains general TCB information.
    - EYUSTARTMVSTCB which contains MVS TCB information.
    - EYUSTARTMVSWLM which contains MVS Workload Manager
      information.
  
  - EYU0MOMB (MOMB - MOS MAL Builder) has been changed to ensure
    that a generic key is always passed for requests processing
    MVSTCB and MVSESTG resource table records.  This is necessary
    to allow keyed gets for MVSTCB and MVESTG.
  
  - EYU0VOPC (VOPC - WUI MOS compare attributes) has been changed
    to add some extra trace points that can be used to show WUI
    processing of conditional hyperlinks.
  
  - Generic Receiver tables, EYUTNAG8, EYUTNAG9 and EYUTNAGA have
    been updated so that the DSPPOOL / XDSPPOOL DSGPNUAT is set
    correctly. Prior to this change DSGPNUAT will always be
    reported as 0.
  
  - EYU0NQGR (NQGR - Generic Inquire Object processing) has been
    changed to correctly set the key length for objects e.g.
    MVSTCB, that can only be obtained via an EXEC CICS INQ NEXT
    loop.
  
  - The MVSTCB resource table has been changed so that the
    default description for this table is now 'TCB Information'.
  
  - The MVSESTG resource table has been changed so that the
    default summary type for the ELEMLEN (element length)
    attribute is now sum.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK01543

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

  UK05938

Modules/Macros

•    DYU0MOMB DYU0VOPK EYUA0142 EYUC0142 EYUEVX01
  EYUE0142 EYUKVX01 EYUK0142 EYUL0142 EYUN0142 EYUP0142 EYUR0142
  EYUSVX01 EYUS0142 EYUTNAGA EYUTNAG8 EYUTNAG9 EYUT0141 EYUT0142
  EYUY0141 EYUY0142 EYU0MOMB EYU0NQGR EYU0VOPC MVSESTG  MVSTCB
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK05938

     UP05/08/05 P F508

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.