PQ74696: EJB EXCEPTION HANDLING OF REMOTE EXCEPTIONS INCONSISTENT ACROSS PLATFORMS

 A fix may be available

Obtain the fix for this APAR



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 information
APAR number PQ74696
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2003-05-30
Closed date 2003-08-08
Last modified date 2003-09-05

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros
BBOUBINF          

Fix information
Fixed component name WASKBASE
Fixed component ID 5655A9801

Applicable component levels
R401 PSY UQ79317    UP03/08/14 P F308

  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 #: PQ74696
IBM Group: Software Group
Modified date: Sep 5, 2003