home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / bcp_sendrow.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  3.0 KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89              bcp_sendrow
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  bcp_sendrow
  6.  
  7.   FUNCTION:
  8.        Send a row of data from program variables to SQL Server.
  9.  
  10.   SYNTAX:
  11.        RETCODE bcp_sendrow(dbproc)
  12.  
  13.        DBPROCESS *dbproc;
  14.  
  15.   COMMENTS:
  16.  
  17.        o bcp_sendrow() builds a row from program variables and sends  it
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   bcp_sendrow             Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.          to SQL Server.
  27.  
  28.        o Before calling bcp_sendrow(), you must make calls to bcp_bind()
  29.          to specify the program variables to be used.
  30.        o If bcp_bind() is called with a type  parameter  of  SYBTEXT  or
  31.          SYBIMAGE  and  a non-NULL varaddr parameter, bcp_sendrow() will
  32.          send the entire text or image data value, just as it  does  for
  33.          all  other  datatypes.   If,  however,  bcp_bind()  has  a NULL
  34.          varaddr parameter, bcp_sendrow() will  return  control  to  the
  35.          application immediately after all non-text or image columns are
  36.          sent  to   SQL Server.    The   application   can   then   call
  37.          bcp_moretext() repeatedly to send the text and image columns to
  38.          SQL Server, a chunk  at  a  time.   For  an  example,  see  the
  39.          bcp_moretext() manual page.
  40.  
  41.        o After the last call to bcp_sendrow(), you must call  bcp_done()
  42.          to ensure proper internal cleanup.
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89              bcp_sendrow
  47.   ______________________________________________________________________
  48.        o When bcp_sendrow() is used to bulk copy rows from program vari-
  49.          ables  into  SQL Server  tables,  rows are permanently saved in
  50.          SQL Server only when the user calls bcp_batch() or bcp_done().
  51.  
  52.          The user may choose to call bcp_batch() once every n  rows,  or
  53.          when  there is a lull between periods of incoming data (as in a
  54.          telemetry application). Of course, the  user  may  choose  some
  55.          other criteria or may decide not to call bcp_batch() at all. If
  56.          bcp_batch() is never called, the rows are permanently saved  in
  57.          SQL Server when bcp_done() is called.
  58.        o For information on the bcp utility program, see its manual page
  59.          in the Commands Reference.
  60.  
  61.   PARAMETERS:
  62.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  63.            connection for a particular front-end/SQL Server process.  It
  64.            contains all the information that DB-Library uses  to  manage
  65.  
  66.  
  67.  
  68.   bcp_sendrow             Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.            communications and data between the front end and SQL Server.
  71.  
  72.   RETURNS:
  73.        SUCCEED or FAIL.
  74.  
  75.   SEE ALSO:
  76.        bcp_batch,   bcp_bind,   bcp_colfmt,   bcp_collen,    bcp_colptr,
  77.        bcp_columns,    bcp_control,    bcp_done,   bcp_exec,   bcp_init,
  78.        bcp_moretext
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.