home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbsettime.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.1 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                dbsettime
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbsettime
  6.  
  7.   FUNCTION:
  8.        Set the number  of  seconds  that  DB-Library  will  wait  for  a
  9.        SQL Server response to a SQL command.
  10.  
  11.   SYNTAX:
  12.        RETCODE dbsettime(seconds)
  13.  
  14.        int       seconds;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbsettime               Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This routine sets the length of time in seconds that DB-Library
  28.          will   wait   for   a   SQL Server  response  during  calls  to
  29.          dbsqlexec(),  dbsqlok(),  dbresults(),  and  dbnextrow().   The
  30.          default  timeout  value  is  0,  which  represents  an infinite
  31.          timeout period.
  32.        o dbsettime() can be called at any time during  the  application-
  33.          before  or  after  a call to dbopen().  It takes effect immedi-
  34.          ately upon being called.
  35.  
  36.        o To set a timeout value for calls to dbopen(),  use  dbsetlogin-
  37.          time().
  38.        o Note that, after sending a  query  to  SQL Server,  dbsqlexec()
  39.          waits  until a response is received or until the timeout period
  40.          has elapsed.  To minimize the time spent in DB-Library  waiting
  41.          for a response from SQL Server, an application can instead call
  42.          dbsqlsend() followed by dbsqlok().
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                dbsettime
  47.   ______________________________________________________________________
  48.  
  49.        o The program can call DBGETTIME() to learn the  current  timeout
  50.          value.
  51.        o A timeout generates the DB-Library error "SYBETIME."
  52.  
  53.   PARAMETERS:
  54.        seconds -   The  timeout  value-the  number   of   seconds   that
  55.            DB-Library waits for a SQL Server response before timing out.
  56.            A timeout value of 0 represents an infinite timeout period.
  57.  
  58.   RETURNS:
  59.        SUCCEED or FAIL.
  60.  
  61.   SEE ALSO:
  62.        dberrhandle,  DBGETTIME,  dbsetlogintime,   dbsqlexec,   dbsqlok,
  63.        dbsqlsend
  64.  
  65.  
  66.  
  67.