PM87010: TRANSACTIONS ROUTED TO TARGET REGION THAT'S OUT-OF-SERVICE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When using CPSM WLM to route transactions to available target
  regions, transactions are being routed to a region that has
  been set Out-of-Service when they shouldn't.  This occurs on an
  RZ route where an OPEN failure occurs in DFHAPTC and EYU9XLOP
  is notified of the route failure and redriven to choose the
  next target.  However, the route error code is always set to
  IOERR (DYR_IOERR) instead of the exact failure (ie. DYR_ERROUT
  for SYSID out of service in this case) and so the target
  regions WAOR control block is never updated to indicate the
  system is not in service.
  Additional Symptom(s) Search Keyword(s): KIXREVGJT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CPSM routes transaction to out-of-      *
  *                      service AOR repeatedly.                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In CPSM, a request is being routed from TOR to AOR. The request
  is using request streams by web service context switch.
  The request stream use distributed routing exit supply by CPSM
  to determine the AOR to route request to. Because the connection
  to the target AOR is out of service, the incorrect reason code
  DYR_IOERR is returned from request stream code to CPSM routing
  exit. This reason code make same AOR selected again by routing
  exit and leads to another route failure.
  Additional keywords: DFHPI0508 msgDFHPI0508
  

Problem conclusion

• DFHAPTC and request streams code has been changed to return
  dynamic routing exit with DYR_ERROUT while the target routing
  region is out of service.
  

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:

  PM92722 UK97168

Modules/Macros

•    DFHAPTC  DFHRZDM  DFHRZDUF DFHRZIX  DFHRZLN
  DFHRZNR2 DFHRZOFI DFHRZRG2 DFHRZRJ  DFHRZRM  DFHRZRS1 DFHRZRT
  DFHRZRT1 DFHRZRT2 DFHRZSO  DFHRZSO1 DFHRZTA  DFHRZTCX DFHRZTRI
  DFHRZTR1 DFHRZVP1 DFHRZXM  DFHZIS2
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R700 PSY UK97168

     UP13/09/06 P F309

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.