home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer) / NeXT_Developer-3.3.iso / usr / sybase / doc / dbtsnewlen.man < prev    next >
Encoding:
Text File  |  1993-04-22  |  2.1 KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89               dbtsnewlen
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbtsnewlen
  6.  
  7.   FUNCTION:
  8.        Return the length of the new value of the timestamp column  after
  9.        a browse-mode update.
  10.  
  11.   SYNTAX:
  12.        int dbtsnewlen(dbproc)
  13.  
  14.        DBPROCESS *dbproc;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbtsnewlen              Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o dbtsnewlen() is one of the  DB-Library  browse  mode  routines.
  28.          See the Introduction for a detailed discussion of browse mode.
  29.        o dbtsnewlen() provides information about the  timestamp  column.
  30.          The  WHERE  clause  returned by dbqual() contains a call to the
  31.          tsequal built-in function.  When such a WHERE clause is used in
  32.          an UPDATE statement, the tsequal function places a new value in
  33.          the updated row's timestamp column and returns the  new  times-
  34.          tamp  value  to  the application (if the update is successful).
  35.          The dbtsnewlen() function allows the application  to  save  the
  36.          length  of  the  new  timestamp  value,  possibly  for use with
  37.          dbtsput().
  38.  
  39.   PARAMETERS:
  40.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  41.            connection for a particular front-end/SQL Server process.  It
  42.            contains all the information that DB-Library uses  to  manage
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89               dbtsnewlen
  47.   ______________________________________________________________________
  48.            communications and data between the front end and SQL Server.
  49.  
  50.   RETURNS:
  51.        The length (in bytes) of the updated row's new  timestamp  value.
  52.        If no timestamp was returned to the application (possibly because
  53.        the update was unsuccessful, or because the UPDATE statement  did
  54.        not  contain  the  tsequal  built-in function), dbtsnewlen() will
  55.        return -1.
  56.  
  57.   SEE ALSO:
  58.        dbcolbrowse, dbcolsource, dbqual, dbtabbrowse, dbtabcount, dbtab-
  59.        name, dbtabsource, dbtsnewval, dbtsput
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.