PQ86691: THIS APAR ADDRESSES DEFECTS IN WEBSPHERE APPLICATION SERVER V4.0.1 FOR Z/OS AND OS/390.

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
This APAR addresses defects in WebSphere Application Server
V4.0.1 for z/OS and OS/390.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 version 4.0.1 for z/OS and OS/390            *
****************************************************************
* PROBLEM DESCRIPTION: (LIDB3082.1) WebSphere Application      *
*                      Server V4.0.1 for z/OS and OS/390       *
*                      support for z/OS Work Load Manager      *
*                      (WLM) APAR 
OA04699.                     *
*                                                              *
*                      (MD19521) Full Value Description (FVD)  *
*                      support is required for                 *
*                      interoperability between WebSphere      *
*                      Application Server for z/OS and OS/390  *
*                      v4.0.1 and future releases of WebSphere *
*                      Application Server for z/OS.            *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
(LIDB3082.1) WebSphere Application Server for z/OS support for
z/OS WLM APAR 
OA04699.  The issue addressed by this
fix is the lack of even distribution of stateful sessions across
all available servants due to the fact that, at the time the
sessions are established, the system workload is low and thus
the "first available" servant (as determined by WLM to direct
work) is repeatedly the same servant.  While system workload
remains low, stateful sessions accumulate in the same "first
available" servant.  When workload increases, the established
stateful sessions force all work to be directed to the same
servant (that contains all the sessions) while all the other
servants maintain low workloads, or are simply idle waiting
for non-stateful work.

(MD19521) Due to changes in the 1.4.1 JDK, there are some
instances where the marshalling engine must have access to FVD
information in order to correctly demarshal parameters.
Without FVD support, a remote non-WAS server may fail with
CORBA::UNKNOWN or CORBA::MARSHAL exceptions and details about
being unable to demarshal a value from the stream. There
may also be messages about the sending runtime context
being unavailable or missing.
Problem conclusion
(LIDB3082.1) This support allows the WebSphere administrator
to select a WLM distribution scheme for the placement of
stateful sessions. The default scheme is FIRST AVAILABLE
distribution, in which a newly established stateful session is
placed in the first available servant.  When workloads are low,
this scheme could possibly result in a disproportionate number
of stateful sessions being established in one particular servant
rather than evenly distributed across all available servants.
The alternative WLM distribution scheme is ROUND ROBIN, in which
stateful sessions are evenly established across all available
servants in a round robin distribution pattern, regardless of
system workload.

Please note:

Support provided by feature LIDB3082.1 delivered in APAR PQ86691
requires support provided by z/OS Work Load Manager (WLM)
APAR 
OA04699 to be made functional. The support provided in APAR
PQ86691 has been coded in such a manner that if the 
OA04699
support is not present on a system running with Service Level
W401611 (Service Level W401611 delivers APAR PQ86691) then the
support provided in APAR PQ86691 will not be active. There
exists no SMP/E apply dependency on the z/OS Work Load Manager
support provided by APAR 
OA04699, it is a functional runtime
issue.

Feature LIDB3082.1 delivered in APAR PQ86691 requires the
following change to documentation:

A new document, "WebSphere Application Server V4.0.1 for z/OS
Documentation for the New WLM Even Distribution of HTTP
Requests Support Provided in APAR PQ86691" is available on the
product support page under "Learn" ->"Product Information" ->
Document Type -> Product Documentation. The Product Support
page is located at:
www.ibm.com/software/webservers/appserv/zos_os390/Support/

This document is intended to be used in conjunction with
WebSphere Application Server V4.0.1 for z/OS and OS/390:
Assembling Java2 Platform, Enterprise Edition (J2EE)
Applications, SA22-7836?06. The information contained in this
document will be added to the Assembling J2EE Applications
publication the next time it is updated.

To access the latest online documentation, go to
the product library page at:
www.ibm.com/software/webservers/appserv/zos_os390/library/

The change involves adding two new sections to the
Assembling J2EE Applications publication:

