Daylight v4.9
Release Date: 1 February 2008

Name

dt_set_server_timeout - specify the connection time out

Generic Prototype

dt_set_server_timeout(dt_Integer) => dt_Integer

C Prototype

#include "dt_thor.h" or #include "dt_merlin.h"

dt_Integer dt_set_server_timeout(dt_Integer new)

FORTRAN Prototype

include 'dt_f_thor.inc' or include 'dt_f_merlin.inc'

integer*4 dt_f_set_server_timeout(new)

integer*4 new

Description

Sets a toolkit-wide timeout (in seconds) for any attempted connections to servers from the current toolkit application.

In some circumstances, it is impossible for the toolkit to determine that a connection will never succeed. In these circumstances, a client will hang indefinitely, until the time limit set by this function has been exceeded.

The most common situation which arises is that the server machine is down.

Setting 'new' to zero seconds causes the toolkit to never time out; it will wait forever for a connection. The default value for the timeout within the toolkit is zero.

Return Value

Returns the previously defined timeout value or (-1) if the parameter 'new' is a negative number, in which case the timeout is not changed.

Related Topics

dt_mer_server(3) dt_thor_server(3)