home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbsqlsend.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.9 KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                dbsqlsend
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbsqlsend
  6.  
  7.   FUNCTION:
  8.        Send a command  batch  to  SQL Server  and  do  not  wait  for  a
  9.        response.
  10.  
  11.   SYNTAX:
  12.        RETCODE dbsqlsend(dbproc)
  13.  
  14.        DBPROCESS *dbproc;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbsqlsend               Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o This routine sends SQL commands, stored in the command  buffer,
  28.          to SQL Server.  The application can add commands to the command
  29.          buffer by calling dbcmd() or dbfcmd().
  30.        o Once dbsqlsend() returns SUCCEED,  the  application  must  call
  31.          dbsqlok()  to  verify  the  accuracy of the command batch.  The
  32.          application can then call dbresults() to process the results.
  33.  
  34.        o dbsqlexec() is equivalent to dbsqlsend() followed by dbsqlok().
  35.        o The use of dbsqlsend() with dbsqlok() is of particular value in
  36.          UNIX  applications.   After  sending  a  query  to  SQL Server,
  37.          dbsqlexec() waits until a response is  received  or  until  the
  38.          timeout  period  has  elapsed.  By substituting dbsqlsend() and
  39.          dbsqlok() for dbsqlexec(), you can sometimes provide a way  for
  40.          a  UNIX  application  to  respond  more effectively to multiple
  41.          input and output streams.  The time  between  the  request  for
  42.          information  from  SQL Server  (made via a call to dbsqlsend())
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                dbsqlsend
  47.   ______________________________________________________________________
  48.          and SQL Server's response (read by calling  dbsqlok())  can  be
  49.          used,  in  conjunction with DBIORDESC() or DBIOWDESC(), to ser-
  50.          vice  other  parts  of  the   application.    DBIORDESC()   and
  51.          DBIOWDESC()  are available for UNIX only.  See the manual pages
  52.          for those two routines for more information.
  53.  
  54.          For a UNIX example that illustrates the use of dbsqlsend() with
  55.          dbsqlok(),  DBIORDESC()  and  DBIOWDESC(),  see  the DB-Library
  56.          Reference Supplement.
  57.  
  58.   PARAMETERS:
  59.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  60.            connection for a particular front-end/SQL Server process.  It
  61.            contains all the information that DB-Library uses  to  manage
  62.            communications and data between the front end and SQL Server.
  63.  
  64.   RETURNS:
  65.        SUCCEED or FAIL.  dbsqlsend() may fail if  previous  results  had
  66.  
  67.  
  68.   dbsqlsend               Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.        not been processed, or if the command buffer was empty.
  71.  
  72.   SEE ALSO:
  73.        dbcmd, dbfcmd, DBIORDESC, DBIOWDESC, dbnextrow, dbresults, dbset-
  74.        time, dbsqlexec, dbsqlok
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.