D_DISCON

SUMMARY
d_discon(SET [,dbn])
int SET;
int dbn;

ARGUMENTS
SET The set type from whitch current member is to be disconnected.
dbn (optional) The number of the database containing the record

DESCRIPTION
Function d_discon disconnects the current member from SET. The current
record will become the disconnected record and the new current member
will become the next member of SET. Status S_EOS is returned when the
last member (i.e. the one at the end of the set) has been disconnected.
This function does not delete the record.

CURRENCY CHANGES
curr_rec=curr_mem[set];
curr_mem[set]=next member of SET;

RETURN CODES
1 S_EOS End of set. You've just disconnected the last
member of set.

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

-8 S_NORO The current owner is null.

-9 S_NOCM The current member is null.

-24 S_NOTLOCKED Set type is not locked.

-27 S_TRNOTACT Transaction not active. In shared mode, changes can
only be made from within a transaction

EXAMPLE
/* disconnect and delete abstract */
d_setom(ABSTRACT,HAS_PUBISHED);
while (d_findfm(ABSTRACT)==S_OKAY) {
d_discon(ABSTRACT);
d_delete();
}