8.6.8 Tuning parameters for setting the timeout

This section explains how to set up tuning parameters used for timeout settings.

Organization of this subsection
(1) Timeout set in the Web server for receiving requests from the client and sending the data to the client
(2) Timeout set in the redirector for sending the data to the Web container
(3) Timeout set in the redirector for receiving the data from the Web container
(4) Timeout set in the Web container for receiving the data from the redirector
(5) Timeout set in the Web container for receiving the data from the redirector
(6) Timeout set in the EJB client for remotely invoking the Enterprise Bean (RMI-IIOP communication) and for invoking the Naming Service by JNDI
(7) Timeout set up in the EJB client for invoking the Enterprise Bean from CTM
(8) Timeout set in the EJB container for the database transaction (when DB Connector is used)
(9) DB Connector timeout
(10) Database timeout
(11) Method timeout in J2EE application

(1) Timeout set in the Web server for receiving requests from the client and sending the data to the client

This is a tuning parameter for setting the timeout at point 1 of Figure 8-9 or Figure 8-10. The location of setup differs according to the Web server used.

In the case of Web server integration, set the tuning parameter for each Web server. You edit the files for specifying the settings.

Table 8-27 Tuning parameters for the timeout to be set in the Web server for receiving requests from the client and sending the data to the client (for Web server integration)

Setup itemLocation of setup
Timeout for receiving requests from the client and sending data to the clientTimeout directive of httpsd.conf

Note: When you are using Microsoft IIS as the Web server, edit the receive_client_timeout key in isapi_redirect.conf.


For an in-process HTTP server, specify the settings in each J2EE server.

You set up the items listed in the following table using the Smart Composer functionality. Define the parameters in the Easy Setup definition file.

Table 8-28 Tuning parameters for the timeout to be set in the Web server for receiving requests from the client and sending the data to the client (for an in-process HTTP server)

Setup itemSetup targetLocation of setup (parameter name)
Timeout for receiving requests from the clientLogical J2EE server (j2ee-server)webserver.connector.inprocess_http.receive_timeout
Timeout for sending data to the clientLogical J2EE server (j2ee-server)webserver.connector.inprocess_http.send_timeout

(2) Timeout set in the redirector for sending the data to the Web container

This is a tuning parameter for setting the timeout at point 2 and point 3 of Figure 8-9.The following table describes the tuning parameters for the timeout to be set in the redirector. You can specify the tuning parameter only in the case of Web server integration.

Specify the items listed in the following table with the Smart Composer functionality. You define the parameters in the Easy Setup definition file.

Table 8-29 Tuning parameters for the timeout to be set in the redirector

PointSetup itemSetup targetLocation of setup
(parameter name)#
2Connection timeout for Web container when sending requestsLogical Web server (web-server)JkConnectTimeout
3Timeout for sending requestsLogical Web server (web-server)JkSendTimeout
#
When you are using Microsoft IIS as the Web server, edit the connect_timeout key in isapi_redirect.conf.

(3) Timeout set in the redirector for receiving the data from the Web container

This is a tuning parameter for setting the timeout at point 4 of Figure 8-9.

You set up the tuning parameters for each worker definition of the redirector. The following table describes the tuning parameters for the timeout to be set up in the redirector.

You specify the items listed in the following table using the Smart Composer functionality and define the parameters in the Easy Setup definition file.

Table 8-30 Tuning parameters for the timeout to be set in the redirector

Setup itemSetup targetLocation of setup (parameter name)
Communication timeout of waiting for response dataLogical Web server (web-server)worker.worker-name.receive_timeout

You can specify this tuning parameter only in the case of Web server integration.

(4) Timeout set in the Web container for receiving the data from the redirector

This is a tuning parameter for setting the timeout at point 5 of Figure 8-9.

You set up the tuning parameter for each J2EE server. The following table describes tuning parameters for the timeout to be set in the Web container.

You specify the items listed in the following table using the Smart Composer functionality and define the parameters in the Easy Setup definition file.

Table 8-31 Tuning parameters for the timeout to be set in the Web container

Setup itemSetup targetLocation of setup (parameter name)
Timeout in waiting for reply from redirectorLogical J2EE server (j2ee-server)webserver.connector.ajp13.receive_timeout

You can specify this tuning parameter only in the case of Web server integration.

(5) Timeout set in the Web container for receiving the data from the redirector

This is a tuning parameter for setting the timeout at the point 13 of Figure 8-9.

You set up the tuning parameter for each J2EE server. The following table describes the tuning parameters for the timeout to be set up in the Web container.

You specify the items listed in the following table using the Smart Composer functionality and define the parameters in the Easy Setup definition file.

Table 8-32 Tuning parameters for the timeout to be set in the Web container

Setup itemSetup targetParameter name
Timeout of response sending processLogical J2EE server (j2ee-server)webserver.connector.ajp13.send_timeout

