PK95133: RTTERM FAILS WITH SERVINIT/CICSINIT AND WDININIT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• If RTERR occurs when routing to the default SYSID, then even
  though cleanup occurs on the RTERR call, RTTERM is called and
  fails with the following trace entries.
  .
  If a service program links to EYU9XLOP for routing:
    WDIN WDTR TXN1 WLM EXCP.      9 SERVINIT CPSM cmasname LMAS
    WDTR XLOP TXN1 WLM EXCP.      6 WDININIT CPSM cmasname LMAS
  .
  If CICS links to EYU9XLOP for routing:
    WDIN WDTR TXN1 WLM EXCP.      9 CICSINIT CPSM cmasname LMAS
    WDTR XLOP TXN1 WLM EXCP.      6 WDININIT CPSM cmasname LMAS
  .
  This is because cleanup occurred on the RTERR call.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V4R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: Unpredictable results may occur if the  *
  *                      CPSM WLM dynamic routing processing     *
  *                      program EYU9XLOP selects the default    *
  *                      location for routing, and the route     *
  *                      request fails to run successfully in    *
  *                      the default location.                   *
  *                                                              *
  *                      The errors occur as the result of CPSM  *
  *                      trying to access data structures that   *
  *                      are no longer associated with the route *
  *                      request.                                *
  *                                                              *
  *                      If the data structures have been reused *
  *                      by another route request, that request  *
  *                      may not process properly.               *
  *                                                              *
  *                      If the data structures have not been    *
  *                      reused by another route request, then   *
  *                      the current request will issue          *
  *                      exception trace records.  The trace     *
  *                      records will vary depending upon        *
  *                      whether EYU9XLOP is called by CICS or   *
  *                      by a service program:                   *
  *                                                              *
  *                      -  if CICS links to EYU9XLOP for        *
  *                         routing:                             *
  *                                                              *
  *                           Method  TPID  Debug text           *
  *                           ------  ----  ----------           *
  *                           WDIN       9  CICSINIT             *
  *                           WDTR       6  WDININIT             *
  *                                                              *
  *                      -  if a service program links to        *
  *                         EYU9XLOP for routing:                *
  *                                                              *
  *                           Method  TPID  Debug text           *
  *                           ------  ----  ----------           *
  *                           WDIN       9  SERVINIT             *
  *                           WDTR       6  WDININIT             *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all MASes that run as CPSM WLM routing *
  *                 regions must be restarted.  Note that the    *
  *                 restarts do not need to occur at the same    *
  *                 time.                                        *
  ****************************************************************
  When a route request that has been directed to the default
  routing location by CPSM WLM does not run successfully, EYU9XLOP
  is recalled for route error.  Method EYU0WDIN (WDIN) will then
  determine that since the default location failed, there is no
  other location to attempt a route to, and will request that the
  data areas allocated for the route request be returned to the
  free pool for use by other route requests.  WDIN does not expect
  that EYU9XLOP will be called for route termination.
  
  The routing process is controlled through a COMMAREA passed to
  EYU9XLOP.  This area is either the DFHDYPDS, for direct calls
  from CICS, or the EYURWTRA, for calls from a service program.
  Both COMMAREAs have a flag that indicates whether CICS or the
  service program should call EYU9XLOP for route termination.
  While WDIN does not expect EYU9XLOP to be called for route
  termination, it does not ensure that the flag is set to "do not
  call".
  
  If EYU9XLOP is called for route termination after WDIN has
  already released the data structures on a route error call, then
  the errors described above can occur.
  

Problem conclusion

• WDIN has been updated to ensure that the DFHDYPDS or the
  EYURWTRA is properly set to indicate that EYU9XLOP should not be
  called for route termination when it is called for route error
  for a route request to the default location.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK95028

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

  UK51589

Modules/Macros

• EYU0WDIN EYU0WDIS
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R60M PSY UK51589

     UP09/11/03 P F911

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.