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