PI56251: ASRA ABEND OCCURS IN EYU0WDTR FOLLOWING ATNI ABEND DUE TO INVALID EYURWTDA (WTDA) ADDRESS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• An AOR region crashed causing it's connected TOR to abend with
  an ATNI (terminal error) as expected.  The task was running WLM
  CPSM code and experienced a second abend 0C4 ASRA occurring in
  EYU0WDTR (WDTR).  The abend occurs around offset x'320' in the
  LAMXFM0243 routine (expanded macro code label - WDTR_REL_WRKL
  is source code label) on a LAM instruction:  9A22 2000.
  .
   LAM   AR2,AR2,0(R2)
  .
  It fails trying to load AR register 2.  Register 2 is loaded
  from the stack +x'DC' and then a half word is added from
  Register 8 + x'2DA'.  Register 8 should be the address of the
  WTDA but is invalid.  So when the LAM instruction then fails
  because Register 2 is not loaded with a valid address.
  .
  .
  Additional Symptom(s) Search Keyword(s): KIXREVGJT
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All CICSPlex SM V5R3M0 Users                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * After a Terminal Control abend occurs during the routing of  *
  * a Dynamic Transaction, a second ASRA abend occurs            *
  * immediately afterwards inside the CPSM WLM routing code:     *
  *                                                              *
  * EYUXL0905E cccccccc ASRA IN WDTR, OFFSET 00000320 .          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * After applying the PTF that resolves this APAR, all affected *
  * MASes must be recycled to pick up the new code.  Note that   *
  * regions do not need to be brought down and restarted at the  *
  * same time.                                                   *
  ****************************************************************
  EYU0WDTR (WDTR) is the CPSM WLM mainline dynamic routing
  program. When called to select the target region for a Dynamic
  Routing request, then it must acquire a shared CPSM lock on the
  Active Workload that the routing region is associated with. As
  such, it needs to be given control in the event of an abend to
  ensure that the workload lock is released before the request
  terminates.
  
  When the routing request in the reported problem was abended due
  to external circumstances (a CICS ATNI abend), then the Abend
  Exit in WDTR was driven, but it failed to restore addressability
  to the Workload Descriptor before attempting to release the
  workload lock. This caused the secondary ASRA abend when the
  program attempted to address the Workload Descriptor.
  

Problem conclusion

• Changes were made to the Abend Exit process in EYU0WDTR to
  ensure that if an abend does occur, then the Transaction Data
  Area address (from which the Workload Descriptor is located),
  and the WRAM program commarea address are properly restored to
  their base registers before program recovery action is
  progressed.
  

Temporary fix

Comments

APAR Information

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

  PI55370

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

  UI36377

Modules/Macros

• EYU0WDTR
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00M PSY UI36377

     UP16/04/02 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.