PQ61990: NEW FUNCTION - ADD APPLICATION EXTENSIONS DIRECTORY TO WEBSPHEREAPPLICATION SERVER FOR OS/390.

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
This APAR is written to have the Application Extensions
Directory added to WebSphere Application Server for OS/390.
This directory will typically contain class libraries that need
to be shared among all J2EE applications installed on the
server.  Because these classes are not visible to the WebSphere
Application Server runtime classloaders, this classpath can
contain updated versions of common libraries (such as
xerces.jar) that are present in the runtime.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: Users of WebSphere Application Server        *
*                 Version 4.0.1 for z/OS and OS/390            *
*                 who have JAR files that are required by      *
*                 multiple applications.                       *
****************************************************************
* PROBLEM DESCRIPTION: This APAR is written to have the        *
*                      Application Extensions Directory added  *
*                      to WebSphere Application Server for     *
*                      OS/390. This directory will typically   *
*                      contain class libraries that need to    *
*                      be shared among multiple applications   *
*                      installed on the J2EE server. Because   *
*                      these classes are not visible to the    *
*                      WebSphere Application Server runtime    *
*                      classloaders, this classpath can        *
*                      contain updated versions of common      *
*                      JAR files (such as xerces.jar) that     *
*                      are present in the runtime.             *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The Application Extensions Directory was
added to WebSphere Application Server for
OS/390, along with new classloader to load
classes from this directory.
All application classloaders delegate to
this new classloader, if a class is not
found in an application's classloader.
This new directory is an appropriate place
to put classes that are common to multiple
applications, so changes made to these
classes will be visible to all applications
that use them.
Problem conclusion
A new classloader was created in the class Server.java.
A new property APP_EXT_DIR was added in current.env. The default
value of the property is "<CBConfigRoot>/apps/<ServerName>/app".
All the jar files and zip files specified in the APP_EXT_DIR
along with the APP_EXT_DIR directory are added to the classpath
of this classloader. This classloader is the parent of all of
the application Classloaders. The parent of this classloader is
the WebContainer Runtime Classloader.

If a customer wants to use jar files common to all
applications, he has to create the APP_EXT_DIR and place
the jar files in the directory.

The changes affect the COMPID
5655A9800 R401 for z/OS and OS/390.

The code changes are stored in CMVC under defect PQ61990.

The Environment Variables table contained in Appendix A of
"WebSphere Application Server V4.0.1 for z/OS and OS/390:
Installation and Customization", and
"WebSphere Application Server V4.0.1 for z/OS and OS/390:
Assembling J2EE Applications" will be updated to indicate that
the new APP_EXT_DIR environment variable applies to the
J2EE server instance.

The following informatin will also be added to the property
descriptions contained in these Appendixes:

APP_EXT_DIR

Specifies that location of the Application Extensions Directory
containing the (fill in the name of this new classloader)
classloader and the classes and JAR files that are common to
multiple applications. This classloader is the parent of all of
the application classloaders.

Example:
APP_EXT_DIR=<CBConfigRoot>/apps/<Server1>/app

The default value is <CBConfigRoot>/apps/<ServerName>/app

The latest version of these publications are available at URL:

http://www.ibm.com/software/webservers/appserv/zos_os390
/library.html
401Y
EJSJWCSC
EJSJWCWC

* Cross Reference between External and Internal Names
Temporary fix Comments
APAR information
APAR number PQ61990
Reported component name WEBSPHERE OS/39
Reported component ID 5655A9800
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2002-06-06
Closed date 2002-07-12
Last modified date 2002-08-04

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros
EJSJWCSC EJSJWCWC        

Fix information
Fixed component name WEBSPHERE OS/39
Fixed component ID 5655A9800

Applicable component levels
R401 PSY UQ68063    UP02/07/22 P F207

  Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 401
Software edition:
Reference #: PQ61990
IBM Group: Software Group
Modified date: Aug 4, 2002