You can specify this tuning parameter only in the case of Web server integration.

(6) Timeout set in the EJB client for remotely invoking the Enterprise Bean (RMI-IIOP communication) and for invoking the Naming Service by JNDI

This is a tuning parameter for setting the timeout at point 7 of Figure 8-9 or Figure 8-10.

Set the tuning parameter for each J2EE server, EJB client application, or invocation by API.

The following table describes the tuning parameters (remote invocation by RMI-IIOP communication) for timeout to be set in the EJB client:

Table 8-33 Tuning parameters for the timeout to be set in the EJB client (remote invocation by RMI-IIOP communication)

UnitsMethod of setupSetup itemLocation of setup
Each J2EE serverSmart Composer functionalityCommunication timeout between client and server
Definition file
Easy Setup definition file
Setup target
Logical J2EE server (j2ee-server)
Parameter name
ejbserver.rmi.request.timeout
Each EJB client applicationSpecify the system property to be specified at the time of editing or starting a file
Definition file (in the case of edit file)
usrconf.properties
Parameter name
ejbserver.rmi.request.timeout key
Each APIAPI
When setting for each object
RequestTimeoutConfig#setRequestTimeout (java.rmi.Remote obj, int sec) method#
When setting for each thread
RequestTimeoutConfig#setRequestTimeout (int sec) method#
#
The name of the package is com.hitachi.software.ejb.ejbclient.

The following table describes the tuning parameters (invoking the Naming Service) for timeout to be set in the EJB client:

Table 8-34 Tuning parameters for the timeout to be set in the EJB client (invoking the Naming Service)

UnitsMethod of setupSetup itemLocation of setup
Each J2EE serverSmart Composer functionalityPeriod of communication timeout with Naming Service
Definition file
Easy Setup definition file
Setup target
Logical J2EE server (j2ee-server)
Parameter name
ejbserver.jndi.request.timeout
Each EJB client applicationSpecify the system property to be specified at the time of editing or starting a file
Definition file (in the case of edit file)
usrconf.properties
Parameter name
ejbserver.jndi.request.timeout key

(7) Timeout set up in the EJB client for invoking the Enterprise Bean from CTM

This is a tuning parameter for setting up timeout at point 8 of Figure 8-9 or Figure 8-10.

You set up the tuning parameter for each J2EE server, EJB client application, or each invocation by API.

A value same as that set up in (6) Timeout set in the EJB client for remotely invoking Enterprise Bean (RMI-IIOP communication) and for invoking Naming Service by JNDI is inherited as the setup value of this timeout.

(8) Timeout set in the EJB container for the database transaction (when DB Connector is used)

This is a tuning parameter for setting the timeout at point 10 of Figure 8-9 or Figure 8-10.

Set the tuning parameter for each J2EE server, Enterprise Bean, interface, method (in the case of CMT), or each invocation by API (in the case of BMT).

The following table describes the tuning parameters for transaction timeout:

Table 8-35 Tuning parameters for transaction timeout

UnitsMethod of setupSetup itemLocation of setup
Each J2EE serverSmart Composer functionalityDefault transaction timeout value of a transaction
Definition file
Easy Setup definition file
Setup target
Logical J2EE server (j2ee-server)
Parameter name
ejbserver.jta.TransactionManager.defaultTimeOut
Each Enterprise Bean, interface, method (in the case of CMT)The cjsetappprop command of the server management commandTransaction timeout time
Definition file
Session Bean property file, Entity Bean property file, or Message-driven Bean property file
Parameter name
<ejb-transaction-timeout>
Each API (in the case of BMT)APIUserTransaction#setTransactionTimeout method#
#
The name of the package is javax.transaction.

(9) DB Connector timeout

This is a tuning parameter for setting the timeout at point 11 of Figure 8-9 or Figure 8-10.

Set the tuning parameter for each DB Connector.

The following table describes the tuning parameters for DB Connector.

Table 8-36 Tuning parameters for DB Connector

UnitsMethod of setupSetup itemLocation of setup
Each DB ConnectorServer management commands cjsetrarprop or cjsetrespropTimeout in establishing a physical connection
Definition file
Connector property file
Setup target
DB Connector
Parameter name
loginTimeout
Timeout in the request for connection during connection depletion
Definition file
Connector property file
Setup target
DB Connector
Parameter name
RequestQueueTimeout
Each J2EE serverSmart Composer functionalityTimeout in detecting a connection error
Definition file
Easy Setup definition file
Setup target
Logical J2EE server (j2ee-server)
Parameter name
ejbserver.connectionpool.validation.timeout#
#
The same property as the timeout value of the connection adjustment functionality.

(10) Database timeout

This is a tuning parameter for setting the timeout at point 12 of Figure 8-9 or Figure 8-10.

The database timeout differs according to the type of database used and the operation mode of the server. This section explains how to set the timeout value when accessing the HiRDB, Oracle, SQL Server, or XDM/RD E2 by using the DB Connector.

Reference note
When Oracle is used, you can use the tuning parameters for setting the timeout only when global transaction is used. When local transaction is used, you cannot use the tuning parameters for setting timeout. You can, however, set the query timeout that is set by the method, in the case of both global and local transactions.
(a) Timeout settings in HiRDB

Set the timeout value in the common system definition of the HiRDB server or the environment variable of the HiRDB client. For details, see the manual HiRDB System Definition or the manual HiRDB UAP Development Guide.

The following table describes the tuning parameters used for setting the timeout in HiRDB:

Table 8-37 Tuning parameters for setting the timeout in HiRDB

Type of timeoutLocation of setupMethod of setup (parameter name)Settings
Unlock waiting timeoutCommon system definition of the HiRDB serverpd_lck_wait_timeout parameterThe settings are optional.
Response timeoutEnvironment variable of the HiRDB clientPDCWAITTIMESpecify a value greater than the value of transaction timeout.
Request interval timeoutEnvironment variable of the HiRDB clientPDSWAITTIMESpecify a value greater than the value of transaction timeout.
Reference note
If PDCWAITTIME and PDSWAITTIME are smaller than the transaction timeout value, even if the processing is within the time limit for the transaction, the database processing exceeds the time limit and a timeout occurs.
In this case, the database connection is lost regardless of the transaction being in process, and the transaction manager cannot conclude the transaction.
Also, in the case of a global transaction, the transaction must be recovered because the instruction about transaction conclusion does not reach after the connection is lost.
(b) Timeout settings in Oracle (when global transaction is used)

Set the timeout value in the DISTRIBUTED_LOCK_TIMEOUT parameter of the Oracle server definition.

In addition to the above, the setting of SesTm parameter of XAOpenString affects the timeout. This parameter cannot be tuned.

(c) Timeout settings in SQL Server

Set the timeout value by executing the parameter or statement in the environment settings option of the SQL Server.

The following table describes the tuning parameters for setting the timeout in the SQL Server.

Table 8-38 Tuning parameters for setting the timeout in the SQL Server

Type of timeoutLocation of setupMethod of setup (name of parameter or statementSettings
Timeout in acquiring memoryServer configuration optionquery wait parameterThe settings are optional.
Unlock waiting timeout--SET LOCK_TIMEOUT statementThe settings are optional.
Legend:
--: Not applicable.

(d) Timeout settings in XDM/RD E2

Set the timeout value in the system option definition of the XDM/BASE, the environment variable of the HiRDB client, and the control statement for invoking control space or the control statement for invoking server space of the DB connection server.

The following table describes the tuning parameters for setting the timeout in XDM/RD E2:

Table 8-39 Tuning parameters for setting the timeout in XDM/RD E2

Type of timeoutLocation of setupMethod of setup (parameter name)Settings
Unlock waiting timeoutSystem option definition of XDM/BASETIMERThe settings are optional.#1
CPU timeout during SQL executionThe control statement for invoking control space or control statement for invoking server space of the DB connection serverSQLCTIMESpecify a value greater than the value of transaction timeout.#2
SQL execution timeoutThe control statement for invoking control space or control statement for invoking server space of the DB connection serverSQLETIMESpecify a value greater than the value of transaction timeout.#2
Transaction timeoutThe control statement for invoking control space or control statement for invoking server space of the DB connection serverSVETIMESpecify a value greater than the value of transaction timeout.#2
Response timeoutHiRDB client environment variablePDCWAITTIMESpecify a value greater than the value of transaction timeout.#3
#1
For details, see the manual VOS3 Data Management System XDM E2 Node System Definition (XDM/BASE, SD, or TM2).
#2
For details, see the manual VOS3 Database Connection Server.
#3
For details, see the manual HiRDB XDM/RD E2 Connection Functionality.

(11) Method timeout in J2EE application

This is a tuning parameter for setting the timeout at point 6 and point 9 of Figure 8-9 or Figure 8-10.

Set the timeout value as an application attribute when you want to set the timeout for each method in the Web application or the Enterprise Bean. Set the operations in the case of timeout as an application attribute as well. You specify these items using the server management command (cjsetappprop).

The following table describes the tuning parameters for setting the timeout in the method execution time. The location of setup differs for each point.

Table 8-40 Tuning parameters for setting the timeout for the method execution time

Points to setType of timeout and operations in the case of timeoutLocation of setup
6Request processing method for the filter, servlet or JSP
Definition file
Servlet property file
Parameter name
<method-observation-timeout>
9Request processing method for the Enterprise Bean
Definition file
Session Bean property file, Entity Bean property file, or Message-driven Bean property file
Parameter name
<ejb-method-observation-timeout>
6 and 9Operations for each application when timeout occurs
Definition file
Application property file
Parameter name
<method-observation-recovery-mode>