IBM Support

PI74163: WEBSPHERE APPLICATION SERVER FOR Z/OS STARTED IN RECOVERY-ONLY MODE FAILS TO COMPLETE WHEN THE COMPENSATION SERVICE IS ENABLED.

Fixes are available

9.0.0.6: WebSphere Application Server traditional V9.0 Fix Pack 6
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13
9.0.0.7: WebSphere Application Server traditional V9.0 Fix Pack 7
9.0.0.8: WebSphere Application Server traditional V9.0 Fix Pack 8
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
9.0.0.9: WebSphere Application Server traditional V9.0 Fix Pack 9
9.0.0.10: WebSphere Application Server traditional V9.0 Fix Pack 10
8.5.5.15: WebSphere Application Server V8.5.5 Fix Pack 15
9.0.0.11: WebSphere Application Server traditional V9.0 Fix Pack 11
9.0.5.0: WebSphere Application Server traditional Version 9.0.5 Refresh Pack
9.0.5.1: WebSphere Application Server traditional Version 9.0.5 Fix Pack 1
9.0.5.2: WebSphere Application Server traditional Version 9.0.5 Fix Pack 2
8.5.5.17: WebSphere Application Server V8.5.5 Fix Pack 17
9.0.5.3: WebSphere Application Server traditional Version 9.0.5 Fix Pack 3
9.0.5.4: WebSphere Application Server traditional Version 9.0.5 Fix Pack 4
9.0.5.5: WebSphere Application Server traditional Version 9.0.5 Fix Pack 5
WebSphere Application Server traditional 9.0.5.6
9.0.5.7: WebSphere Application Server traditional Version 9.0.5 Fix Pack 7
9.0.5.8: WebSphere Application Server traditional Version 9.0.5.8
8.5.5.20: WebSphere Application Server V8.5.5.20
8.5.5.18: WebSphere Application Server V8.5.5 Fix Pack 18
8.5.5.19: WebSphere Application Server V8.5.5 Fix Pack 19
9.0.5.9: WebSphere Application Server traditional Version 9.0.5.9
9.0.5.10: WebSphere Application Server traditional Version 9.0.5.10
8.5.5.16: WebSphere Application Server V8.5.5 Fix Pack 16
8.5.5.21: WebSphere Application Server V8.5.5.21
9.0.5.11: WebSphere Application Server traditional Version 9.0.5.11

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A WebSphere Application Server on z/OS started in recovery-only
    mode fails to complete when transaction recovery requires the
    Compensation service be active.
    
    For each recovery attempt there is a message:
    WTRN0151I: Preparing to call xa recover on XAResource: WAS
    Compensation RA
    
    The response is:
    WTRN0005W message text including
    com.ibm.ws.Transaction.XAResourceNotAvailableException
    
    Since the compensation service may require to execute
    compensators (which are user applications) recovery only mode
    cannot necessarily complete all compensation scopes, but it
    should be able to process transaction outcomes even if it
    can't yet run the compensators.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:  WebSphere Application Server users of the   *
    *                  Compensation Service                        *
    ****************************************************************
    * PROBLEM DESCRIPTION: A start of the application server in    *
    *                      recovery-only mode may fail to          *
    *                      complete when the compensation          *
    *                      service is enabled.                     *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    If an application server is started in recovery-only mode and
    the Compensation service has been registered as a transaction
    service participant then transaction recovery will receive a
    com.ibm.ws.Transaction.XAResourceNotAvailableException when
    calling the Compensation Service's XAResource.  The
    recovery-only mode start will continually retry to recover the
    failing resource receiving the same exception on every
    attempt.  Since the application server only terminates in
    recovery-only mode after all transactional recovery is
    complete, the application server remains running until halted
    by external intervention.
    The job logs will show repeated WTRN0005W messages identifying
    the resource as com.ibm.ws.cscope.CScopeXAResourceInfo and the
    cause of failure as
    com.ibm.ws.Transaction.XAResourceNotAvailableException
    

Problem conclusion

  • The application server configuration was modified so that
    additional components are started in recovery-only mode.
    These components allow the compensation service to respond
    correctly to the request to perform XAResource.recover and
    also to log any transaction outcomes sent to its XAResource,
    allowing transaction recovery to complete.  The compensation
    service cannot execute compensators when the application
    server is running in recovery-only mode so there may be
    compensation scopes still requiring compensator close or
    compensate actions to be executed, but the compensation
    service will have logged any transaction outcomes required to
    complete any such compensation scopes on a future restart
    independently of the transaction service.
    
    The fix for this APAR is currently targeted for inclusion in
    fix packs 8.5.5.13 and 9.0.0.6.  Please refer to the
    Recommended Updates page for delivery information:
    http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI74163

  • Reported component name

    WEBSPHERE FOR Z

  • Reported component ID

    5655I3500

  • Reported release

    850

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-12-22

  • Closed date

    2017-09-18

  • Last modified date

    2017-09-18

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

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

Fix information

  • Fixed component name

    WEBSPHERE FOR Z

  • Fixed component ID

    5655I3500

Applicable component levels

  • R850 PSY

       UP

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS7K4U","label":"WebSphere Application Server for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"850","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
04 May 2022