Click above to get retro games delivered to your door ever month!

   D_CSMGET

SUMMARY
   d_csmget(SET,dba[,dbn])
   int SET;
   DB_ADDR *dba;
   int dbn;

ARGUMENTS
   SET       Set type for which the current member's database address is to
             be returned.

   dba       Pointer to a BD_ADRR variable to receive the database address
             of the current member.

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


DESCRIPTION
   This function copies the database address of the current member of SET
   into the  database address variable pointer to by dba. It is used in
   conjuction with the d_csmset function for saving and restoring the
   current member of a set. If the current member is null (NULL_DBA) error
   code S_NOCM is returned as a status (i.e dberr is not called) and *dba
   will be set to null.

--------------------------------------------------------------------------
Note:
   If the record type of the current member is timestamped, you should also
   call function d_gtscm to get its last access timestamp. When the current
   member is later restored by d_csmset, function d_stscm should also be
   called to restore the last access timestamp associated with that current
   member record.
--------------------------------------------------------------------------

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. Returned as a status not
                       an error

EXAMPLE

   /* print key words for info records */
   DB_ADDR save_dba;
    ..
   /* 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)
    ..     /* print key words thru info_to_key */
   /* restore current member */
   d_csmset(KEY_TO_INFO,&dba);
    ..