home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbtxtsnewval.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.8 KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89             dbtxtsnewval
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbtxtsnewval
  6.  
  7.   FUNCTION:
  8.        Return the new value of a text timestamp after a call  to  dbwri-
  9.        tetext().
  10.  
  11.   SYNTAX:
  12.        DBBINARY *dbtxtsnewval(dbproc)
  13.  
  14.        DBPROCESS *dbproc;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbtxtsnewval            Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o Every database column of type SYBTEXT or SYBIMAGE has an  asso-
  28.          ciated  text  timestamp, which is updated whenever the column's
  29.          value is changed.  The text timestamp is useful in  conjunction
  30.          with  the  dbwritetext() function, to ensure that two competing
  31.          application users do not inadvertently wipe  out  each  other's
  32.          modifications  to  the  same  value  in  the  database.   It is
  33.          returned to the DBPROCESS when a Transact-SQL  SELECT  is  per-
  34.          formed  on  a SYBTEXT or SYBIMAGE column and may be examined by
  35.          calling dbtxtimestamp().
  36.        o After  each  successful  dbwritetext()  operation  (which   may
  37.          include  a  number  of  calls to dbmoretext()), SQL Server will
  38.          send the updated  text  timestamp  value  back  to  DB-Library.
  39.          dbtxtsnewval()  provides  a way for the application to get this
  40.          new timestamp value.
  41.  
  42.        o The application can use dbtxtsnewval() in two ways.  First, the
  43.          return  from  dbtxtsnewval()  can  be  used  as  the  timestamp
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89             dbtxtsnewval
  47.   ______________________________________________________________________
  48.          parameter of a dbwritetext() call.  Second, dbtxtsnewval()  and
  49.          dbtxtsput() can be used together to put the new timestamp value
  50.          into the DBPROCESS row buffer, for future access via dbtxtimes-
  51.          tamp().   This  is  particularly useful when the application is
  52.          buffering result rows and  does  not  need  the  new  timestamp
  53.          immediately.
  54.  
  55.   PARAMETERS:
  56.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  57.            connection for a particular front-end/SQL Server process.  It
  58.            contains all the information that DB-Library uses  to  manage
  59.            communications and data between the front end and SQL Server.
  60.  
  61.   RETURNS:
  62.        A pointer to the new text timestamp  value  for  the  SYBTEXT  or
  63.        SYBIMAGE  value  modified  by  a  dbwritetext()  operation.  This
  64.        pointer may be NULL.
  65.  
  66.  
  67.  
  68.   dbtxtsnewval            Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.  
  71.   SEE ALSO:
  72.        dbmoretext, dbtxtimestamp, dbtxtsput, dbwritetext
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.