Show TOC

Function documentationTimeout Parameters Locate this document in the navigation structure

 

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.

Value 0 means that non-blocking connections are opened.

Default Value

0 (asynchronous connect)

Unit

Milliseconds

Dynamic

Yes

gw/internal_timeout

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

Caution Caution

This parameter should only be changed in consultation with SAP.

End of the caution.

Default Value

0

Unit

Milliseconds

Dynamic

Yes

gw/frag_timeout

Determines the timeout for incomplete network write operations.

If the gateway cannot write all the data to the network, the connection is closed once this time is exceeded.

Value 0 deactivates the check.

Caution Caution

This parameter should only be changed in consultation with SAP.

End of the caution.

Default Value

120

Unit

Seconds

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.

Caution Caution

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.

End of the caution.

Default Value

60

Unit

Seconds

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, these connections are not closed.

Caution Caution

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.

End of the caution.

Default Value

1800

Unit

Seconds

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.

Caution Caution

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.

End of the caution.

Default Value

600

Unit

Seconds

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 include:

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

  • Close inactive 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

Unit

Seconds

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

Unit

Seconds

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

Unit

Seconds

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

Unit

Seconds

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

Unit

Seconds

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.

Value 0 deactivates the time measurement.

Default Value

0

Unit

Milliseconds

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

Unit

Seconds

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

Unit

Seconds

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

Unit

Seconds

Dynamic

Yes

gw/accept_timeout

Maximum allowed time period for the login process of a server program. If this time is exceeded, the connection is closed. The waiting client is informed of the error.

A parameter value of 0 deactivates the check

Default Value

60

Unit

Seconds

Dynamic

Yes