"WLM even distribution of HTTP requests"
"Configuring an Application Server to use the WLM even
distribution of HTTP requests function"

In addition, the following description of the new
WebSphere environment variable will be added to the
"Environment files and environment variables" section of
Appendix A

WLM_STATEFUL_SESSION_PLACEMENT_ON= 1|0

Specifies whether or not incoming HTTP requests without
server region affinity are to be distributed across server
regions. If this variable is set to 1, incoming HTTP
requests without server region affinity will be distributed
across server regions. If it is set to 0, WLM will use
service class designations when assigning HTTP requests to
server regions.

Example: WLM_STATEFUL_SESSION_PLACEMENT_ON=1


(MD19521) FVD Support has been rolled back to WebSphere
Application Server V4.0.1 for z/OS and OS/390.

Note: WebSphere V401 still requires JDK 1.3.1.  A WebSphere
V4.0.1 server cannot use JDK 1.4.1.  This enhancement is made
for interoperability with other servers that are using
JDK 1.4.1 and the ability to demarshal requests coming from
these servers.

The following publication was revised as a result
of defect MD19521 shipped in APAR PQ86691:
________________________________________________________________
WebSphere Application Server V4.0.1 for z/OS and OS/390
Messages and Diagnosis
GA22-7837-07
_______________________________________________________________
This APAR requires changes to documentation.

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:

www.ibm.com/software/webservers/appserv/zos_os390/library.html
________________________________________________________________
Chapter 16, new code
C9C21316
Explanation: The build_IOR method failed to create an IOR.
User Response: Report this problem to your next level
of support or to the IBM Support Center.
________________________________________________________________
Chapter 16, new code
C9C21317
Explanation: The getJavaEnv external function was not found in
 the BBOLRT dll.
User Response: Check to be sure that the correct version of
 BBOLRT is accessible to the failing address space either
 through STEPLIB,LNKLST or via loading the runtime into LPA.
________________________________________________________________
Chapter 16, new code
C9C21318
Explanation: The BBOLRT dll was not able to be loaded.
User Response: Check to be sure that the correct version of
 BBOLRT is accessible to the failing address space either
 through STEPLIB,LNKLST or via loading the runtime into LPA.
________________________________________________________________
Chapter 16, new code
C9C21319
Explanation: IBM Internal Only
User Response: Contact the IBM Support Center.
________________________________________________________________
Chapter 16, new code
C9C2131A
Explanation: IBM Internal Only
User Response: Contact the IBM Support Center.
________________________________________________________________
Chapter 16, new code
C9C2131B
Explanation: IBM Internal Only
User Response: Contact the IBM Support Center.
________________________________________________________________
Chapter 16, new code
C9C2131C
Explanation: IBM Internal Only
User Response: Contact the IBM Support Center.
________________________________________________________________
Chapter 16, new code
C9C2131D
Explanation: IBM Internal Only
User Response: Contact the IBM Support Center.
________________________________________________________________
Chapter 16, new code
C9C2E445
Explanation: The minor code indicates an out of memory
  condition when a WebSphere module attempted to allocate
  storage.
User Response: See minor code C9C2E001.
________________________________________________________________
Chapter 16, new code
C9C2E446
Explanation: The minor code indicates an out of memory
  condition when a WebSphere module attempted to allocate
  storage.
User Response: See minor code C9C2E001.

APAR PQ86691 is associated with SERVICE LEVEL W401611 of
WebSphere Application Server version 4.0.1 for z/OS and OS/390.
Temporary fix Comments
**** PE04/10/12 FIX IN ERROR. SEE APAR 
PQ94473  FOR DESCRIPTION
APAR information
APAR number PQ86691
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2004-03-25
Closed date 2004-08-17
Last modified date 2004-11-04

APAR is sysrouted FROM one or more of the following:

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

