PQ67719: MISSING STEP IN DEFINING BBOASR1 SECTION IN WEBSPHERE INSTALLATION AND CUSTOMIZATION BOOK

APAR status
Closed as documentation error.

Error description
The following error comes out in System Management output end
WebSphere error log:
.
SYSTEM=S0W1 SERVER=BBOASR1A JobName=BBOASR1S ASID=0X0040
PID=0X05010020 TID=0X125DC730 0X000009 c=F.15
./bbolrt.cpp+1708 ... BBOU0168E Shasta Runtime function
logJavaException detected that the following exception occured
in the Java VM ...   JVM Exception Message =
java.lang.NoClassDefFoundError:_JPolicyBOImpl
.
WebSphere Installation and Customization book, GA22-7834-06 is
missing one step during defining BBOASR1 server.  The step
should instruct customers to modify CLASSPATH for BBOASR1 in the
following way:
.
CLASSPATH
Should include the following files:
path/bboplsj.jar.
path/bboplc.jar.
The default path for these last two files is
/usr/lpp/WebSphere/samples/PolicyIVP/PRODUCTION.
.
Note: After activation of this conversation, System Management
automatically prepends ws390srt.jar, waswebc.jar, and xerces.jar
to the application server CLASSPATH for you.
.
If you plan to use procedural application adapters, add the
following to CLASSPATH:
:/usr/lpp/WebSphere/lib/bboadptr.jar
:/usr/lpp/WebSphere/lib/bbokeart.jar
:/usr/lpp/WebSphere/lib/bbokpart.jar
.
Note: The ":" delimiters were added to the above example because
it is assumed you will add the path to an existing CLASSPATH.
The ":" delimiter is required between all paths you specify.
Local fix
Add the following two jars to BBOASR1 CLASSPATH:
.
path/bboplsj.jar.
path/bboplc.jar.
The default path for these last two files is
/usr/lpp/WebSphere/samples/PolicyIVP/PRODUCTION.
See Problem Description for more details.
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 include the CLASSPATH        *
*                      information for when defining the       *
*                      BBOASR1 CORBA server.                   *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The WebSphere for z/OS: Installation and Customization
publication currently leaves out the CLASSPATH information when
describing how to define the BBOASR1 CORBA server.

The WebSphere for z/OS: Installation and Customization
publication should be updated to include the CLASSPATH
information.
Problem conclusion
A change to V4.0.1 WebSphere for z/OS: Installation and
Customization (GA22-7834-06) is required. To access the latest
online documentation, go to the product library page at:

www.ibm.com/software/webservers/appserv/zos_os390/

The change is to Chapter 3, which now reads:

________________________________________________________________

Chapter 3, pg. 164 (new information)

5. Set the CLASSPATH environment variable for BBOASR1 as
follows. The Environment variable list contains three columns:

Type   The Type field tells you at which level this variable
       is defined: SY (Sysplex), SV (Server), or SI (Server
       instance).
Name   The name of the environment variable.
Value  The value of the environment variable as it is defined
       at the level which is specified by its Type.

For more information about how to add or modify environment
variables, use the help system in the Administration application
or see WebSphere Application Server V4.0.1 for z/OS and OS/390:
System Management User Interface, SA22-7838.

The following is the CLASSPATH environment variable to set:

CLASSPATH
Should include the following files:
- path/bboplsj.jar
- path/bboplc.jar

Notes:
1. The default path for bboplsj.jar and bboplc.jar is
   /usr/lpp/WebSphere/samples/PolicyIVP/PRODUCTION.
2. After activation of this conversation, System Management
   automatically prepends ws390srt.jar, waswebc.jar, and
   xerces.jar    to the application server CLASSPATH for you.

If you plan to use procedural application adapters, add the
following to CLASSPATH:
:/usr/lpp/WebSphere/lib/bboadptr.jar
:/usr/lpp/WebSphere/lib/bbokeart.jar
:/usr/lpp/WebSphere/lib/bbokpart.jar

Note: The ":" delimiters were added to the above example because
it is assumed you will add the path to an existing CLASSPATH.
The ":" delimiter is required between all paths you specify.
________________________________________________________________

The current step number 5 will then become number 6.
Temporary fix Comments
APAR information
APAR number PQ67719
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED DOC
PE NoPE
HIPER NoHIPER
Submitted date 2002-10-29
Closed date 2002-12-17
Last modified date 2002-12-17

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 #: PQ67719
IBM Group: Software Group
Modified date: Dec 17, 2002