D_TIMEOUT

SUMMARY
   d_timeout(secs)
   int secs;

ARGUMENTS

   secs      The number of seconds to wait before timing out.

DESCRIPTION

   This function will set the amount of time the lock manager will allow an
   unsatisfied lock request to wait on the lock request queue for the user
   making the d_timeout call. The number of seconds to wait is specified by
   secs. A negative value will indicate that no lock request are to timeout
   (i.e. tley'll wait forevel). Since timeouts are the only means of detecting
   potential deadlock situations, be very cautious about turning off timeouts.
   The default timeout value is 10 seconds and is reset whenever the database
   is opened. Thus, d_timeout must be called after d_open. status S_UNAVAIL is
   returned by the lock request functions d_lock, d_relock and d_setlock when
   a timeout is occurs.

   This function is present in single-user version of db_VISTA, but performs no
   action. This allows multi_user applications to link with the single_user
   version for operation on stand-alone computers.

CURRENCY CHANGES
   None

RETURN CODES
   -1   S_DBOPEN      Database is not open. Function called before d_open.

EXAMPLE

   d_open("tims","s");
   d_timeout(30); /* set a  second timeout value*/