PQ74792: ABEND EC3 RSN=04130001 WHEN A REQUEST TIMESOUT FROM AN HTTP AND/OR HTTP SSL TRANSPORT | |||||||||||||||||||||||||||||||||||||||||
![]() |
|||||||||||||||||||||||||||||||||||||||||
![]() 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 is sysrouted FROM one or more of the following: APAR is sysrouted TO one or more of the following: PQ75054 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 #: PQ74792
IBM Group: Software Group
Modified date: Jul 3, 2003
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.