PK98569: WHEN TIMEOUTS OCCUR IN A MAS, THAT MAS NEED TO BE IDENTIFIED ON A WUI SCREEN

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• When the web user interface (WUI) fails to get a response from a
  MAL, and a time out occurs, the point of failure is not
  identified.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    When the web user interface (WUI)    *
  *                      or other CPSM API request fails because *
  *                      a response was not received from one or *
  *                      more of the target MASes or CMASes, the *
  *                      region or regions that did not respond  *
  *                      are not identified.                     *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes and MASes must be recycled  *
  *                 to pick up the new code.                     *
  *                                                              *
  *                 The restarts need not be performed at the    *
  *                 same time, however if systems are not        *
  *                 restarted at the same time, the following    *
  *                 rules apply:                                 *
  *                                                              *
  *                 - Maintenance Point (MP) CMASes must be re-  *
  *                   started with updated libraries before any  *
  *                   non-MP CMASes which connect directly or    *
  *                   indirectly to it.                          *
  *                                                              *
  *                 - If you have more than one MP CMAS and any  *
  *                   of those MP CMASes are connected directly  *
  *                   or indirectly, then those MP CMASes must   *
  *                   be restarted at the same time.             *
  *                                                              *
  *                 - A CMAS must be restarted with updated      *
  *                   libraries before any MASes which connect   *
  *                   to it.                                     *
  *                                                              *
  *                 If a CMAS executing from libraries in which  *
  *                 the PTF resolving this APAR is applied,      *
  *                 connects directly or indirectly to a CMAS    *
  *                 executing CPSM for CICS Transaction Server   *
  *                 V3.2, the PTFs which resolve APAR PK95898    *
  *                 must be applied, and CMASes and MASes        *
  *                 running CPSM for CICS Transaction Server     *
  *                 V4.1 must be restarted with the updated      *
  *                 libraries before starting CMASes and MASes   *
  *                 with the changes made by that APAR.          *
  ****************************************************************
     Certain internal CPSM errors may result in missing data in
  result sets, or incomplete processing of actions.  The CPSM API
  will return response and reason codes including, but not limited
  to, ENVIRONERROR / REQTIMEOUT (Communications timeout), and
  NOTAVAILABLE / SCOPE (a target MAS was shutting down at the time
  a request was made).  In some cases partial data may be returned
  but the MASes or CMASes which caused the error response are not
  identified.
  
     A new resource table, MASQRYER has been defined.  The CPSM
  API has been modified to build MASQRYER resources identifying
  non-responding MASes or CMASes whenever a response is not re-
  ceived from one or more MASes in the request scope, for a GET,
  PERFORM, or SET command for a CICS Operate resource.  A new
  parameter, QUERYERROR, has been added to the QUERY and FETCH
  commands.  Adding QUERYERROR to a QUERY command will cause it
  to return information related to MASQRYER resources generated
  by the last GET, PERFORM, or SET command to act on the result
  set.  Adding QUERYERROR to a FETCH command will cause it to
  return MASQRYER resources generated by the last GET, PERFORM,
  or SET command to act on the result set.  The Web User Interface
  (WUI) has been modified to issue one or more of the following
  messages:  EYUVC1209E, EYUVC1293E, or EYUVC1294W, when responses
  are not received from one or more MASes in the request scope,
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

•    A new resource table, MASQRYER has been defined.  The CPSM
  API has been modified to build MASQRYER resources identifying
  non-responding MASes or CMASes whenever a response is not re-
  ceived from one or more MASes in the request scope, for a GET,
  PERFORM, or SET command for a CICS Operate resource.  A new
  parameter, QUERYERROR, has been added to the QUERY and FETCH
  commands.  Adding QUERYERROR to a QUERY command will cause it
  to return information related to MASQRYER resources generated
  by the last GET, PERFORM, or SET command to act on the result
  set.  Adding QUERYERROR to a FETCH command will cause it to
  return MASQRYER resources generated by the last GET, PERFORM,
  or SET command to act on the result set.  The Web User Interface
  (WUI) has been modified to issue one or more of the following
  messages:  EYUVC1209E, EYUVC1293E, or EYUVC1294W, when responses
  are not received from one or more MASes in the request scope,
  after a request to retrieve data or perform an action.
  ž**** PE10/11/29 FIX IN ERROR. SEE APAR PM27664  FOR DESCRIPTION
  

APAR Information

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

  PK95898

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

  UK58389

Modules/Macros

•    DYU0MOXT DYU0VAFT DYU0VAGM DYU0VAGT DYU0VAGW
  DYU0VAST DYU0VASU DYU0VBRP DYU0VHDT DYU0VHLK DYU0VHPL DYU0VHTT
  DYU0VHVD DYU0VIFM DYU0VISE DYU0VISI DYU0VISP DYU0VISZ DYU0VMPR
  DYU9VKEC EYUA2639 EYUBVAPI EYUBVISS EYUBVIST EYUBXDEN EYUBXDRD
  EYUCXXRS EYUC2639 EYUEVGAR EYUE2639 EYUKVGAR EYUK2639 EYUL2639
  EYUP2639 EYUQACCK EYUQXXRC EYURVGAR EYURXDEQ EYUR2639 EYUSVGAR
  EYUS2639 EYUTACMD EYUTAEYU EYUTBNRC EYUTMOMI EYUTMOSD EYUTRDIR
  EYUTVOSX EYUTVTHE EYUTVTHK EYUTVTHS EYUT2639 EYUUACMD EYUUAGBL
  EYUUXXFI EYUUXXRS EYUUXXTC EYUY2639 EYU0ABAA EYU0ABAF EYU0ABAJ
  EYU0ABA4 EYU0ABA7 EYU0ABA9 EYU0ABM0 EYU0CRCK EYU0CTEX EYU0DXRC
  EYU0MOXT EYU0TICT EYU0TSRA EYU0UQGQ EYU0VAFT EYU0VAGM EYU0VAGT
  EYU0VAGW EYU0VAST EYU0VASU EYU0VBRB EYU0VBRF EYU0VBRS EYU0VHDA
  EYU0VHDB EYU0VHDF EYU0VHDH EYU0VHDI EYU0VHDK EYU0VHDT EYU0VHLB
  EYU0VHLF EYU0VHPL EYU0VHTD EYU0VHTH EYU0VHTM EYU0VHTT EYU0VHVC
  EYU0VHVD EYU0VHVS EYU0VHVT EYU0VIFM EYU0VISE EYU0VISI EYU0VISP
  EYU0VISZ EYU0VKED EYU0VMPD EYU0XDER EYU0XDH3 EYU0XDH4 EYU0XDH7
  EYU0XDNR EYU0XDP1 EYU0XDP2 EYU0XDP4 EYU0XDP5 EYU0XDP6 EYU0XDQA
  EYU0XDQB EYU0XDQR EYU0XDQ2 EYU0XDW1 EYU0XDW2 EYU0XDW3 EYU0XDW8
  EYU0XDW9 EYU0XDY1 EYU0XDY2 EYU0XDY3 EYU0XDY4 EYU0XDY5 EYU0XDY7
  EYU0XLSD EYU0XL80 EYU0XQGQ EYU0XXRC EYU7VISS EYU7VIST EYU9XDF1
  EYU9XMAL JCI660MJ MASQRYER
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK58389

     UP10/07/08 P F007

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.