PQ60880: WEBSPHERE 4.01 REQUIRES JDBC MULTICONTEXT ENABLED

APAR status
Closed as documentation error.

Error description
The WAS 4.01 IVP (BBOIVPE) fails during a JDBC getConnection(),
connectionReuse() method unless MULTICONTEXT is enabled. In Jeff
's case, DB2SQLJMULTICONTEXT=NO was explicitly set in the
dbssqljjdbc.properties file. Since MULTICONTEXT is enabled by de
fault it was only necessary to remove the property. So, the docu
ment update should describe the requirement to have MULTICONTEXT
enabled in the WAS environment, and that it is enabled by defaul
t.  This is particularly important since connection management
is enabled by default.. and assumes MULTICONTEXT support.
Local fix
The workaround was to remove the DB2SQLJMULTICONTEXT=NO property
 from the sqljjdbc.properties file.  Another option is to explic
ilty enable the property "DB2SQLJMULTICONTEXT=YES".
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390                   *
****************************************************************
* PROBLEM DESCRIPTION: The WebSphere for z/OS: Installation    *
*                      and Customization publication should    *
*                      be updated to indicate that             *
*                      JDBC MULTICONTEXT must be enabled.      *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The WebSphere for z/OS: Installation and Customization
publication doesn't have a rule that JDBC MULTICONTEXT must be
enabled.

The WebSphere for z/OS: Installation and Customization
publication should be updated to include a rule that JDBC
MULTICONTEXT must be enabled and instructions on how to do it.
Problem conclusion
The following publications were revised as a result
of APAR PQ60880:
________________________________________________________________

NOTE: Periodically, we refresh the documentation on our
Web site, so the changes might have been made before you
read this text. To access the latest on-line
documentation, go to the product library page at:


http://www.ibm.com/software/webservers/appserv/
________________________________________________________________
________________________________________________________________

Document Name: WebSphere Application Server V4.0.1 for
               z/OS and OS/390: Installation and
               Customization
Document Number: GA22-7834-05
________________________________________________________________
Information on page 201 has been changed to now read:

Ensure that JDBC MULTICONTEXT is enabled in your WebSphere for
z/OS environment. It is actually enabled by default, but there
are two things you should do if you find it disabled:
- Ensure the property is present in the db2sqlj.properties file.
  See DB2 Application Programming Guide and Reference for Java,
  GC26-9932, for more information about how to associate a set
  of   properties with a JVM.
- Do one of the following:
   Remove the DB2SQLJMULTICONTEXT=NO property from the
    sqljjdbc.properties file OR
   Explicitly enable the DB2SQLJMULTICONTEXT=YES property.
If MULTICONTEXT is disabled, the BBOIVPE (J2EE) installation
verification program will fail during a JDBC getConnection()
method.
Temporary fix Comments
APAR information
APAR number PQ60880
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED DOC
PE NoPE
HIPER NoHIPER
Submitted date 2002-05-07
Closed date 2002-09-24
Last modified date 2002-09-24

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros

Fix information

Applicable component levels


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 #: PQ60880
IBM Group: Software Group
Modified date: Sep 24, 2002