Replication Management API Reference, 34 of 179

BEGIN_INSTANTIATION procedure

This procedure starts offline instantiation of a replicated master group. You must call this procedure from the master definition site.

Note:
This procedure is used in performing an offline instantiation of a master table in a multimaster replication environment.
This procedure should not be confused with the procedures in the DBMS_OFFLINE_SNAPSHOT package (used for performing an offline instantiation of a snapshot) or with the procedures in the DBMS_REPCAT_INSTANTIATE package (used for instantiating a deployment template). See these respective packages for more information on their use.

Syntax

DBMS_OFFLINE_OG.BEGIN_INSTANTIATION (
   gname     IN   VARCHAR2,
   new_site  IN   VARCHAR2
   fname     IN   VARCHAR2);

Parameters

Table 8-54 BEGIN_INSTANTIATION Procedure Parameters

Parameter	Description
gname	Name of the object group that you want to replicate to the new site.
new_site	The fully qualified database name of the new site to which you want to replicate the object group.
fname	This parameter is for internal use only. Do not set this parameter unless directed to do so by Oracle Worldwide Support.

Exceptions

Table 8-55 BEGIN_INSTANTIATION Procedure Exceptions

Exception	Description
badargument	`NULL` or empty string for object group or new master site name.
dbms_repcat. nonmasterdef	This procedure must be called from the master definition site.
sitealreadyexists	Specified site is already a master site for this object group.
wrongstate	Status of master definition site must be `QUIESCED`.
dbms_repcat. missingrepgroup	`gname` does not exist as a replicated master group.
dbms_repcat.missing_ flavor	If you receive this exception, contact Oracle Worldwide Support.