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

 A fix is 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)
To set the variable protocol_http_timeout_output_recovery
(application server and deployment manager only)
In the administrative console, click
Servers > Application Servers > server > Custom Properties >
New.
Add the protocol_http_timeout_output_recovery property and
specify a different value. See Configuring server properties
for additional information.
In the WebSphere Infocenter for z/OS
see:  Changing the values of variables referenced in BBOM0001I
messages.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V5.0 for z/OS                                *
****************************************************************
* PROBLEM DESCRIPTION: Need control of HTTP/HTTP SSL timeout   *
*                      recovery action that abends Server      *
*                      Regions with ABENDEC3 Reason=04130007.  *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Websphere for z/OS supports a time-out limit for requests
received over HTTP and HTTP SSL transports specified by
environment variables protocol_http_timeout_output and
protocol_https_timeout_output. 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 04130007. 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 PQ75054 requires a change to the following WebSphere V5.0
for z/OS publications:

Changes to the WebSphere Application Server Version 5
InfoCenter 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 changes will read as follows:

protocol_http_timeout_output_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=04130007. 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:
protocol_http_timeout_output_recovery=SERVANT

protocol_https_timeout_output_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=04130007. 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:
protocol_https_timeout_output_recovery=SESSION

Minor codes C9C2112B and C9C21288 deleted and ABENDEC3 reason
code 04060028 deleted.

"Suggested action" sections of C9C21285, C9C21286, and C9C21287
all updated to change all occurrences of "BBOC_HTTP_OUTPUT_
TIMEOUT" to "protocol_http_timeout_output" and "BBOC_HTTP_SSL_
OUTPUT_TIMEOUT" to "protocol_https_timeout_output."
Message BBOO0232W updated as follows:

BBOO0232W
A request for Class Name 'string' and Method Name 'string', from
string, has timed out. The servant process associated with the
request will be terminated. Request Id(%08X)
Explanation: A request has timed out that was associated with a
servant process. The associated servant process will be
terminated. The "from" string identifies the client of the
request. For clients using TCP/IP the host name and port number
will appear in the message. For a local client, this field
contains the jobname and ASID of the client address space. The
"Request Id" is a unique identifier of this request.
User response: Examine the application for possible coding
errors which may have lead to delays.

APAR PQ75054 is associated with SERVICE LEVEL W500102 of
WebSphere Application Server V5.0 for z/OS.
Temporary fix Comments
APAR information
APAR number PQ75054
Reported component name WEBSPHERE FOR Z
Reported component ID 5655I3500
Reported release 500
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Special Attention NoSpecatt
Submitted date 2003-06-09
Closed date 2003-07-03
Last modified date 2004-10-15

APAR is sysrouted FROM one or more of the following:
PQ74792

APAR is sysrouted TO one or more of the following:

Modules/Macros
BBOUBINF          

Publications Referenced

Fix information
Fixed component name WEBSPHERE FOR Z
Fixed component ID 5655I3500

Applicable component levels
R500 PSY UQ78241    UP03/07/11 P F307

  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


Current web document: swg1PQ75054.html
Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 500
Software edition:
Reference #: PQ75054
IBM Group: Software Group
Modified date: Oct 15, 2004