This topic applies only on the z/OS operating system.

Timeout properties summary

You can use timeout properties to control the amount of time you allow for various requests to complete. Some of these properties map to internal variable names. The internal variable names are provided here to aid you with debugging.

Object Request Broker (ORB) service advanced settings

ORB listener keep alive
In a non-secure socket layer (SSL) environment, this property defines the value, in seconds, that is provided to TCP/IP on the SOCK_TCP_KEEPALIVE option for the IIOP listener. The function of this option is to verify if idle sessions are still valid by polling the client TCP/IP stack. If the client does not respond, then the session is closed. If the connection to the client is lost without the server receiving notification, then the session remains active on the server side. Use this option to clean up these unnecessary sessions.
  • If the environment variable is not set, then the TCP/IP option is not set.
  • Setting the SOCK_TCP_KEEPALIVE option generates network traffic on idle sessions, which can be undesirable.

Default: 0

How to specify: To specify this property, in the administrative console, click Application servers > server_name > Container services > ORB service > z/OS additional settings..

Internal variable name (for debugging purposes): Locate the internal variable name protocol_iiop_server_session_keepalive in the was.env file or the JES job log.

ORB SSL listener keep alive
In an SSL environment, this property defines the value, in seconds, that is provided to TCP/IP on the SOCK_TCP_KEEPALIVE option for the IIOP listener. The function of this option is to verify if idle sessions are still valid by polling the client TCP/IP stack. If the client does not respond, then the session is closed. If the connection to the client is lost without the server receiving notification, then the session remains active on the server side. Use this option to clean up these unnecessary sessions.
  • If the environment variable is not set, then the TCP/IP option is not set.
  • Setting the SOCK_TCP_KEEPALIVE option generates network traffic on idle sessions, which can be undesirable.

Default: 0

How to specify: To specify this property, in the administrative console, click Application servers > server_name > Container services > ORB service > z/OS additional settings..

Internal variable name (for debugging purposes): Locate protocol_iiop_server_session_keepalive_ssl in the was.env file or the JES job log.

WLM timeout
Specifies the maximum amount of time, in seconds, that workload management (WLM) waits for IIOP requests to complete. This time limit includes:
  • The time during which the IIOP request waits on the WLM queue until being dispatched to a servant
  • The time during which an application component, running in the servant, processes the request and generates a response
The server generates a failure response if this processing does not complete within the specified time.
Avoid trouble: This setting does not apply for HTTP requests or scalable messaging support; for that type of work, the value specified for the ConnectionResponseTimeout server custom property controls the time allowed for dispatching work to a servant. gotcha

Default: 300 seconds

How to specify: To specify this property, in the administrative console, click Application servers > server_name > Container services > ORB service > z/OS additional settings.

Internal variable name (for debugging purposes): Locate the internal variable name, control_region_wlm_dispatch_timeout, in the was.env file or the JES job log.

Example: WLM timeout=600

Request timeout
Specifies the maximum time, in tenths of seconds, that the client waits for the response to a client request. The value specified for this field is a server wide setting that affects all outbound RMI/IIOP enterprise bean invocations that are made on this server.

Because the sysplex TCP/IP that runs through the coupling facility does not always tell the client when the other end of the socket has closed, clients can wait indefinitely for a response unless you set this property. Setting the Request timeout property ensures that the client gets a response within the specified time, even if the response is a COMM_FAILURE exception.

Default: 0 (unlimited). No timeout value is set.

How to specify: To specify this custom property, in the administrative console, click Application servers > server_name > > Container services > ORB service > z/OS additional settings.

Internal variable name (for debugging purposes): Locate the internal variable name protocol_iiop_local_timeout in the was.env file or the JES job log.

Example: Specifying Request timeout=20, sets the time limit to 2 seconds.

Transaction service timeout properties

