Fix (APAR):  PQ76107

Status:  Fix

Release:  5.0.2

Operating System:  Windows XP,Windows NT,Windows 2000,SunOS/Solaris,Linux Intel,AIX

Supersedes Fixes:  

CMVC Defect:  170455

Byte size of APAR:  15901

Date: 2003-07-15

Abstract:  Problem with J2EE client samples launchAPI and classLoader

Description/symptom of problem:  When running the classLoader sample, the application output looks like:

--------------------------------------------------------------
Running ClassLoaderClientMain from the
J2EEAppClientClassLoader.ear file
--------------------------------------------------------------

IBM WebSphere Application Server, Release 5.0
J2EE Application Client Tool
Copyright IBM Corp., 1997-2002
WSCL0012I: Processing command line arguments.
WSCL0013I: Initializing the J2EE Application Client Environment.
WSCL0100E: Exception received: com.ibm.etools.archive.exception.ArchiveWrappedEx
ception
Stack trace of nested exception:
com.ibm.etools.archive.exception.ResourceLoadException: IWAE0007E Could not load
 resource "META-INF/ibm-application-client-bnd.xmi" in archive "J2EEAppClientCla
ssLoaderClient.jar"
Stack trace of nested exception:
java.lang.NullPointerException
        at com.ibm.etools.archive.impl.InternalModuleHelper.getDDResourceURIIfPr
oxy(InternalModuleHelper.java:60)
        at com.ibm.etools.archive.impl.InternalModuleHelper.getDDResourceIfProxy
(InternalModuleHelper.java:64)
        at com.ibm.etools.archive.impl.InternalModuleHelper.appClientBindingsLoa
ded(InternalModuleHelper.java:146)
        at com.ibm.etools.archive.impl.InternalModuleHelper.fixupBndOrExtRootsIf
Necessary(InternalModuleHelper.java:44)
   ... more

When running the launchAPI sample, the application output looks like:

--------------------------------------------------------------
Running LaunchAPIClientMain from the LaunchAPI.ear file
using launch API
--------------------------------------------------------------

IBM WebSphere Application Server, Release 5.0
J2EE Application Client Tool
Copyright IBM Corp., 1997-2002
WSCL0013I: Initializing the J2EE Application Client Environment.
launch() failed.  See stack trace for details:
java.lang.reflect.InvocationTargetException
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.
java:79)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAcces
sorImpl.java:41)
        at java.lang.reflect.Method.invoke(Method.java:371)
        at com.ibm.websphere.samples.j2eeappclients.launchapi.LaunchAPIMain.main
(LaunchAPIMain.java:83)
Caused by: com.ibm.websphere.client.applicationclient.ClientContainerException:
com.ibm.etools.archive.exception.ArchiveWrappedException
Stack trace of nested exception:
com.ibm.etools.archive.exception.ResourceLoadException: IWAE0007E Could not load
 resource "META-INF/ibm-application-client-bnd.xmi" in archive "LaunchAPIClient.
jar"
Stack trace of nested exception:
java.lang.NullPointerException
        at com.ibm.etools.archive.impl.InternalModuleHelper.getDDResourceURIIfPr
oxy(InternalModuleHelper.java:60)
        at com.ibm.etools.archive.impl.InternalModuleHelper.getDDResourceIfProxy
(InternalModuleHelper.java:64)
        at com.ibm.etools.archive.impl.InternalModuleHelper.appClientBindingsLoa
ded(InternalModuleHelper.java:146)
        ... more


Directions to apply fix:  

NOTE:  YOU MUST FIRST DOWNLOAD THE UPDATE 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.

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) Shutdown WebSphere

2) Follow the instructions that are packaged with the Fix Installer on how to uninstall 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:  This fix is only for a WebSphere Application Server Application Clients install.