home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section3 / bcp_batch.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.2 KB  |  42 lines
  1. .Na "bcp_batch"
  2. .mc |
  3. .Aa
  4. .Fu
  5. Save any preceding rows in \*S.
  6. .Ih "bcp, save a batch of rows in \*S"
  7. .Sy
  8. .Sf "DBINT bcp_batch(dbproc)"
  9. .Sp "DBPROCESS" "*dbproc"
  10. .Co
  11. .Bl
  12. When an application uses \f2bcp_bind()\f1 and \f2bcp_sendrow()\f1 to bulk-copy rows from
  13. program variables to \*S tables, the rows are permanently saved
  14. in \*S only when the program calls \f2bcp_batch()\f1 or \f2bcp_done()\f1.
  15. .Bl
  16. You may call \f2bcp_batch()\f1 once every \f2n\f1 rows or when
  17. there is a lull between periods of incoming data (as in a telemetry
  18. application). Of course, you may choose some other criteria,
  19. or may decide not to call \f2bcp_batch()\f1 at all. If \f2bcp_batch()\f1 is not
  20. called, the rows are permanently saved in \*S when
  21. \f2bcp_done()\f1 is called.
  22. .Bl
  23. For information on the \f2bcp\f1 utility program, see its manual page
  24. in the \f2Commands Reference\f1.
  25. .Bz
  26. .Pa
  27. .Pi dbproc
  28. A pointer to the DBPROCESS structure that provides the connection
  29. for a particular front-end/\*S process.  It contains all the
  30. information that \*L uses to manage communications and data between the
  31. front end and \*S.
  32. .in -.375i
  33. .Re
  34. .br
  35. The number of rows saved since the last call
  36. to \f2bcp_batch()\f1, or -1 in case of error.
  37. .Sa
  38. bcp_bind, 
  39. bcp_done, 
  40. bcp_sendrow
  41. .mc
  42.