$NET_TIMEOUT

Specify the maximum length of time that one or more specified network activities can continue. Activities that can be timed out include establishing a connection to the Uniface Router, or an idle process. 

$NET_TIMEOUT {=}{Option=Duration {TimeUnit, Option=Duration {TimeUnit}}N
$NET_TIMEOUT={cct=ClientConnectionTimeout},%\ 
               {sct=ServerConnectionTimeout},%\
               {idl=IdleTimeout},%\
               {pmi=PostmessageTimeout},%\
               {uec=UnifaceExistCheckTimeout | off},%\
               {vfy=VerifyConnectionTimeout | off} 
[SETTINGS]
$NET_TIMEOUT = cct=120, sct=2m

Arguments

  • Option—setting that determines the activity for which a timeout is set. See $NET_TIMEOUT options.
  • Duration—maximum length of time that the network activity continues, expressed in seconds (the default unit), or TimeUnit.

    Note:  The actual times can vary by a number of seconds from those specified, because the timeout is checked with a 15 second interval.

  • TimeUnit—optional; one of the following:
    • s—seconds (the default, if TimeUnit is omitted)
    • m—minutes
    • h—hours
    • d—days
    • w—weeks

    Note:  You cannot combine time units, such as $NET_TIMEOUT idl=4w2d.

Defaults

Assignment file: Depending on the option, can be set in the assignment files of Uniface Router, Uniface Server, and client applications
Section: [SETTINGS]
Default value: None

Description

Use the $NET_TIMEOUT assignment setting to control how long the Uniface Router waits before a client or Uniface Server connects to the Uniface Router, how long the Uniface Router or Uniface Server is idle, and so on.

If an option is set in an inappropriate assignment file, it is ignored.

$NET_TIMEOUT options
Option Use In Description
cct urouter.asn

Client ASN file

 Client connection timeout. Specifies the time for a client to establish a connection with the Uniface Router, or to reconnect if the connection is lost. The default is 180 seconds. The setting does not include the time for a server to start and respond.

The cct value should be appropriate for your network speed. It should be long enough to establish a connection but short enough to prevent a long wait if the connection cannot be made—between 10 and 30 seconds is normally enough.
sct urouter.asn Server connection timeout. Specifies the maximum time that the Uniface Router will wait for a Uniface Server to register with the Uniface Router after the server starts. The default is 60 seconds.

Use only in a Uniface Router assignment file. It has no effect in a client or server assignment file.

idl urouter.asn

userver.asn

Client ASN file

 Idle timeout. Specifies the maximum time that the network read waits without activity before it closes the connection. If not specified, the default is -1 (unlimited time period). If specified, IdleTimeout must be a whole number.

If present in the Uniface Router’s assignment file, the Uniface Router closes the socket and ends the thread to the client and the server after being idle for the specified time. After the socket is closed, the server stops processing.

For a server, this setting takes effect regardless of any state the server has. This behavior differs from the /maxidle setting for the UST in the [SERVERS] sections of the Uniface Router assignment file. For more information, see /maxidle.

In a listening exclusive server, this setting determines how long the server will wait for the same client to reconnect after a connection is broken before the application exits.

In a situation where connections can be lost (such as going out of range of a WiFi connection), and clients should be able to reconnect to the same server, idl would typically be set to a longer period.
pmi urouter.asn Postmessage timeout. Specifies the maximum length of time a special queue that has been created to handle postmessages can be inactive before it is released.

Applicable only when $USE_PMQ is used to create a queue in memory for each postmessage target application. For more information, see $USE_PMQ.
uec urouter.asn Uniface existence check timeout. Specifies the maximum length of time that no communication is received from a client before the Uniface Router checks whether the client is still active. For more information, see Broken or Closed Connections.Use only if error -23 (Duplicate UST) is returned in a repeating loop.
vfy urouter.asn Verify connection timeout. Specifies the maximum length of time that a client connection thread blocks receive requests before it checks whether a connection is still required. For more information, see Broken or Closed Connections.

Use only if error -23 (Duplicate UST) is returned in a repeating loop.

Related Topics