DB_SITE->remove()

#include <db.h>

int
DB_SITE->remove(DB_SITE *site); 

The DB_SITE->remove() method removes the site from the replication group. If called at the master site, Replication Manager updates the group membership database directly. If called from a client, this method causes a request to be sent to the master to perform the operation. The method then awaits confirmation.

The DB_SITE handle must not be accessed again after this method is called, regardless of the return value. This method may not be called before starting Replication Manager.

The DB_SITE->remove() method returns a non-zero error value on failure and 0 on success.

Errors

The DB_SITE->remove() method may fail and return one of the following non-zero errors:

DB_REP_UNAVAIL

The master updated the group membership database but did not receive enough acknowledgements from clients to meet the current acknowledgement policy or there was an attempt to remove the current master site from the replication group.

EINVAL

If Replication Manager has not been started.

Class

DB_SITE

See Also

Replication and Related Methods