Total Transaction Lifetime Timeout
Specifies the maximum amount of time, in seconds, that the J2EE server waits for an application transaction that originated in this server to complete if the application transaction does not set its own timeout value through the UserTransaction.setTransactionTimeout() method.
If the application transaction is not committed or rolled back within the specified time, the application transaction is marked for rollback and is allowed to continue running for a grace period of approximately four minutes. If the application transaction is committed or rolled back during the grace period, then the outcome of the transaction is always rolled back. If the application transaction does not complete after the grace period, then the controller abnormally ends the servant in which the application component is running with ABEND EC3 RSN=04130002 or 04130005.
Avoid trouble: Only the total transaction lifetime timeout and the maximum transaction timeout have grace periods. gotcha

Setting this value to zero indicates that the timeout does not apply, and the value of the maximum transaction timeout is used instead.

Default: 120 seconds

How to specify: To specify this property, in the administrative console, click Application servers > server_name > Container services > Transaction service.

Internal variable name (for debugging purposes): Locate the internal variable name transaction_defaultTimeout in the was.env file or the JES job log file.

Maximum transaction timeout
Specifies the maximum amount of time, in seconds, that the J2EE server waits for an application transaction that is propagated into this server to complete. This value also applies to transactions that are started in this server, if their associated applications do not set a transaction timeout, and the total transaction lifetime timeout is set to 0.

This value constrains the upper bound of all other timers. If an application uses the UserTransaction.setTransactionTimeout() method to specify a longer length of time, then the J2EE server changes the application setting to the value specified for the Maximum transaction timeout property.

Setting this value to zero indicates that the timeout does not apply, and any transactions that are affected by this timeout never time out.

Default: 300 seconds

How to specify: To specify this property, in the administrative console, click Application servers > server_name > Container services > Transaction service.

Internal variable name (for debugging purposes): Locate the internal variable name, transaction_maximumTimeout, in the was.env file or the JES job log.

transaction_recoveryTimeout
Specifies the time, in minutes, that this controller uses to attempt to resolve in-doubt transactions before issuing a write-to-operator-with-reply (WTOR) message to the console that asks whether the controller should perform the following actions:
  • Stop trying to resolve in-doubt transactions.
  • Write transaction-related information to the job log or hard copy log and terminate.

If the operator replies that recovery is to continue, then the controller attempts recovery for the specified amount of time before re-issuing the WTOR message. After all of the transactions are resolved, the controller region terminates. This property applies only to controllers in peer restart and recovery mode.

Default: 15 minutes

How to specify: To specify this property, in the administrative console, click Environment > WebSphere variables, select the appropriate node or cell from the list of available nodes and cells, and then click New. Add the transaction_recoveryTimeout property in the Name field, and specify a different value in the Value field.

Internal variable name (for debugging purposes): Locate transaction_recoveryTimeout in the was.env file or the JES job log.

Example: transaction_recoveryTimeout=7

Server custom properties

control_region_mdb_request_timeout
Specifies the time, in seconds, that the server waits for a message driven bean (MDB) request to receive a response. If the response is not received within the specified amount of time, then the servant might abnormally terminate with an EC3 ABEND, RSN=04130008. You can set this value to zero if you need to disable this function.

Default: 120

How to specify: For an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties > New; for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Java and Process Management > Process Definition > Control > Java Virtual Machine > Custom Properties > New. Then add the control_region_mdb_request_timeout property in the Name field, and specify an appropriate value in the Value field.

Internal variable name (for debugging purposes): Locate control_region_mdb_request_timeout in the was.env file or the JES job log.

Example: control_region_mdb_request_timeout=180

protocol_http_timeout_output_recovery
Controls the recovery action taken on timeouts for requests received over the HTTP transport. Specifying SERVANT allows for the termination of servants when timeouts occur. If an HTTP request is under dispatch in a servant when its timeout value is reached, then the servant terminates with an ABEND EC3 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 processing of a dispatched HTTP request within a servant. Using the session setting might result in a loss of resources if the dispatched HTTP request loops or becomes inactive.

Default: SERVANT

How to specify: For an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties > New; for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Java and Process Management > Process Definition > Control > Java Virtual Machine > Custom Properties > New. Then add the protocol_http_timeout_output_recovery property in the Name field, and specify an appropriate value in the Value field.

Internal variable name (for debugging purposes): Locate protocol_http_timeout_output_recovery in the was.env file or the JES job log.

Example: protocol_http_timeout_output_recovery=SERVANT

