Fix (APAR):  PQ80962

Status:  Fix

Release:  5.0.2

Operating System:  All

Supersedes Fixes:  Pre-requisite Fixes:

CMVC Defect:  PQ80962

Byte size of APAR:  15183

Date: 2004-01-12

Abstract:  The nested exception logged in SystemOut.log when WTRN0008W is logged is generic and hides the underlying cause of the problem.

Description/symptom of problem:  

The WebSphere source code in the XARecoveryData logic catches
one exception when a XARecoveryFailure occurs trying to recover
units of work (transactions) that are in the
WebSphere/AppServer/logs/serverName/tranlog file, but then it
throws a generic exception back to the caller of
com.ibm.ejs.jts.jta.recovery.XARecoveryData.replay, which
results in the nested exception (the root cause exception) being
described as a java.lang.Exception rather than being the real
exception that caused the failure in the first place.



Directions to apply fix:  

NOTE:  YOU MUST FIRST DOWNLOAD THE FIX INSTALLER TOOL IN ORDER TO INSTALL A FIX.
       The Fix Installer can be downloaded from the following link:
       http://www-3.ibm.com/software/webservers/appserv/support/index.html

1) Create temporary "fix" directory to store the jar file:
             UNIX: /tmp/WebSphere/fix
          Windows: c:\temp\WebSphere\fix

2) Copy jar file to the directory

3) Shutdown WebSphere

4) Follow the Fix installation instructions that are packaged with the Fix Installer on how to install the Fix.

5) Restart WebSphere

6) The temp directory may be removed but the jar file should be saved.  Do not remove
   any files created and stored in the <WASHOME>/WebSphere/AppServer/fix/<fix> directories.
   These files are required if a fix is to be removed.




Directions to remove fix:  
NOTE:  FIXES MUST BE REMOVED IN THE ORDER THEY WERE APPLIED.  DO NOT REMOVE A FIX UNLESS
     ALL FIXES APPLIED AFTER IT HAVE FIRST BEEN REMOVED.  YOU MAY REAPPLY ANY REMOVED FIX.

Example:  If your system has fix1, fix2, and fix3 applied in that order and fix2 is to be
          removed, fix3 must be removed first, fix2


1) Shutdown WebSphere

2) Follow the Fix instructions that are packaged with the Fix Installer on how to uninstall and reinstall the Fix.

3) Restart WebSphere



Directions to re-apply fix:  
1) Shutdown WebSphere

2) Follow the Fix instructions that are packaged with the Fix Installer on how to uninstall and reinstall the Fix.

3) Restart WebSphere





Additional Information: