home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbtxtimestamp.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.0 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89            dbtxtimestamp
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbtxtimestamp
  6.  
  7.   FUNCTION:
  8.        Return the value of the  text  timestamp  for  a  column  in  the
  9.        current row.
  10.  
  11.   SYNTAX:
  12.        DBBINARY *dbtxtimestamp(dbproc, column)
  13.  
  14.        DBPROCESS *dbproc;
  15.        int       column;
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbtxtimestamp           Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.   COMMENTS:
  28.  
  29.        o Every database column of type SYBTEXT or SYBIMAGE has an  asso-
  30.          ciated  text  timestamp,  which  marks the time of the column's
  31.          last modification.  The text timestamp is useful in conjunction
  32.          with  the  dbwritetext() function, to ensure that two competing
  33.          application users do not inadvertently wipe  out  each  other's
  34.          modifications  to  the  same  value  in  the  database.   It is
  35.          returned to the DBPROCESS when a Transact-SQL  SELECT  is  per-
  36.          formed on a SYBTEXT or SYBIMAGE column.
  37.        o The length of a non-NULL text  timestamp  is  always  DBTXTSLEN
  38.          (currently defined as eight bytes).
  39.  
  40.        o For an example that uses dbtxtimestamp(), see the dbwritetext()
  41.          manual page.
  42.  
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89            dbtxtimestamp
  47.   ______________________________________________________________________
  48.  
  49.   PARAMETERS:
  50.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  51.            connection for a particular front-end/SQL Server process.  It
  52.            contains all the information that DB-Library uses  to  manage
  53.            communications and data between the front end and SQL Server.
  54.        column -  The number of the column of interest.  The first column
  55.            in a table is number 1.
  56.  
  57.   RETURNS:
  58.        A DBBINARY pointer to  the  text  timestamp  for  the  column  of
  59.        interest.  This pointer may be NULL.
  60.  
  61.   SEE ALSO:
  62.        dbtxptr, dbwritetext
  63.  
  64.  
  65.  
  66.  
  67.