PH25955: REMOVE_PARTNER_LOG_ENTRY DOES NOT WORK FOR XARESOURCE.RECOVER() FAILURE

APAR status

• Closed as program error.

Error description

• The REMOVE_PARTNER_LOG_ENTRY process allows the removal of
  partners from the transaction service partner logs only if
  re-creation an XAResource for the partner fails. In some cases
  it may be required to remove a partner for which the
  XAResource can be re-created, but the XAResource.recover() can
  not succeed.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:  All users of IBM WebSphere Application      *
  *                  Server                                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: The REMOVE_PARTNER_LOG_ENTRY process    *
  *                      does not remove partners for which an   *
  *                      XAResource can be created.              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The REMOVE_PARTNER_LOG_ENTRY process allows the removal of
  partners from the transaction service partner logs only if
  re-creation of an XAResource for the partner fails. In some
  cases it may be required to remove a partner for which the
  XAResource can be re-created, but the XAResource.recover() can
  not succeed. It is also desirable to be able to remove partners
  without attempting to create the XAResource first.
  

Problem conclusion

• The point at which the REMOVE_PARTNER_LOG_ENTRY process will
  remove a partner specified in the list can now be configured
  by setting a JVM System Property.
  The JVM system property name is
  com.ibm.ws.Transaction.removePartnerLogEntryMode, the default
  value is 0. The value of the new property and the conditions
  under which a resource specified in the
  REMOVE_PARTNER_LOG_ENTRY list is removed are listed below:
  0 : if an XAResource for the partner cannot be created (this
  is the existing behaviour).
  1 : if either an XAResource for the partner cannot be created
  or the invocation of the XAResource.recover method fails.
  2 : unconditional, the partner is removed before attempting to
  recreate the XAResource.
  
  The fix for this APAR is targeted for inclusion in fix packs
  8.5.5.18 and 9.0.5.5. For more information, see 'Recommended
  Updates for WebSphere Application Server':
  https://www.ibm.com/support/pages/node/715553
  

Temporary fix

Comments

APAR Information

• 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

  WEBS APP SERV N

• Fixed component ID

  5724H8800

Applicable component levels

• R850 PSY

     UP

• R900 PSY

     UP