Modules/Macros
BBOAXCEI BBOAXIAI BBOBOA BBOCCFMT BBOCHSES BBOCHSSS
BBOCLSES BBOCLSHS BBOCOMM BBOCORBA BBOCPOCB BBOCSESS
BBOCSHSB BBOCSMGR BBOCSMHS BBOCSMRH BBOCSMRI BBOCSMRL
BBOCSMRS BBOCSSES BBOCSSHS BBODASR BBODDAUT BBODMN
BBOFRCGC BBOFRCGD BBOFRCGS BBOIBOIM BBOIDRMI BBOIGTID
BBOIIMA BBOIIMC BBOIIMF BBOIIMS BBOIRDB BBOITLS
BBOI3PLI BBOJJU BBOLRT BBOLRTU BBOLSREQ BBOLSS
BBOLSVNM BBOLSYS BBOMDDLI BBOMDDLO BBOMDDLV BBOMDDLX
BBOMDDLZ BBOMENV BBOMIBO BBOMICP BBOMIDO BBOMIMEX
BBOMIMG BBOMIMO BBOMIPK BBOMPROC BBOMR BBOMRBO
BBOMRDO BBOMRMO BBOMRPK BBOMSBO BBOMSCO BBOMSCP
BBOMSCR BBOMSDO BBOMSMO BBOMSMS BBOMSPK BBOOACRT
BBOOBOAI BBOOBOAT BBOOBOKC BBOOCBI BBOOCBS BBOOCOMH
BBOOCOMM BBOOCRHT BBOOCSIT BBOOCTL BBOOEJSB BBOOHSA
BBOOIREQ BBOOJORB BBOONED BBOOOPIP BBOOOPIX BBOOORB
BBOOORBP BBOOORBR BBOOORBX BBOOOUTP BBOOPCCR BBOORCTX
BBOORDTA BBOOREQ BBOOSMFJ BBOOSMFT BBOOSR BBOOSRWT
BBOOTMOT BBOOTRD BBOOTTIP BBOOTTIX BBOOWCON BBOPBO
BBOPBSC BBOPCH BBOPCO BBOPDO BBOPMO BBOPPK
BBOPUDMP BBOPUDOP BBOPUDOT BBOPUDSC BBOPUINT BBOPUIOB
BBOPUIOP BBOPUIRP BBOPUISC BBORAS BBORBLOG BBORJLOG
BBORJTR BBORJTRC BBORJWTO BBORLOGI BBOROBML BBOROBMS
BBOROMDL BBOROOPI BBOROSMD BBORRMGR BBORTRCD BBOSEXT
BBOSICI BBOSLAD BBOSLCL BBOSLDO BBOSLHM BBOSLLO
BBOSLMC BBOSLMO BBOSLPK BBOSLRA BBOSLRL BBOSLSO
BBOSLXL BBOSM BBOSNCN BBOSNCO BBOSNDO BBOSNFED
BBOSNLN BBOSNMO BBOSNNDM BBOSNPK BBOSNSS BBOSNXN
BBOSQ01 BBOSQ03 BBOSSCOB BBOSSDB2 BBOSSECM BBOSSESS
BBOSSEXT BBOSSICS BBOSSITU BBOSSJRA BBOSSMET BBOSSOUT
BBOSSRIB BBOSSRPW BBOSSRVA BBOTOTS2 BBOTTJCU BBOTTMSR
BBOUBINF BBOUJUU BBOUTHRD BBOZ0155 BBOZ0229 BBOZ0244
BBOZ0247 BBOZ0279 BBOZ0812 BBOZ0813 BBOZ0916 BBOZ0917
BBOZ0918 BBOZ0919 BBOZ0920 BBOZ0921 BBOZ0922 BBOZ0923
BBOZ0924 BBOZ0925 BBOZ0926 BBOZ0927 BBOZ0928 BBOZ0929
BBOZ0930 BBOZ0931 BBOZ0932 BBOZ0933 BBO3B ***This
field was truncated. To obtain the
full apar record, please contact your
local support center.***      

Fix information
Fixed component name WASKBASE
Fixed component ID 5655A9801

Applicable component levels
R401 PSY UQ87492    UP04/04/22 P F404

  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 #: PQ86691
IBM Group: Software Group
Modified date: Nov 4, 2004