1 Version 4.0 -- 5/1/89 dbtsnewval
______________________________________________________________________
NAME: dbtsnewval
FUNCTION:
Return the new value of the timestamp column after a browse-mode
update.
SYNTAX:
DBBINARY *dbtsnewval(dbproc)
DBPROCESS *dbproc;
COMMENTS:
dbtsnewval Version 4.0 -- 5/1/89 2
______________________________________________________________________
o dbtsnewval() is one of the DB-Library browse mode routines.
See the Introduction for a detailed discussion of browse mode.
o dbtsnewval() provides information about the timestamp column.
The WHERE clause returned by dbqual() contains a call to the
tsequal built-in function. When such a WHERE clause is used in
an UPDATE statement, the tsequal function places a new value in
the updated row's timestamp column and returns the new times-
tamp value to the application (if the update is successful).
This routine allows the application to save the new timestamp
value, possibly for use with dbtsput().
PARAMETERS:
dbproc - A pointer to the DBPROCESS structure that provides the
connection for a particular front-end/SQL Server process. It
contains all the information that DB-Library uses to manage
communications and data between the front end and SQL Server.
3 Version 4.0 -- 5/1/89 dbtsnewval
______________________________________________________________________
RETURNS:
A pointer to the updated row's new timestamp value. If no times-
tamp was returned to the application (possibly because the update
was unsuccessful, or because the UPDATE statement did not contain
the tsequal built-in function), the pointer will be NULL.
SEE ALSO:
dbcolbrowse, dbcolsource, dbqual, dbtabbrowse, dbtabcount, dbtab-
name, dbtabsource, dbtsnewlen, dbtsput