Handling Runtime and Application Exceptions
 Technote (FAQ)
 
Problem
Two new environment variables, DISTRIBUTED_UNCHECKED_EX and AUDIT_UNCHECKED_EX, have been added to WebSphere® Application Server for
z/OS® V4.0.1 They enable you to specify how you want runtime and application exceptions to be handled.
 
 
Solution
APARs PQ75193 and PQ74696 add two new environment variables,
  • DISTRIBUTED_UNCHECKED_EX
  • AUDIT_UNCHECKED_EX, to WebSphere for z/OS V4.0.1.

When the DISTRIBUTED_UNCHECKED_EX environment variable (APAR PQ75193) is set to true, WebSphere Application Server for z/OS handles runtime and application exceptions the same way as the rest of the WebSphere Application Server platforms.

When the AUDIT_UNCHECKED_EX environment variable (APAR PQ74696) is set to true, Message BBOJ0076W will be issued whenever an unexpected application level exception occurs.

The following changes will be made to Appendix A of both WebSphere Application Server V4.0.1 for z/OS and OS/390: Assembling J2EE Applications, SA22-7836-06, and WebSphere Application Server V4.0.1 for z/OS and OS/390: Installation and Customization, GA22-7834-07:
  • The Environment Variables table will be updated to include the new DISTRIBUTED_UNCHECKED_EX and AUDIT_UNCHECKED_EX environment variables, along with an indication that they apply to a J2EE server instance.
  • The following descriptions of these environment variables will be added:
DISTRIBUTED_UNCHECKED_EX=true or false

Indicates that WebSphere Application Server for z/OS is to handle runtime and application exceptions the same way they are handle on the other WebSphere Application Server platforms. Specifically, WebSphere Application Server for z/OS will wrap nested exceptions in the same manner as the rest of the platforms.

The default is false.

AUDIT_UNCHECKED_EX=true or false

Specifies that message BBOJ0076W is to be issued whenever an unexpected application level exception occurs.

The default is false.

The following description of message BBOJ0076W will be added to "WebSphere Application Server V4.0.1 for z/OS and OS/390: Messages and Diagnosis, GA22-7837-07:

BBOJ0076W: Unchecked application exception occurred: {0}

Explanation: An EJB™ method failed with the reported unchecked exception.

User Response: Refer to the exception data to debug the
application failure.


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:
http://www.ibm.com/software/webservers/appserv/zos_os390/library.htm
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS > Administrative Console (all non-scripting)
Operating system(s): z/OS
Software version: 4.0.1
Software edition:
Reference #: 1137321
IBM Group: Software Group
Modified date: Jun 21, 2004