Oracle Distributed Systems

Name

DBMS_REPCAT.ADD_SITE_PRIORITY_SITE

Synopsis

The ADD_SITE_PRIORITY_SITE procedure adds a new site to an existing site priority group. The addition of the new site takes effect immediately. Specifications for Oracle7 and Oracle8 differ as follows.

Oracle7 specification:

PROCEDURE DBMS_REPCAT.ADD_SITE_PRIORITY_SITE
   (gname IN VARCHAR2 := '',
    name IN VARCHAR2,
    site IN VARCHAR2,
    priority IN NUMBER,
    sname IN VARCHAR2 := '');

Oracle8 specification:

PROCEDURE DBMS_REPCAT.ADD_SITE_PRIORITY_SITE
   (gname IN VARCHAR2 := '',
    name IN VARCHAR2,
    site IN VARCHAR2,
    priority IN NUMBER);

Parameters

Parameter Name	Description
gname	Name of the replication group to which site priority group name belongs
name	Name of the site priority group
site	Global name of the new site
priority	Priority designated to site; it is a good idea to number priorities in multiples of 10 or more so that you can easily add new priority values later as requirements change.
sname (Oracle7 only)	Schema name (provided for pre-Oracle 7.3 compatibility)

Exceptions

Exception Name	Number	Description
duplicatepriority	–23335	Another site is already designated with the priority specified by the priority parameter.
duplicatesite	–23338	Site is already in the site priority group name.
missingpriority	–1403	Site does not exist.
missingrepgroup	–23373	Replication group gname does not exist.
nonmasterdef	–23312	Calling site is not the master definition site.

Restrictions

• You must call the ADD_SITE_PRIORITY_SITE procedure from the master definition site.

• The new priority ...