home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbtxtsput.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.7 KB  |  89 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89                dbtxtsput
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbtxtsput
  6.  
  7.   FUNCTION:
  8.        Put the new value of a text timestamp into the  specified  column
  9.        of the current row in the DBPROCESS.
  10.  
  11.   SYNTAX:
  12.        RETCODE dbtxtsput(dbproc, newtxts, colnum)
  13.  
  14.        DBPROCESS *dbproc;
  15.        DBBINARY  *newtxts;
  16.        int       colnum;
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbtxtsput               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 is updated whenever the column's
  31.          value is changed.  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 and may be examined by
  37.          calling dbtxtimestamp().
  38.        o After  each  successful  dbwritetext()  operation  (which   may
  39.          include  a  number  of  calls to dbmoretext()), SQL Server will
  40.          send the updated  text  timestamp  value  back  to  DB-Library.
  41.          dbtxtsnewval() allows the application to get this new timestamp
  42.          value.  The application can then use dbtxtsput() to put the new
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89                dbtxtsput
  47.   ______________________________________________________________________
  48.          timestamp value into  the  DBPROCESS  row  buffer,  for  future
  49.          access  via  dbtxtimestamp().  This is particularly useful when
  50.          the application is buffering result rows and does not need  the
  51.          new timestamp immediately.
  52.  
  53.   PARAMETERS:
  54.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  55.            connection for a particular front-end/SQL Server process.  It
  56.            contains all the information that DB-Library uses  to  manage
  57.            communications and data between the front end and SQL Server.
  58.        newtxts -  A pointer to the new  text  timestamp  value.   It  is
  59.            returned by dbtxtsnewval().
  60.        colnum -  The number of the  column  associated  with  this  text
  61.            timestamp.  Column numbers start at 1.
  62.  
  63.   RETURNS:
  64.        SUCCEED or FAIL.
  65.  
  66.  
  67.  
  68.   dbtxtsput               Version 4.0 -- 5/1/89                        4
  69.   ______________________________________________________________________
  70.  
  71.   SEE ALSO:
  72.        dbmoretext, dbtxtimestamp, dbtxtsnewval, dbwritetext
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.