PQ62044: DOCUMENT ENVIRONMENT VARIABLE, BBOO_WORKLOAD_PROFILE, THAT CONTROLS RUNTIME SETTINGS RELATED TO WORKLOAD | |||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||
![]() 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 is sysrouted FROM one or more of the following: APAR is sysrouted TO one or more of the following: UQ68593 Modules/Macros
|
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
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.