PI53743: EYUVH0500E IN CPSM WUI BROWSER IF FAVORITES TWISTIE EXPANDED AND ENTRIES IMPORTED WITH A BLANK TITLE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You use the CPSM Web User Interface transaction COVC to export
  and then import USER entries from one WUI Server to another WUI
  Server. These records are stored in the EYUWUI dataset.
  .
  If a user had 'Favorites' saved which had blank titles, when
  that user tries to use the WUI where the entries were imported,
  and they click on the 'Favorites' link to expand their list of
  favorites, the Navigation frame on the left side of the WUI
  will produce an error with message EYUVH0500E. The WUI Server
  will write exception trace entries to the AUX trace dataset
  that look similar to the following:
  .
  TASK  MTD  PREV TRAN OBJ LEVL  PT-ID   DEBUG
  12345 VISU VHML COVP SIM EXCP      18 BadREQs
  12345 VISU VHML COVP SIM EXCP      18 BadREQs
  12345 VHML VHMB COVP SIM EXCP      12 VISU2
  12345 VHML VHMB COVP SIM EXCP     402 VHML_402
  12345 VHMB VPNB COVP SIM EXCP      47 VHMLErr3
  12345 VPNB VPNP COVP SIM EXCP     304 VHMBFAIL
  12345 VPNP VPHI COVP SIM EXCP     105 VPNBfail
  .
  .
  Additional Symptom(s) Search Keyword(s): KIXREVSVR
  

Local fix

• The user may go into the Favorites Editor and delete the
  entries which have a blank title, or edit them to have one.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V5R2M0 Users.                *
  ****************************************************************
  * PROBLEM DESCRIPTION: Within the WUI User editor, you are     *
  *                      able to create a favorite link for a    *
  *                      specific user without a valid title or  *
  *                      destination.  This can cause the        *
  *                      following error when the favorites      *
  *                      twistie is expanded for the user:       *
  *                                                              *
  *                      - EYUVH0500E xxxxxxxx Internal server   *
  *                        error.                                *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all affected WUI regions must be       *
  *                 recycled to pick up the new code.            *
  *                                                              *
  *                 Note that the PTF that resolves this APAR    *
  *                 will stop new invalid favorites from being   *
  *                 created, but will not delete existing        *
  *                 invalid favorites.  If a user receives the   *
  *                 EYUVH0500E error message, the following      *
  *                 steps can be taken to resolve the error:     *
  *                                                              *
  *                 1.  In the navigation section of the WUI     *
  *                     display, hyperlink on "User editor" to   *
  *                     open the "User Editor Selection" view    *
  *                     (screen 176).                            *
  *                                                              *
  *                 2.  From the "User Editor Selection" view    *
  *                     (screen 176), hyperlink on "Users" to    *
  *                     open the "User Editor" view (screen      *
  *                     186).                                    *
  *                                                              *
  *                 3.  From the "User Editor" view (screen      *
  *                     186), hyperlink on "Edit" to open the    *
  *                     "Edit User" view (screen 188).           *
  *                                                              *
  *                 4.  From the "Edit User" view (screen 188),  *
  *                     highlight the affected user and select   *
  *                     "OK".  This will open the "Favorites     *
  *                     Editor" view (screen 192).               *
  *                                                              *
  *                 5.  From the "Favorites Editor" view (screen *
  *                     192), you have two options:              *
  *                                                              *
  *                     -  You can hyperlink on "Edit" to edit   *
  *                        the user's favorites.  This will take *
  *                        you to the "Select Favorite to Edit"  *
  *                        view (screen 195), where you can      *
  *                        select and edit each favorite for the *
  *                        user, adding titles and destinations  *
  *                        if they are not specified.            *
  *                                                              *
  *                     -  You can hyperlink on "Delete" to      *
  *                        delete selected favorites for the     *
  *                        user.  This will take you to the      *
  *                        "Select Favorite to Delete" view      *
  *                        (screen 196), where you can select a  *
  *                        favorite and delete it.               *
  *                                                              *
  *                 6.  After editing or deleting, the user      *
  *                     editor session must be terminated and    *
  *                     the affected user should logoff from the *
  *                     WUI and logon again.                     *
  *                                                              *
  *                     To terminate the user editor session,    *
  *                     save your changes back to the "User      *
  *                     Editor Selection" view (screen 176).  At *
  *                     this time you can hyperlink on "Close    *
  *                     window" in the user editor navigation    *
  *                     panel to close the user editor window.   *
  *                                                              *
  *                 Note 1:  The EYUVH0500E error can occur even *
  *                          if a title is present but the       *
  *                          destination is not specified. If    *
  *                          the EYUVH0500E error still occurs   *
  *                          then it will be necessary to use    *
  *                          the "Edit" path in step 5 to ensure *
  *                          all existing favorites also have a  *
  *                          specified destination.              *
  *                                                              *
  *                 Note 2:  If the corrupted favorites for a    *
  *                          user had previously been exported   *
  *                          for back up purposes, then after    *
  *                          using the above process to correct  *
  *                          the user's favorites, the export    *
  *                          should be performed again,          *
  *                          replacing the corrupted version.    *
  ****************************************************************
  At WUI View Editor screen 19, a new favorite link could be saved
  by clicking the Finish button. Method EYU0VE13 (VE13) is called
  to process the saving logic. However, due to missing validation
  checks, a favorite link could be saved to the Web User Interface
  server repository (EYUWREP) without a valid title or
  destination.
  
  When expanding the favorite node in the WUI, CPSM retrieves user
  related data from EYUWREP, and shows in the WUI navigation view.
  If a favorite link without a valid destination is entered then
  CPSM fails to process it and message EYUVH0500E is issued.
  

Problem conclusion

• Module EYU0VE13 has been updated to validate a new or modified
  favorite link, to ensure the content identifies a title and
  destination before saving it to the EYUWREP.
  

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:

  PI59790 UI37432

Modules/Macros

•    EYU0VE13
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R90M PSY UI37432

     UP16/04/30 P F604

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.