D_CSOGET

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

ARGUMENTS
SET Set type for which the current owner'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 owner of SET
into the database address variable pointer to by dba. It is used in
conjuction with the d_csoset function for saving and restoring the
current owner of a set. If the current owner is null (NULL_DBA) error
code S_NOCO is returned as a status (i.e dberr is not called) and dba
will receive the null database address.

──────────────────────────────────────────────────────────────────────────
Note:
If the record type of the current owner is timestamped, you should also
call function d_gtsco to get the last access timestamp of current
owner. Then the current owner is later restored by d_csoset, function
d_stsco should also be called to restore the last access timestamp
associated with that current owner record.
──────────────────────────────────────────────────────────────────────────

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

EXAMPLE


DB_ADDR dba;
..
/* save current author on stack for later processing */
d_csoget(HAS_PUBLISHED,&dba)
.. /* print key words thru info_to_key */
/* restore saved author as owner of has_published */
d_csoset(HAS_PUBLISHED,&dba);d_
..