protocol_https_timeout_output_recovery
Controls the recovery action taken on timeouts for requests received over the HTTPS transport. Specifying SERVANT allows for the termination of servants when timeouts occur. If an HTTP request is under dispatch in a servant when its timeout value is reached, then the servant terminates with an ABEND EC3 RSN=04130007. The HTTPS request and socket are then cleaned up. A setting of SESSION only cleans up the HTTPS request and socket. No attempt is made to disrupt the processing of a dispatched HTTPS request within a servant. Using the session setting might result in a loss of resources if the dispatched HTTPS request loops or becomes inactive.

Default: SERVANT

How to specify: For an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties > New; for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Java and Process Management > Process Definition > Control > Java Virtual Machine > Custom Properties > New. Then add the protocol_http_timeout_output_recovery property in the Name field, and specify an appropriate value in the Value field.

Internal variable name (for debugging purposes): Locate protocol_https_timeout_output_recovery in the was.env file or the JES job log.

Example: protocol_https_timeout_output_recovery=SESSION

protocol_iiop_send_timeout
Specifies the maximum amount of time, in seconds that the controller waits for an IIOP TCP/IP send() to complete. The value specified for this custom property applies to all IIOP send requests over TCP/IP, including IIOP send requests that are using the SSL protocol.

Default: 30

How to specify: For an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties > New; for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Java and Process Management > Process Definition > Control > Java Virtual Machine > Custom Properties > New. Then add the protocol_iiop_send_timeout property in the Name field, and specify an appropriate value in the Value field.

Internal variable name (for debugging purposes): Locate protocol_iiop_send_timeout in the was.env file or the JES job log.

Secure sockets layer configuration repertoires

Deprecated feature: System SSL for z/OS has been deprecated in WebSphere Application Server Version 6.0.x. You should start to convert any security scripts, that are based on System SSL, to use JSSE security.depfeat
V3 Timeout
Specifies the length of time, in seconds, that a browser can reuse a System SSL Version 3 session ID without renegotiating encryption keys with the server. The repertoires that you define for a server require the same V3 timeout value.

Default: 100

How to specify: To specify this property, in the administrative console, click Security > SSL Application servers > New SSL repertoire

Internal variable name (for debugging purposes): The following SSL configuration repertoire timeout variables are set internally when you define your SSL repertoires:
  • com_ibm_CSI_perform_ssl_sys_v3_timeout
  • com_ibm_CSI_claim_ssl_sys_v3_timeout
  • com_ibm_HTTP_claim_ssl_sys_v3_timeout
  • com_ibm_DAEMON_claim_ssl_sys_v3_timeout
Locate these internal variables in the was.env file or the JES job log.

TCP transport channel timeout properties

Inactivity timeout property
Specifies the amount of time, in seconds, that the TCP transport channel waits for a read or write request to complete on a socket.
Avoid trouble: The value specified for this property might be overridden by the wait times established for channels that are higher than this channel in the timer hierarchy. For example, the wait time established for an HTTP transport channel overrides the value specified for this property for every operation except the initial read on a new socket.gotcha

Default: 0 seconds

How to specify: To specify this property, in the administrative console, click Servers > Application servers > server_name > Web container Transport chains > TCP inbound channel.

HTTP transport channel timeout properties

ConnectionResponseTimeout
Specifies a maximum amount of time, in seconds, that the server waits for an application component to respond to an HTTP request.

Set this property for each of the HTTP transport channel definitions on the server. You must set this property for both SSL transport channels and non-SSL transport channels. If the response is not received within the specified length of time, then the servant might fail with ABEND EC3 and RSN=04130007. Setting this timer prevents client applications from waiting for a response from an application component that might be in a deadlock, looping, or encountering some other processing problem that causes the application component to stop processing requests.

Default: 300 seconds

How to specify: To specify this property, in the administrative console, click In the administrative console, click Servers > Application servers > server_name, and then, under Web Container Settings, click Custom properties.

Internal variable name (for debugging purposes): If you are debugging a problem in SSL-enabled transport, then locate the internal variable name, protocol_https_timeout_output, in the was.env file or the JES job log. If you are debugging a problem in a non-SSL transport channel, then locate the internal variable name, protocol_http_timeout_output, in the was.env file or the JES job log.

