Oracle8i Replication API Reference
Release 8.1.5






Prev Next


This Preface contains the following topics:

The Oracle8i Replication API Reference contains information relating to both Oracle8i and the Oracle8i Enterprise Edition. Some features documented in this manual are available only with the Oracle8i Enterprise Edition. Furthermore, some of these features are only available if you have purchased a particular option, such as the Objects Option.

For information about the differences between Oracle8i and the Oracle8i Enterprise Edition, please refer to Getting to Know Oracle8i. This text describes features common to both products, and features that are only available with the Oracle8i Enterprise Edition or a particular option.

Overview of the Oracle8i Replication API Reference Book

This reference manual describes the Replication Management API. This book assumes that you are familiar with the replication concepts described in the Oracle8i Replication manual.

The emphasis of this book is to illustrate how the Replication Management API is used and to serve as a quick reference source for the Replication Management API.

Information in this manual applies to the Oracle8i server running on all operating systems.Topics include the following:


This manual is written for application developers and database administrators who develop and maintain Oracle8i replication environments.

Knowledge Assumed of the Reader

This manual assumes you are familiar with relational database concepts, distributed database administration, PL/SQL (if using procedural replication), and the operating system under which you run an Oracle replicated environment.

This manual also assumes that you have read and understand the information in the following documents:

How The Oracle8i Replication API Reference Book Is Organized

Chapter 1, "Replication Overview"
Provide a "high level" overview of the process required to build a replicated environment. This chapter also contains some prerequisite information required for building a replicated environment.

Chapter 2, "Create Replication Site"
Chapter 2 describes in detail the process of setting up both a master and snapshot site. This chapter should be consulted when building a new replicated environment and when adding either a new master or snapshot site to an established replicated environment.

Chapter 3, "Create a Master Group"
Describes how to build a master group for multimaster replication or as a master for a snapshot site. Chapter 3 builds a master group that replicates data between the three master sites that were set up during Chapter 2.

Chapter 4, "Create Deployment Template"
Deployment templates are the most effective method of distributing a snapshot environment to any number of snapshot site.

Chapter 5, "Create a Snapshot Group"
If deployment templates do not meet your requirements, Chapter 5 describes in detail how to build a snapshot environment at the snapshot site.

Chapter 6, "Conflict Resolution"
The conflict resolution methods described in Chapter 6 will help your data converge at all site when a data conflict arises.

Chapter 7, "Manage Replicated Environment with APIs"
Chapter 7 describes many of the management tasks that you may need to perform to manage your replicated environment. Topics discussed included master group management, altering replicated objects, offline instantiation, and more.

Chapter 8, "Replication Management API Reference"
Describes parameters for packaged procedures used to implement a replicated environment as well as exceptions these procedures might raise.

Chapter 9, "Data Dictionary Views"
Describes views of interest to users of deferred transactions, read-only snapshots, and the advanced replication facility.

Conventions Used in This Manual

This manual uses different fonts to represent different types of information.

Special Notes

Special notes alert you to particular information within the body of this manual:

Note: Indicates special or auxiliary information.

Attention: Indicates items of particular importance about matters requiring special attention or caution.

Additional Information: Indicates where to get more information.

Text of the Manual

The following sections describe conventions used this manual.

UPPERCASE Characters

Uppercase text is used to call attention to command keywords, object names, parameters, filenames, and so on.

For example, "If you create a private rollback segment, the name must be included in the ROLLBACK_SEGMENTS parameter of the parameter file".

Italicized Characters

Italicized words within text indicate the definition of a word, book titles, or emphasized words.

An example of a definition is the following: "A database is a collection of data to be treated as a unit. The general purpose of a database is to store and retrieve related information".

An example of a reference to another book is the following: "For more information, see the book Oracle8i Tuning."

An example of an emphasized word is the following: "You must back up your database regularly".

Code Examples

SQL, Server Manager line mode, and SQL*Plus commands/statements appear separated from the text of paragraphs in a monospaced font. For example:

INSERT INTO emp (empno, ename) VALUES (1000, 'SMITH'); 

Example statements may include punctuation, such as commas or quotation marks. All punctuation in example statements is required. All example statements terminate with a semicolon (;). Depending on the application, a semicolon or other terminator may or may not be required to end a statement.

Uppercase words in example statements indicate the keywords within Oracle SQL. When issuing statements, however, keywords are not case sensitive.

Lowercase words in example statements indicate words supplied only for the context of the example. For example, lowercase words may indicate the name of a table, column, or file.

Your Comments Are Welcome

We value your comments as an Oracle user and reader of our manuals. As we write, revise, and evaluate, your opinions are the most important input we receive. This manual contains a Reader's Comment Form that we encourage you to use to tell us what you like and dislike about this manual or other Oracle manuals. Please mail comments to:

Oracle8i Server Documentation Manager
Oracle Corporation
500 Oracle Parkway
Redwood Shores, CA 94065

You can send comments and suggestions about this manual to the Information Development department at the following e-mail address:


Copyright © 1999 Oracle Corporation.

All Rights Reserved.