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 ...
Get Oracle Distributed Systems now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.