Fix (APAR): IY67810
Status: Fix

Release: WebSphere Business Integration Server Foundation 5.1.1

CMVC defect: IY67810

Byte size of APAR: 116,996

Date: 02/23/2005

Abstract: NPE or failing uninstall with multiple versions of a process template.

Description/symptom of problem:

Symptom:
--------

When using multiple process templates with the same name, you might encounter
a null pointer exception during process navigation or a situation where 
the process cannot be uninstalled.

The log file might report exceptions such as:
    java.lang.NullPointerException at com.ibm.bpe.engine.BpelAssignmentHandler.createInitialWorkItems(BpelAssignmentHandler.java:319)
or
    BPEC0024E: Process p1 of application a1 is not stopped. Stop the templates manually before updating or uninstalling a process application.



Problem:
--------

When dealing with two process templates with the same name, staff entries for the
older one might get corrupted or a request to stop the template might unintentionally
stop another process template with the same name.
As a result, process navigation cannot continue on an older version of process template
or a process which is reinstalled with the same name cannot be uninstalled.


Solution:
---------
This fix solves a problem in the process template cache implementation where a wrong process template
might get selected for an operation.

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


Directions to apply Fix:

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 Update Installer on how to install the Fix.

5) Restart WebSphere

6) The temp directory may be removed.


Directions to remove a 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) Shutdown WebSphere

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

3) Restart WebSphere


Additional Information:
------------------------------------------------------------------