Oracle Distributed Systems

Name

DBMS_REPCAT.ADD_PRIORITY_datatype

Synopsis

Note

Each of the procedures containing the datatype suffix actually has five different versions in Oracle7, one for each of the datatypes CHAR, VARCHAR2, NUMBER, RAW, and DATE. Oracle8 adds support for two more datatypes: NCHAR and NVARCHAR2. The usage of each of these packages is identical.

The ADD_PRIORITY_datatype procedure adds a member (of the specified datatype) to an existing priority group. The addition of the new priority and value takes effect immediately. Values with higher numeric priorities take precedence—that is, the value with priority 1 has the lowest priority. The specifications differ for Oracle7 and Oracle8 as follows.

Oracle7 specification:

PROCEDURE DBMS_REPCAT.ADD_PRIORITY_datatype
   (gname IN VARCHAR2 := '',
    pgroup IN VARCHAR2,
    value IN {CHAR|VARCHAR2|NUMBER|DATE|RAW,
    priority IN NUMBER,
    sname IN VARCHAR2 := '');

Oracle8 specification:

PROCEDURE DBMS_REPCAT.ADD_PRIORITY_datatype
   (gname IN VARCHAR2 := '',
    pgroup IN VARCHAR2,
    value IN {CHAR|NCHAR|VARCHAR2|NUMBER|DATE|RAW,
    priority IN NUMBER)

In these specifications, datatype can be any of the following, and value can be any of these types:

Oracle7 and Oracle8	Oracle8 Only
CHAR	NCHAR
VARCHAR2	NVARCHAR2
NUMBER
DATE
RAW

Parameters

Parameter Name	Description
gname	Name of the replication group to which priority group pgroup belongs
pgroup	Priority group to which new value and priority are being added
value	Literal value that is being assigned added to pgroup
priority	Priority designated to value; ...