Oracle9i Replication Management API Reference
Release 1 (9.0.1)

Part Number A87502-01
Go To Documentation Library
Home
Go To Product List
Book List
Go To Table Of Contents
Contents
Go To Index
Index

Master Index

Feedback

Go to previous page Go to beginning of chapter Go to next page

DBMS_OFFLINE_OG, 6 of 6


RESUME_SUBSET_OF_MASTERS Procedure

When you add a new master site to a master group by performing an offline instantiation of a master site, it may take some time to complete the offline instantiation process. This procedure resumes replication activity at all existing sites, except the new site, during offline instantiation of a master group. You typically execute this procedure after executing the DBMS_OFFLINE_OG.BEGIN_INSTANTIATION procedure. You must call this procedure from the master definition site.


Note:

This procedure is used to perform 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 materialized view) 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 usage. 


See Also:

"Adding New Master Sites with Offline Instantiation Using Export/Import" for information about adding a new master site to a master group by performing an offline instantiation of a master site 

Syntax

DBMS_OFFLINE_OG.RESUME_SUBSET_OF_MASTERS (
   gname     IN  VARCHAR2,
   new_site  IN  VARCHAR2
   override  IN  BOOLEAN := false);

Parameters

Table 16-10 RESUME_SUBSET_OF_MASTERS Procedure Parameters
Parameter  Description 
gname
 

Name of the replication group that you are replicating to the new site. 

new_site
 

The fully qualified database name of the new site to which you are replicating the replication group. 

override
 

If this is true, then any pending RepCat administrative requests are ignored and normal replication activity is restored at each master as quickly as possible. The override parameter should be set to true only in emergency situations.

If this is false, then normal replication activity is restored at each master only when there is no pending RepCat administrative request for gname at that master. 

Exceptions

Table 16-11 RESUME_SUBSET_OF_MASTERS Procedure Exceptions
Exception  Description 
badargument
 

NULL or empty string for replication group or new master site name. 

dbms_repcat.nonmasterdef
 

This procedure must be called from the master definition site. 

unknownsite
 

Specified site is not recognized by replication group. 

wrongstate
 

Status of master definition site must be quiesced. 

dbms_repcat.missingrepgroup
 

gname does not exist as a master group. 


Go to previous page Go to beginning of chapter Go to next page
Oracle
Copyright © 1996-2001, Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Home
Go To Product List
Book List
Go To Table Of Contents
Contents
Go To Index
Index

Master Index

Feedback