PQ62044: DOCUMENT ENVIRONMENT VARIABLE, BBOO_WORKLOAD_PROFILE, THAT CONTROLS RUNTIME SETTINGS RELATED TO WORKLOAD

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
Environment variable, BBOO_WORKLOAD_PROFILE, controls decisions
the WebSphere runtime will make pertinent to workload, such as
the number of worker threads used in the server region.  This
environment variable and its values need to be documented in
WebSphere publications for environment variables.  The 4 values
are:
.
NORMAL
Use this option for runtime behavior prior to taking advantage
of BBOO_WORKLOAD_PROFILE.  For threads in a server region, this
would be the combination of settings for the application server
in the Administration Application (SM EUI) for
"Production Server" and "Isolation Policy".
.
IOBOUND
.
CPUBOUND
.
LONGWAIT
To be used for workload that is in waits for long periods of
time where the waits are not IO related.
.
The environment variable and its value will also appear in the
job log information with the other WebSphere environment
variables and server settings.
.
This environment variable, BBOO_WORKLOAD_PROFILE, can be used
starting with service level W401046 (PTF UQ65454) or higher.
Local fix
If you are running with service level W401046 or higher and
need to know what the value of the number of threads being
used for the server region prior to this APAR which will print
the value in the job log, temporarily enable ORB detailed trace
(TRACEDETAIL=4) in the application server's current.env
and look for the trace record labeled:
"SR Thread count calculation"
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390                   *
****************************************************************
* PROBLEM DESCRIPTION: Message BBOU0590I, "Server region       *
*                      thread pool size: ", does not           *
*                      accurately indicate the number of       *
*                      server region threads dictated by the   *
*                      BBOO_WORKLOAD_PROFILE environment       *
*                      variable.                               *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The environment variable BBOO_WORKLOAD_PROFILE, which can be
set for the application server instance, determines the
number of threads allocated to the server region's thread
pool. This environment variable can be set to one of the
following values: NORMAL, IOBOUND, CPUBOUND, or LONGWAIT.

Message BBOU0590I, "Server region thread pool size: ", should
display a value based on the setting of the
BBOO_WORKLOAD_PROFILE environment variable. Currently,
however, BBOU0590I only displays a value for the server
region thread pool size based on the NORMAL setting of
BBOO_WORKLOAD_PROFILE.
Problem conclusion
To display the correct value of the server region thread pool
size in message BBOU0590I, the product code was modified to
calculate the thread pool size based on the current setting of
the BBOO_WORKLOAD_PROFILE environment variable.

A change to V4.0.1 WebSphere for z/OS: Installation and
Customization, GA22-7834-04 was made available in March,
2002. 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 the table on page 366, which now reads:

|--------------------------------------------------------------|
| Environment     | ... | System     | ... | Business    | ... |
| variable=       |     | Management |     | application |     |
| <default>       |     | server     |     | server      |     |
|                 |     | instance   |     | instance    |     |
|--------------------------------------------------------------|
| ...                                                          |
|--------------------------------------------------------------|
| BBOLANG=ENUS    | ... | ...        | ... | ...         | ... |
|--------------------------------------------------------------|
| BBOO_WORKLOAD_  |     | O          |     | O           |     |
|  PROFILE=value  |     |            |     |             |     |
|--------------------------------------------------------------|
| BEAN_DELETE_    | ... | ...        | ... | ...         | ... |
|  SLEEP_TIME=4200|     |            |     |             |     |
|--------------------------------------------------------------|
| ...                                                          |
|--------------------------------------------------------------|

and to Appendix A, which now reads:

BBOO_WORKLOAD_PROFILE=value
Controls workload-pertinent decisions made by the WebSphere for
z/OS runtime, such as the number of threads used in the server
region. The default value is NORMAL, which is the appropriate
value for most applications. Consider using one of the other
values when your application requires more threads.
NORMAL
   Gives you either one or three threads based on the isolation
   level setting for the server. This value is the default.
IOBOUND
   Use IOBOUND if you want more threads in applications that
   perform I/O-intensive processing on z/OS. The number of
   threads is calculated based on your number of CPUs.
CPUBOUND
   Use CPUBOUND if you want more threads in applications that
   perform processor-intensive operations on z/OS. The number of
   threads is calculated based on your number of CPUs.
LONGWAIT
   Use LONGWAIT for application processing that involves waiting
   for extended periods of time.
Example: BBOO_WORKLOAD_PROFILE=NORMAL

APAR PQ62044 is associated with SERVICE LEVEL W401089 of
WebSphere Application Server V4.0.1 for z/OS and OS/390.
Temporary fix Comments
APAR information
APAR number PQ62044
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2002-06-07
Closed date 2002-07-31
Last modified date 2002-09-04

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:
UQ68593

Modules/Macros
BBOMSCSR BBOSM BBOUBINF H28W401J    

Fix information
Fixed component name WASKBASE
Fixed component ID 5655A9801

Applicable component levels
R401 PSY UQ68593    UP02/08/07 P F208

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