Oracle Distributed Systems

Name

DBMS_REPCAT.REMOVE_MASTER_DATABASES

Synopsis

The REMOVE_MASTER_DATABASES procedure complements the ADD_MASTER_DATABASE procedure by removing one or more master databases from a replication group. The master sites being removed do not need to be accessible, but all other masters do. After removing master sites with REMOVE_MASTER_DATABASES, you should call DROP_MASTER_REPGROUP at each of the master sites you removed. Although you do not need to quiesce the replication group to remove one or more master database(s), you are strongly encouraged to do so. Otherwise, you will manually have to clear the RPC queue and resolve any inconsistencies.

Specification differ for Oracle7 and Oracle8 as follows.

Oracle7 specification:

PROCEDURE DBMS_REPCAT.REMOVE_MASTER_DATABASES
   (gname IN VARCHAR2 := '',
    master_list IN VARCHAR2,
    sname IN VARCHAR2 := '');

Oracle8 specification:

PROCEDURE DBMS_REPCAT.REMOVE_MASTER_DATABASES
   (gname IN VARCHAR2 := '',
    master_list IN VARCHAR2);,

Parameters

Parameter Name	Description
gname	Name of the replication group from which the master site(s) will be removed.
master_list	A comma-delimited list of global_names of master sites to be removed; use either master_list or master_table.
sname (Oracle7 only)	Schema name (provided for pre-Oracle 7.3 compatibility).

Exceptions

Exception Name	Number	Description
commfailure	–23317	One or more remaining master sites is not reachable.
nonmaster	–23313	One or more of the specified masters is not a master database.
nonmasterdef	–23312	Calling site is ...