PQ74792: ABEND EC3 RSN=04130001 WHEN A REQUEST TIMESOUT FROM AN HTTP AND/OR HTTP SSL TRANSPORT

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
Websphere for Z/OS supports a time-out limit for requests
received over HTTP and HTTP SSL transports. (This relates to
timers BBOC_HTTP_SSL_OUTPUT_TIMEOUT and
BBOC_HTTP_OUTPUT_TIMEOUT) The recovery action for a timed out
HTTP request may involve bringing down the Server Region that
the timed out request is currently running in with an ABEND EC3,
reason code 04130001.  This recovery action is done to ensure
that system resources are freed up from long running or
potentially looping applications.  However, the consequence of
bringing down the Server Region may be deemed more severe than
allowing a timed out request to continue. Such is the situation
that now needs addressed.
NOTE: This does not apply to requests coming from the
      Web Server (HTTP Server, IHS)
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 version 4.0.1 for z/OS and OS/390            *
****************************************************************
* PROBLEM DESCRIPTION: Need control of HTTP/HTTP SSL timeout   *
*                      recovery action that abends server      *
*                      regions with ABENDEC3 Reason=04130001.  *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Websphere V4.0.1 for Z/OS  ad OS/390 supports a time-out limit
for requests received over HTTP and HTTP SSL transports
specified by environment variables BBOC_HTTP_SSL_OUTPUT_TIMEOUT
and BBOC_HTTP_OUTPUT_TIMEOUT. The recovery action for a timed
out HTTP request may involve bringing down the Server Region
that the timed out request is currently running in with an ABEND
EC3, reason code 04130001.  This recovery action is done to
ensure that system resources are freed up from long running
or potentially looping applications.  However, the consequence
of bringing down the Server Region may be deemed more severe
than allowing a timed out request to continue.
Problem conclusion
New environment variables are being added to allow the
specification of a recovery action for timed out requests
received over the HTTP and HTTP SSL transports. These
environment variables are documented below.

APAR PQ74792 requires a change to the following WebSphere V4.0.1
for z/OS and OS/390 publications:

Installation and Customization, GA22-7834-04

and

Messages and Diagnosis GA22-7837-06

A change to these WebSphere V4.0.1 publications will be
available in the next refresh of the documentation. To access
the latest online documentation, go to the product library page
at:

www.ibm.com/software/webservers/appserv/zos_os390/library/

The change is to the table on page 396, which now reads:

|--------------------------------------------------------------|
|Env variable=<default>    | Dmn | SM  | Nam | IR  | App | zOS |
|--------------------------------------------------------------|
|...                       |     |     |     |     |     |     |
|--------------------------------------------------------------|
|BBOC_HTTP_OUTPUT_TIMEOUT_ |     | O   | O   | O   | O   |     |
| RECOVERY= SESSION|       |     |     |     |     |     |     |
| SERVANT                  |     |     |     |     |     |     |
|--------------------------------------------------------------|
|BBOC_HTTP_SSL_OUTPUT_     |     | O   | O   | O   | O   |     |
| TIMEOUT_RECOVERY=        |     |     |     |     |     |     |
|  SESSION|SERVANT         |     |     |     |     |     |     |
|--------------------------------------------------------------|
|...                       |     |     |     |     |     |     |
|--------------------------------------------------------------|

and text starting on page 406, which now reads:

BBOC_HTTP_OUTPUT_TIMEOUT_RECOVERY= SESSION|SERVANT
Controls the recovery action taken on timeouts for requests
received over the HTTP transport.
Specifying "SERVANT" allows for the termination of server
regions when timeouts occur. If an HTTP request is under
dispatch in a server region when its timeout value is reached,
the server region terminates with an ABENDEC3 RSN=04130001. The
HTTP request and socket are then cleaned up.
A setting of "SESSION" only cleans up the HTTP request and
socket. No attempt is made to disrupt the execution of a
dispatched HTTP request within a server region. Be careful using
this setting as it may lead to a loss of resources if the
dispatched HTTP request loops or hangs.
The default value is "SERVANT."
Example:
BBOC_HTTP_OUTPUT_TIMEOUT_RECOVERY=SERVANT

BBOC_HTTP_SSL_OUTPUT_TIMEOUT_RECOVERY= SESSION|SERVANT
Controls the recovery action taken on timeouts for requests
received over the HTTP SSL transport.
Specifying "SERVANT" allows for the termination of server
regions when timeouts occur. If an HTTP SSL request is under
dispatch in a server region when its timeout value is reached,
the server region terminates with an ABENDEC3 RSN=04130001. The
HTTP SSL request and socket are then cleaned up.
A setting of "SESSION" only cleans up the HTTP SSL request and
socket. No attempt is made to disrupt the execution of a
dispatched HTTP SSL request within a server region. Be careful
using this setting as it may lead to a loss of resources if the
dispatched HTTP SSL request loops or hangs.
The default value is "SERVANT."
Example:
BBOC_HTTP_SSL_OUTPUT_TIMEOUT_RECOVERY=SESSION

----------------------------------------------------------------

APAR PQ74792 requires the following change to WebSphere V4.0.1
for z/OS and OS/390:Messages and Diagnosis GA22-7837-06.

The change is to Chapter 16, where error codes C9C2112B and
C9C21275 were deleted, and minor code C9C21943 was added:

C9C21943
Explanation: The transaction manager could not find a reference
to a recently created transaction in the active GTID map. This
can happen when a server region initiated transaction completes
during asynchronous processing.
User Response: Check the message and error logs for information
relating to a transaction timeout as a timeout is the most
likely cause of this error.

and Chapter 17, where minor code EC3 04060028 was deleted.

APAR PQ74792 is associated with SERVICE LEVEL W401508 of
WebSphere Application Server version 4.0.1 for z/OS and OS/390.
Temporary fix Comments
APAR information
APAR number PQ74792
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2003-06-02
Closed date 2003-06-25
Last modified date 2003-07-03

APAR is sysrouted FROM one or more of the following:

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

Modules/Macros
BBOUBINF          

Fix information
Fixed component name WASKBASE
Fixed component ID 5655A9801

Applicable component levels
R401 PSY UQ77997    UP03/06/28 P F306

  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 #: PQ74792
IBM Group: Software Group
Modified date: Jul 3, 2003