Persistent timeout property
Specifies the amount of time, in seconds, that the HTTP transport channel allows a socket to remain idle between requests.

Default: 30 seconds

How to specify: To specify this property, in the administrative console, click Servers > Application servers > server_name > Web container Transport chains > HTTP inbound channel.

Read timeout property
Specifies the amount of time, in seconds, that the HTTP transport channel waits for a read request to complete on a socket after the first read request occurs. The read that is completing might be an HTTP body, such as a POST, or part of the headers if the headers were not all read as part of the first read request on the socket.

Default: 60 seconds

How to specify: To specify this property, in the administrative console, click Servers > Application servers > server_name > Web container Transport chains > HTTP inbound channel.

Write timeout property
Specifies the amount of time, in seconds, that the HTTP transport channel waits on a socket for each portion of response data to be transmitted. This timeout typically occurs in situations where responses lag behind new requests. This situation can occur when a client has a low data rate or the network interface card (NIC) for the server is saturated with I/O.

Default: 60 seconds

How to specify: To specify this property, in the administrative console, click Servers > Application servers > server_name > Web container Transport chains > HTTP inbound channel.

HTTP transport timeout properties

ConnectionIOTimeOut
Specifies a maximum amount of time, in seconds, that the J2EE server waits for the complete HTTP request to arrive. Set this property for each of the HTTP transport definitions on the server. You must set this property for both SSL transport and non-SSL transport. The J2EE server starts the timer after the connection has been established, and cancels the connection if a complete request does not arrive within the specified maximum time limit. Specifying a value of zero disables the time out function.

Default: 10 seconds

How to specify: To specify this property, in the administrative console, click Application servers > server_name > Web container > Custom properties.
Note: This panel is only available if an HTTP transport is defined for your application server environment. If an HTTP transport is not defined for your environment, then you can use the wsadmin scripting tool to define one. However, it is recommended that you use an HTTP transport channel instead of an HTTP transport whenever possible.
Avoid trouble: This panel is only available if an HTTP transport is defined for your application server environment. If an HTTP transport is not defined for your environment, then you can use the wsadmin scripting tool to define one. However, it is recommended that you use an HTTP transport channel instead of an HTTP transport whenever possible.gotcha
ConnectionResponseTimeout
Specifies a maximum amount of time, in seconds, that the J2EE server waits for an application component to respond to an HTTP request. Set this property for each of the HTTP transport definitions on the server. You must set this property for both SSL transport and non-SSL transport. If the response is not received within the specified length of time, then the servant might fail with ABEND EC3 and RSN=04130007. Setting this timer prevents client applications from waiting for a response from an application component that might be in a deadlock, looping, or encountering some other processing problem that causes the application component to stop processing requests.

Default: 120 seconds

How to specify: To specify this property, in the administrative console, click Application servers > server_name > Web container > Custom properties.

Internal variable name (for debugging purposes): If you are debugging a problem in SSL-enabled transport, then locate the internal variable name, protocol_https_timeout_output, in the was.env file or the JES job log. If you are debugging a problem in non-SSL transport, then locate the internal variable name, protocol_http_timeout_output, in the was.env file or the JES job log.

ConnectionKeepAliveTimeout
Specifies the time, in seconds, that the J2EE server waits for a subsequent request from an HTTP client on a persistent connection. If another request is not received from the same client within this time limit, then the connection is closed.

Default: 30 seconds

How to specify: To specify this property, in the administrative console, click Application servers > server_name > Web container > Custom properties.

Internal variable name (for debugging purposes): If you are debugging a problem in SSL-enabled transport, then locate the internal variable name protocol_https_timeout_persistentSession in the was.env file or the JES job log. If you are debugging a problem in non-SSL transport, then locate the internal variable name protocol_http_timeout_persistentSession in the was.env file or the JES job log.




Reference topic    

Terms of Use | Feedback

Last updated: Aug 29, 2010 8:25:23 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-zos&topic=rtrb_controllingtimeout
File name: rtrb_controllingtimeout.html