Version 8.1.4
 —  Utilities  —

REPLICATION: Activating or Deactivating Replication

The REPLICATION function activates or deactivates replication for an Adabas database file. This function should be used with Adabas databases; it is not valid with Event Replicator databases.

graphics/util_adadbs_replication.png

This document covers the following topics:


Essential Parameter

FILE: File Number

The file number of the database file for which replication is to be activated or deactivated. This parameter is required; there is no default.

Note:
Replication may not be turned on for an Adabas system file or for a ciphered file.

ON, OFF, MODIFY: Set Replication

One of the parameters ON, OFF, or MODIFY must be set. There is no default. Each parameter is described below:

Top of page

Optional Parameter

ACTIVATE: Activate Replication

The ACTIVATE parameter is only allowed when MODIFY is specified. It will activate replication for a file that has replication defined. Replication must already be inactive for the file.

DEACTIVATE: Deactivate Replication

The DEACTIVATE parameter is only allowed when MODIFY is specified. It will deactivate replication for a file that has replication defined. Replication must already be active for the file.

DSBI: Define Before Image

The DSBI parameter defines whether or not before images of data storage are collected for replication during the update of a record on a file. Following are rules for setting the DSBI parameter:

For more information about how this parameter is used in Adabas database processing during replication, read Nucleus Processing in Event Replicator for Adabas Concepts.

KEY: Define Primary Key

The KEY parameter defines the primary key for replication. Following are rules for setting the KEY parameter:

Note:
The field name specified must be a descriptor on the file. Note that "descriptor" in this case is used generically, as the field may be a descriptor, subdescriptor, superdescriptor, etc.

NOKEY: Remove Primary Key Setting

The NOKEY parameter removes the primary key setting when MODIFY is specified. Following are rules for setting the NOKEY parameter:

TARGET: Event Replicator Target ID

TARGET defines the Event Replicator target database ID. This parameter is required when ON is specified, is optional when MODIFY is specified, and is not allowed when OFF is specified.

Top of page

Examples

ADADBS REPLICATION FILE=33,ON,TARGET=206,KEY=AA

or

ADADBS REPLICATION FILE=70,OFF

or

ADADBS REPLICATION FILE=71,MODIFY
ADADBS ACTIVATE

or

ADADBS REPLICATION FILE=72,MODIFY
ADADBS DEACTIVATE

Top of page