home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbtxtsput.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.9 KB  |  57 lines
  1. .Na "dbtxtsput"
  2. .mc |
  3. .Aa
  4. .Fu
  5. Put the new value of a text timestamp into the specified column
  6. of the current row in the DBPROCESS.
  7. .Ih "timestamp, text, putting new value into DBPROCESS"
  8. .Ih "text timestamp, putting new value into DBPROCESS"
  9. .Sy
  10. .Sf "RETCODE dbtxtsput(dbproc, newtxts, colnum)"
  11. .Sp "DBPROCESS" "*dbproc"
  12. .Sp "DBBINARY" "*newtxts"
  13. .Sp "int" "colnum"
  14. .Co
  15. .Bl
  16. Every database column of type SYBTEXT or SYBIMAGE has an associated
  17. text timestamp, which
  18. is updated whenever the column's value is changed.
  19. The text timestamp is useful in conjunction with the \f2dbwritetext()\f1
  20. function, to ensure that two competing application users do not inadvertently
  21. wipe out each other's modifications to the same value in the database.
  22. It is returned to the DBPROCESS when a \*N
  23. SELECT is performed on a SYBTEXT or SYBIMAGE column and
  24. may be examined by calling \f2dbtxtimestamp()\f1.
  25. .Bl
  26. After each successful \f2dbwritetext()\f1 operation (which may include
  27. a number of calls to \f2dbmoretext()\f1), \*S will send the
  28. updated text timestamp value back to \*L.
  29. \f2dbtxtsnewval()\f1 allows the application to get this new timestamp value.
  30. The application can then use \f2dbtxtsput()\f1 to put the new timestamp value
  31. into the DBPROCESS row buffer, for future access via \f2dbtxtimestamp()\f1.
  32. This is particularly useful when the application is buffering result rows
  33. and does not need the new timestamp immediately.
  34. .Bz
  35. .Pa
  36. .Pi dbproc
  37. A pointer to the DBPROCESS structure that provides the connection
  38. for a particular front-end/\*S process.  It contains all the
  39. information that \*L uses to manage communications and data between the
  40. front end and \*S.
  41. .Pi newtxts
  42. A pointer to the new text timestamp value.
  43. It is returned by \f2dbtxtsnewval()\f1.
  44. .Pi colnum
  45. The number of the column associated with this text timestamp.
  46. Column numbers start at 1.
  47. .in -.375i
  48. .Re
  49. .br
  50. SUCCEED or FAIL.
  51. .Sa
  52. dbmoretext, 
  53. dbtxtimestamp, 
  54. dbtxtsnewval,
  55. dbwritetext
  56. .mc
  57.