PQ74696: EJB EXCEPTION HANDLING OF REMOTE EXCEPTIONS INCONSISTENT ACROSS PLATFORMS | |||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||
![]() APAR status Closed as program error. Error description In WebSphere 4.01 there is a discrepency between the Distributed WebSphere return of container.UnCheckedException vs. the S390 WebSphere return of CORBA.portable.UnknownException when a remote exception is returned to the client.Local fix The default value of this environmental property is "false". With this APAR in place, the customer can experience a smoother transition to the v5.0 product where both platforms sync up the behaviour in a common manner. In addition, an e-fix from the distributed WebSphere product is made availiable to correct a minor flaw in the type of one of the exceptions that are being nested. This is the same nesting fix being provided by this APAR for WebSphere for z/OS.Problem summary **************************************************************** * USERS AFFECTED: All users of WebSphere Application Server * * version 4.0.1 for z/OS and OS/390 * **************************************************************** * PROBLEM DESCRIPTION: Exception handling/wrapping is not * * consistent across WebSphere platforms. * * z/OS exception nesting does not * * contain:com.ibm.ejs.container * * .UncheckedException * **************************************************************** * RECOMMENDATION: * **************************************************************** The way that application level exceptions are reported to clients vary between WebSphere for z/OS and the rest of the platforms. Distributed exceptions typically consist of a ServerException wrapping a com.ibm.ejs.container.UncheckedException However WebSphere for z/OS exception nests do not have this structure.Problem conclusion The environment variable DISTRIBUTED_UNCHECKED_EX has been added to WebSphere for z/OS. When this environment variable is set to true, WebSphere for z/OS handles runtime and application exceptions the same way as the rest of the WebSphere platforms. The following documentation changes will be made as a result of APAR PQ74696: NOTE: Periodically, we refresh the documentation on our Web site, so these changes might have been made before you read this text. To access the latest on-line documentation, go to the product library page at URL: www.ibm.com/software/webservers/appserv/zos_os390/library/ The Environment Variables table contained in Appendix A of "WebSphere Application Server V4.0.1 for z/OS and OS/390: Installation and Customization",GA22-7834-07, and "WebSphere Application Server V4.0.1 for z/OS and OS/390: Assembling J2EE Applications",SA22-7836-06, to include the new DISTRIBUTED_UNCHECKED_EX environment variable, along with an indication that it applies to a J2EE server instance. These appendices will also be updated to include the following description of this environment variable: DISTRIBUTED_UNCHECKED_EX=true or false Indicates that WebSphere for z/OS is to handle (or wrap) runtime and application exceptions the same way they are handle on the other WebSphere platforms. The default is false. APAR PQ74696 is associated with SERVICE LEVEL W401511 of WebSphere Application Server version 4.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: 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 #: PQ74696
IBM Group: Software Group
Modified date: Sep 5, 2003
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.