Fix (APAR):  PQ89426

Status:  Fix

Release:  5.0.2.7,5.0.2.6,5.0.2.5,5.0.2.4,5.0.2.3

Operating System:  All

Supersedes Fixes:  Pre-requisite Fixes:

CMVC Defect:  PQ89426

Byte size of APAR:  44591

Date: 2004-06-30

Abstract:  rollbackOnly status is not returned to a superior server.

Description/symptom of problem:  
When a server calls a method that runs on a subordinate
server and a setRollbackOnly call is made, this status
change is not reflected back to the superior (originating)
server. Applications in the superior node cannot determine
if the transaction has been marked for rollback, if the status
change was made in a subordinate server.
The transaction service will be changed so that when a
transaction is marked for rollbackOnly in a subordinate
server, the superior server will be informed. This will
allow applications running in the superior server to
detect this status change.
To become effective, please note the following:
This fix must be applied to all servers involved in the
transaction, and every server must be defined to use
interop mode, by specifying the following JVM settings:
com.ibm.ejs.jts.jts.ControlSet.nativeOnly=false
com.ibm.ejs.jts.jts.ControlSet.interoperabilityOnly=true
In addition, the fix for PQ88653 must be applied to all
servers involved in the transaction.



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. 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) 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. 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.

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. 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.

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: