D_GTSCM

SUMMARY
   d_gtscm(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_gtscm copies the last access timestamp for the current
   member of SET into the unsigned long variable pointer to by ts.

──────────────────────────────────────────────────────────────────────────
Note:
   This function should be used with function d_csmget to save the curent
   member'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.

   -9   S_NOCM         The current member is null.

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

EXAMPLE

    ..
   /* print key words for (timestamped) info record */

   DB_ADDR dba;
   ULONG   ts ;

   /* save current member of key_to_info set in
      case info record was retrieved from a key word scan */
   d_csmget(KEY_TO_INFO,&dba);
   d_gtscm (KEY_TO_INFO,&ts);
    ..     /* print key words thru info_to_key */
   /* restore current member                   */
   d_csmset(KEY_TO_INFO,&dba);
   d_stscm (KEY_TO_INFO,&ts);
    ..