home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbuse.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.7 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                    dbuse
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbuse
  6.  
  7.   FUNCTION:
  8.        Use a particular database.
  9.  
  10.   SYNTAX:
  11.        RETCODE dbuse(dbproc, dbname)
  12.  
  13.        DBPROCESS *dbproc;
  14.        char      *dbname;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbuse                   Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This routine issues a Transact-SQL USE command for  the  speci-
  28.          fied  database for a particular DBPROCESS.  It sets up the com-
  29.          mand and calls dbsqlexec() and dbresults().
  30.        o If the USE command fails because the requested database has not
  31.          yet completed a recovery process, dbuse() will continue to send
  32.          USE commands at one second intervals until it  either  succeeds
  33.          or encounters some other error.
  34.  
  35.        o The routine uses the dbproc provided by the  caller.   It  also
  36.          uses the command buffer of that dbproc.  dbuse() overwrites any
  37.          existing commands in the buffer and clears the buffer  when  it
  38.          is finished.
  39.  
  40.   PARAMETERS:
  41.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  42.            connection for a particular front-end/SQL Server process.  It
  43.            contains all the information that DB-Library uses  to  manage
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                    dbuse
  47.   ______________________________________________________________________
  48.            communications and data between the front end and SQL Server.
  49.        dbname -  The name of the database to use.
  50.  
  51.   RETURNS:
  52.        SUCCEED or FAIL.
  53.  
  54.   SEE ALSO:
  55.        dbchange, dbname
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.