PQ86691: THIS APAR ADDRESSES DEFECTS IN WEBSPHERE APPLICATION SERVER V4.0.1 FOR Z/OS AND OS/390. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
![]() 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 is sysrouted FROM one or more of the following: APAR is sysrouted TO one or more of the following: UQ87492 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 #: PQ86691
IBM Group: Software Group
Modified date: Nov 4, 2004
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.