home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbtsnewval.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.5 KB  |  50 lines
  1. .Na "dbtsnewval"
  2. .mc |
  3. .Aa
  4. .Fu
  5. Return the new value of the timestamp column after a browse-mode update.
  6. .Ih "timestamp column, value of (browse mode)"
  7. .Sy
  8. .Sf "DBBINARY *dbtsnewval(dbproc)"
  9. .Sp "DBPROCESS" "*dbproc"
  10. .Co
  11. .Bl
  12. \f2dbtsnewval()\f1 is one of the \*L browse mode routines.
  13. See the Introduction for a detailed discussion of browse mode.
  14. .Bl
  15. \f2dbtsnewval()\f1 provides information about the timestamp column.
  16. The WHERE clause returned by \f2dbqual()\f1 contains a call to the
  17. \f2tsequal\f1 built-in function.
  18. .Ih "tsequal function"
  19. When such a WHERE clause is used in an UPDATE statement,
  20. the \f2tsequal\f1 function places a new value in
  21. the updated row's timestamp column and returns the new timestamp value
  22. to the application (if the update is successful).
  23. This routine allows the application to save the
  24. new timestamp value, possibly for use with \f2dbtsput()\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. A pointer to the updated row's new timestamp value. If no timestamp
  36. was returned to the application (possibly because the update was
  37. unsuccessful, or because the UPDATE statement did not contain
  38. the \f2tsequal\f1 built-in function), the pointer will be NULL.
  39. .Sa
  40. dbcolbrowse,
  41. dbcolsource,
  42. dbqual,
  43. dbtabbrowse,
  44. dbtabcount,
  45. dbtabname,
  46. dbtabsource,
  47. dbtsnewlen,
  48. dbtsput
  49. .mc
  50.