home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section3 / bcp_columns.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.4 KB  |  48 lines
  1. .Na "bcp_columns"
  2. .mc |
  3. .Aa
  4. .Fu
  5. Set the total number of columns found in the host file.
  6. .Ih "bcp, set number of columns in host file"
  7. .Sy
  8. .Sf "RETCODE bcp_columns(dbproc, host_colcount)"
  9. .Sp "DBPROCESS" "*dbproc"
  10. .Sp "int" "host_colcount"
  11. .Co
  12. .Bl
  13. This function sets the total number of columns found in a
  14. host file for use with bulk copy. This routine may
  15. be called only after \f2bcp_init()\f1 has been called with a valid
  16. file name.
  17. .Bl
  18. You should call this routine only if you intend to use a host file
  19. format that differs from the default. The default host file format
  20. is described on the \f2bcp_init()\f1 manual page.
  21. .Bl
  22. After calling \f2bcp_columns()\f1, you must call \f2bcp_colfmt()\f1 \f2host_colcount\f1
  23. times, because you are defining a completely custom file format.
  24. .Bl
  25. For information on the \f2bcp\f1 utility program, see its manual page
  26. in the \f2Commands Reference\f1.
  27. .Bz
  28. .Pa
  29. .Pi dbproc
  30. A pointer to the DBPROCESS structure that provides the connection
  31. for a particular front-end/\*S process.  It contains all the
  32. information that \*L uses to manage communications and data between the
  33. front end and \*S.
  34. .Pi host_colcount
  35. The total number of columns in the host file. Even if
  36. you are preparing to bulk copy data from the host file
  37. to a \*S table and do not intend to copy all
  38. columns in the host file, you must still set \f2host_colcount\f1
  39. to the total number of host file columns.
  40. .in -.375i
  41. .Re
  42. .br
  43. SUCCEED or FAIL.
  44. .Sa
  45. bcp_colfmt,
  46. bcp_init
  47. .mc
  48.