|Oracle8i Replication API Reference
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.
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.
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:
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 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.
This manual uses different fonts to represent different types of information.
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.
The following sections describe conventions used this manual.
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 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".
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'); ALTER TABLESPACE users ADD DATAFILE 'users2.ora' SIZE 50K;
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.
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
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: