Progress Fathom Replication
User’s Guide
Preface
This Preface contains the following sections:
Purpose
This book describes the how to configure and use Progress® Fathom™ Replication. In addition, it describes the underlying architecture of Fathom Replication.
Audience
This book is intended for anyone familiar with Progress database administration who plans to set up and use Fathom Replication.
Organization
Chapter 1 "Overview of Fathom Replication"
Provides an overview of the functionality and architecture of Fathom Replication.
Chapter 2 "Administration and Procedures"
Provides instructions on how to use Fathom Replication and describes the procedures Fathom Replication automatically performs.
Provides reference information for Fathom Replication, including descriptions of properties, utilities, and virtual system tables.
Provides a command summary for setting up and using Fathom Replication.
Typographical conventions
This manual uses the following typographical conventions:
Examples of syntax descriptions
In this example,
ACCUM
is a keyword, andaggregate
andexpression
are variables:
FOR
is one of the statements that can end with either a period or a colon, as in this example:
In this example,
STREAM
stream
,UNLESS-HIDDEN
, andNO-ERROR
are optional:
In this example, the outer (small) brackets are part of the language, and the inner (large) brackets denote an optional item:
A called external procedure must use braces when referencing compile-time arguments passed by a calling procedure, as shown in this example:
In this example,
EACH
,FIRST
, andLAST
are optional, but you can choose only one of them:
In this example, you must include two expressions, and optionally you can include more. Multiple expressions are separated by commas:
In this example, you must specify
MESSAGE
and at least oneexpression
orSKIP
[ (n
) ], and any number of additionalexpression
orSKIP
[ (n
) ] is allowed:
In this example, you must specify {
include-file
, then optionally any number ofargument
or&argument-name = "argument-value"
, and then terminate with }:
Long syntax descriptions split across lines
Some syntax descriptions are too long to fit on one line. When syntax descriptions are split across multiple lines, groups of optional and groups of required items are kept together in the required order.
In this example,
WITH
is followed by six optional items:
Progress messages
Progress displays several types of messages to inform you of routine and unusual occurrences:
- Execution messages inform you of errors encountered while Progress is running a procedure; for example, if Progress cannot find a record with a specified index field value.
- Compile messages inform you of errors found while Progress is reading and analyzing a procedure before running it; for example, if a procedure references a table name that is not defined in the database.
- Startup messages inform you of unusual conditions detected while Progress is getting ready to execute; for example, if you entered an invalid startup parameter.
After displaying a message, Progress proceeds in one of several ways:
- Continues execution, subject to the error-processing actions that you specify or that are assumed as part of the procedure. This is the most common action taken after execution messages.
- Returns to the Progress Procedure Editor, so you can correct an error in a procedure. This is the usual action taken after compiler messages.
- Halts processing of a procedure and returns immediately to the Procedure Editor. This does not happen often.
- Terminates the current session.
Progress messages end with a message number in parentheses. In this example, the message number is
200
:
If you encounter an error that terminates Progress, note the message number before restarting.
Obtaining more information about Progress messages
On Windows platforms, use Progress online help to obtain more information about Progress messages. Many Progress tools include the following Help menu options to provide information about messages:
- Choose Help
Recent Messages to display detailed descriptions of the most recent Progress message and all other messages returned in the current session.
- Choose Help
Messages and then enter the message number to display a description of a specific Progress message.
- In the Procedure Editor, press the help key (F2 or CTRL-W).
On UNIX platforms, use the Progress
PRO
command to start a single-user mode character Progress client session and view a brief description of a message by providing its number.To use the
PRO
command to obtain a message description by message number:Progress documentation
This section lists some of the Progress Software Corporation documentation that you might find useful.
Progress Fathom Replication
Progress Fathom Replication Installation Guide (Also available in hard copy)
A guide that provides step-by-step instructions for installing Fathom Replication on Windows and UNIX. This guide also includes documentation on upgrading from an existing Fathom Replication installation, and provides a list of supported platforms with their requisite software.
Database
Progress Database Design Guide
A guide that uses a sample database and the Progress Data Dictionary to illustrate the fundamental principles of relational database design. Topics include relationships, normalization, indexing, and database triggers.
Progress Database Administration Guide and Reference
This guide describes Progress database administration concepts and procedures. The procedures allow you to create and maintain your Progress databases and manage their performance.
Reference
Pocket Progress and WebSpeed (Hard copy only)
A reference that lets you quickly look up information about the Progress and SpeedScript languages and about the Progress and WebSpeed programming environments.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |