D_GTSCO

SUMMARY
d_gtsco(SET,ts[,dbn])
int SET;
ULONG *ts;
int dbn;

ARGUMENTS
SET The set type for which the last access timestamp is to
be returned.

ts Pointer to a ULONG (unsigned long) variable to contain
timestamp value.

dbn (Optional) The number of the database containing the record.


DESCRIPTION
Function d_gtsco copies the last access timestamp for the current
owner of SET into the unsigned long variable pointer to by ts.

──────────────────────────────────────────────────────────────────────────
Note:
This function should be used with function d_csoget to save the curent
owner's database address and last access timestamp, for those record
types whitch are timestamped.
──────────────────────────────────────────────────────────────────────────

CURRENCY CHANGES
None

RETURN CODES
-2 S_INVSET Invalid set type. Probably passed a record or field
type instead of a set type.

-8 S_NOCO The current owner is null.

-41 S_TIMESTAMP The current owner record type is not timestamped.

EXAMPLE

DB_ADDR dba;
ULONG ts ;
..
/* save current (timestamped) author
on stack for later processing */
d_csoget(HAS_PUBLISHED,&dba);
d_gtsco (HAS_PUBLISHED,&ts);
..
/* restore saved author as owner of has_published */
d_csoset(HAS_PUBLISHED,&dba);
d_stsco (HAS_PUBLISHED,&ts);
..