home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbwritepage.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.3 KB  |  49 lines
  1. .Na "dbwritepage" 
  2. .Aa
  3. .Fu
  4. Write a page of binary data to \*S.
  5. .Ih "binary data, writing a page of"
  6. .Ih "database pages, repairing"
  7. .Sy
  8. .Sf "RETCODE dbwritepage(dbproc, dbname, pageno, size, buf)"
  9. .Sp "DBPROCESS" "*dbproc"
  10. .Sp "char" "*dbname"
  11. .Sp "DBINT" "pageno"
  12. .Sp "DBINT" "size"
  13. .Sp "BYTE" "buf[]"
  14. .Co
  15. .Bl
  16. .I "dbwritepage()"
  17. writes a page of binary data to \*S. This routine is primarily
  18. useful for examining and repairing damaged database pages.
  19. After calling
  20. \f2dbwritepage()\fP, the DBPROCESS may contain some error or informational
  21. messages from \*S. These messages may be accessed through a 
  22. user-supplied message handler.
  23. .Ns W
  24. Use this routine only if you are absolutely sure you know what you are doing!
  25. .Ne
  26. .Bz
  27. .Pa
  28. .Pi dbproc
  29. A pointer to the DBPROCESS structure that provides the connection
  30. for a particular front-end/\*S process.  It contains all the
  31. information that \*L uses to manage communications and data between the
  32. front end and \*S.
  33. .Pi dbname
  34. The name of the database of interest.
  35. .Pi pageno
  36. The number of the database page to be written.
  37. .Pi size
  38. The number of bytes to be written to \*S. Currently,
  39. \*S database pages are 2048 bytes long.
  40. .Pi buf
  41. A pointer to a buffer which holds the data to be written.
  42. .in -.375i
  43. .Re
  44. .br
  45. SUCCEED or FAIL.
  46. .Sa
  47. dbmsghandle,
  48. dbreadpage
  49.