home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbrpcsend.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.3 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                dbrpcsend
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbrpcsend
  6.  
  7.   FUNCTION:
  8.        Signal the end of a remote procedure call.
  9.  
  10.   SYNTAX:
  11.        RETCODE dbrpcsend(dbproc)
  12.  
  13.        DBPROCESS *dbproc;
  14.  
  15.   COMMENTS:
  16.  
  17.        o An application can call a stored  procedure  in  two  ways:  by
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbrpcsend               Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.          executing a command buffer containing  a  Transact-SQL  EXECUTE
  27.          statement  or  by  making a remote procedure call ("rpc").  See
  28.          the manual page for dbrpcinit() for a discussion of the differ-
  29.          ences between these techniques.
  30.  
  31.        o To make a remote procedure  call,  first  call  dbrpcinit()  to
  32.          specify  the  stored procedure that's to be invoked.  Then call
  33.          dbrpcparam() once for each of the  stored  procedure's  parame-
  34.          ters.   Finally,  call  dbrpcsend()  to  signify the end of the
  35.          parameter list.  This causes the server to begin executing  the
  36.          specified procedure.  You can then call dbsqlok(), dbresults(),
  37.          and dbnextrow() to  process  the  stored  procedure's  results.
  38.          (Note  that you will need to call dbresults() multiple times if
  39.          the stored procedure contains more than one SELECT  statement.)
  40.          After all of the stored procedure's results have been processed
  41.          you can call the routines that process  return  parameters  and
  42.          status numbers, such as dbretdata() and dbretstatus().
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                dbrpcsend
  47.   ______________________________________________________________________
  48.        o For an example of a remote procedure call, see Example 8 in the
  49.          DB-Library Reference Supplement.
  50.  
  51.   PARAMETERS:
  52.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  53.            connection  for  a  particular  front-end/server process.  It
  54.            contains all the information that DB-Library uses  to  manage
  55.            communications and data between the front end and the server.
  56.  
  57.   RETURNS:
  58.        SUCCEED or FAIL.
  59.  
  60.   SEE ALSO:
  61.        dbnextrow,   dbresults,   dbretdata,   dbretstatus,    dbrpcinit,
  62.        dbrpcparam, dbsqlok
  63.  
  64.  
  65.  
  66.  
  67.