Fix (APAR):  PQ99682

Status:  Fix

Release:  4.0.7,4.0.6,4.0.5

Operating System:  All

Supersedes Fixes:  Pre-requisite Fixes:    PQ98256

CMVC Defect:  PQ99682

Byte size of APAR:  1091937

Date: 2005-01-21

Abstract:  INDOUBT TRANSACTIONS REMAIN AFTER SERVER HAS RESTART

Description/symptom of problem:  
A transaction was distributed across two servers. When the
subordinate server failed, indoubt transactions were present,
and the server was brought back up to perform recovery.
When the server had restarted, and recovery had been driven,
the indoubt transactions remained.
The problem here is that when the transaction is imported into
a server via interop mode, the resulting XIDs are constructed using
the originating server's branch qualifier. So during recovery, the
server does not recognise the returned XIDs as belonging to it, and
so does no recovery on these XIDs.
Classes CoordinatorImpl and Util will be updated to ensure that the
XIDs generated by a server always have its own branch qualifier.



Directions to apply fix:  

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

2) Copy jar file to the directory

3) Shutdown WebSphere. It is important that you perform a controlled and complete shutdown of the server to ensure
   that all transactions have completed, before installing the fix.

4) Run the jar file with the following command answering questions/prompts as they appear:
   java -jar PQ99682_Fix.jar

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 removed, and fix3 re-applied.

1) Change directory to the fix location (<WASHOME>/WebSphere/AppServer/fix/<fix#>).

2) Shutdown WebSphere. It is important that you perform a controlled and complete shutdown of the server to ensure
   that all transactions have completed, before installing the fix.

3) Run the backup jar file with the following command:
   java -jar PQ99682_Fix_backup.jar

4) Restart WebSphere



Directions to re-apply fix:  
Follow the instructions for applying a fix.

If the backup files still exist (from the previous fix application), you will be prompted to overwrite.

Answer "yes" at the overwrite prompts.



Additional Information: