Timeout Parameters 

Use

The parameters listed below control all the gateway timeouts.

Features

gw/timeout

Specifies the timeout value for the establishing connections to other gateways in milliseconds (NiConnect calls).  If a connection to the other gateway is not made within this time interval, an error is reported to the calling program.

The value 0 means that non-blocking connections are opened.

Default value	0 (asynchronous connect)
Dynamic	Yes

gw/internal_timeout

Specifies the timeout values for NiRead and NiWrite calls in milliseconds. If not all data has been sent or received within this time interval, the action concerned is interrupted and continued later. Thus slow connections cannot block the gateway. The value 0 deactivates the timeout.

This parameter should only be changed in consultation with SAP.

Default value	0
Dynamic	Yes

gw/conn_pending

Specifies the maximum number of seconds for which a connection can remain in the status CONN_PENDING. If this time interval is exceeded, the connection is closed by the gateway. This status is set when a connection is opened to another gateway, external program or SAProuter, when the handshake is not yet completed, or when an external program connects to the gateway using TCP/IP connect and then sends no further data to the gateway (for example, telnet <host> 3300 or ftp).

The value 0 deactivates this check.

This check can be performed a maximum of every gw/max_sleep seconds. It makes no sense therefore to specify a value smaller than gw/max_sleep.

Default value	60
Dynamic	Yes

gw/gw_disconnect

Specifies the maximum number of seconds for which a GW-GW connection can remain inactive. If this time interval is exceeded, the connection to the other gateway is closed. This is only the case if there is no active CPIC/RFC connection to this gateway.
If you set this parameter to 0, such connections are not closed.

This check can be performed a maximum of every gw/max_sleep seconds. It makes no sense therefore to specify a value smaller than gw/max_sleep.

Default value	1800
Dynamic	Yes

gw/deallocate_timeout

Time period in which the network connection for a DEALLOCATE must be closed. If the connection is not closed within this time period, the gateway closes the connection itself.

This check is only made on external connections (they appear as NORMAL_CLIENT in the gateway monitor).

The value 0 deactivates this check.

This check can be performed a maximum of every gw/max_sleep seconds. It makes no sense therefore to specify a value smaller than gw/max_sleep.

Default value	600
Dynamic	Yes

gw/max_sleep

Specifies the maximum time in seconds for which the gateway read process sleeps on the select.

Periodic checks within the gateway can be made a maximum of every gw/max_sleep seconds. These checks are:

·        Delete connections with status DISCONNECT (parameter gw/conn_disconnect)

·        Close inactive gateway-to-gateway connections (parameter gw/gw_disconnect)

·        Close inactive SAProuter connections (parameter gw/close_routes)

·        Close connections with status CONN_PENDING (parameter gw/conn_ pending)

·        Check connections to external programs (parameter gw/deallocate_timeout)

·        Check started programs (Parameter gw/startup)

·        Check waiting registered server programs (parameter gw/reg_keepalive)

·        Check inactive RFC/CPIC programs (parameter gw/keepalive)

Default value	20
Dynamic	Yes

gw/keepalive

Specifies the maximum time period (in seconds) before the system checks, using a ping, whether the partner is still alive when there is no data transfer across a CPIC connection.  

Default value	300
Dynamic	Yes

gw/reg_keepalive

Specifies the maximum time period in seconds before the system checks, using a ping, whether the partners are still alive in a registered server program with the status WAITING.

Default value	300
Dynamic	Yes

gw/conn_disconnect

Specifies the maximum number of seconds for which an active connection can remain in the status DISCONNECT or DISCONNECTED. If this time interval is exceeded, the connection is closed by the gateway.
If you set this parameter to 0, such connections are not closed.

Default value	900
Dynamic	Yes

gw/cpic_timeout

Specifies the maximum wait time for a connection setup. The wait time must not exceed the interval defined by the parameter (in seconds). Otherwise the connection setup is terminated with a timeout. This parameter is passed on to the CPIC interface via putenv and defines the shell variable CPIC_TIMEOUT.

Default value	20
Dynamic	Yes

gw/resolve_timeout

This parameter is used to activate a time measurement for the network lookup calls (host name – IP address, service name – port number). If the time in milliseconds exceeds the value of this parameter, the call with parameters is logged in the trace file.

The time period is specified in milliseconds in the parameter.

The value 0 deactivates the time measurement.

Default value	0
Dynamic	Yes

gw/reg_timeout

Specifies the maximum wait time for setting up the connection with a registered program. The wait time must not exceed the interval defined by the parameter (in seconds). Otherwise the connection setup is terminated with a timeout.

Default value	60
Dynamic	Yes

gw/close_routes

Specifies the period (in seconds) after which a route to a remote gateway through which a CPIC connection is open is closed.

Default value	120
Dynamic	Yes

gw/nibuf_retry

Time period after which the invalid entries are deleted in the host name buffer. An invalid entry can arise, if for example, an IP address cannot be converted into a host name.

If the parameter value is not set, the default value of the network layer is used (600).

The value 0 means that the invalid entries are never deleted.

Default value	Used by NI interface
Dynamic	Yes