ADAORD Utility Replication Functions

#### Search Results

Search

# ADAORD Utility Replication Functions

Several ADAORD utility function parameters can be specified for the Adabas database and for the Event Replicator Server when using replication. These are described in this document.

This document covers the following topics:

- ADAORD REORASSO Parameters for the Adabas Database

- ADAORD STORE Parameters for the Adabas Database

- ADAORD STORE Parameters for the Event Replicator Server

## ADAORD REORASSO Parameters for the Adabas Database

The RPLUPDATEONLY parameter can be used in the ADAORD REORASSO function to indicate whether an Adabas database file may be updated only by the Event Replicator Server as part of Adabas-to-Adabas replication or by other means as well. This parameter is optional. Valid values are "YES" or "NO". A value of "YES" indicates that the file can only be updated via Event Replicator processing; a value of NO indicates that the file can be updated by any normal means, including Event Replicator processing. There is no default; if no value is specified for the RPLUPDATEONLY parameter in the ADAORD REORASSO function, the value used previously for the file is used.

## ADAORD STORE Parameters for the Adabas Database

Several ADAORD STORE parameters can be specified for the Adabas database files when using replication. The replication-related parameters are only allowed for ADAORD STORE if replication is already turned on for a database. These are described in this section:

The replication-related parameters for ADAORD STORE are described below:

- RPLDSBI: Before Image for Data Storage

- RPLKEY: Primary Key for Replication

- RPLTARGETID: Replication Target ID

- RPLUPDATEONLY: Allow Only Event Replicator Processing Updates

- Examples

### RPLDSBI: Before Image for Data Storage

The RPLDSBI parameter indicates whether the collection of before images of data storage during an update command to the file should be done if replication is turned on for the file.

Note
This parameter can only be specified if replication is turned on for the file.

If RPLDSBI is not specified, the default value depends on the target database ID (DBID) of the RESTORE and its replication state; if the ADAORD STORE DBID is the same as the original RESTRUCTURE DBID and REPLICATION=YES in the target DBID, the original RPLDSBI value is used. Otherwise, RPLDSBI is set to NO.

For more information about how this setting is used in Adabas database processing during replication, read Adabas Nucleus Replication Setup and Detailed Adabas Nucleus Processing.

### RPLKEY: Primary Key for Replication

The RPLKEY parameter specifies the primary key for replication. The format is RPLKEY='primary-key-for-replication'. When a valid descriptor name is specified for RPLKEY, the specified descriptor is used as the primary replication key for the corresponding file. When OFF is specified for RPLKEY, no primary key is used for replication (RPLKEY is turned off) for the corresponding file.

Note
This parameter can only be specified if replication is turned on for the file, and if the provided descriptor name is a valid Adabas descriptor.

If RPLKEY is not specified, the default value depends on the target database ID (DBID) of the RESTORE and its replication state; if the ADAORD STORE DBID is the same as the original RESTRUCTURE DBID and REPLICATION=YES in the target DBID, the original RPLKEY value is used. Otherwise, RPLDSBI is set to OFF.

For more information about how this primary key is used in Adabas database processing during replication, read Adabas Nucleus Replication Setup and Detailed Adabas Nucleus Processing.

### RPLTARGETID: Replication Target ID

The RPLTARGETID parameter specifies the Event Replicator target ID used when the Adabas file data is replicated. The format is RPLTARGETID='reptor-target-id'. When a valid target ID is specified for RPLTARGETID, the specified target is used as the target for replicated data for the corresponding file. When OFF or 0 (zero) are specified for RPLTARGETID, no target is used for replication for the corresponding file.

If RPLTARGETID is not specified, the default value depends on the target database ID (DBID) of the RESTORE and its replication state; if the ADAORD STORE DBID is the same as the original RESTRUCTURE DBID and REPLICATION=YES in the target DBID, the original RPLTARGETID value is used. Otherwise, RPLTARGETID is set to OFF.

For more information about how this target ID is used in Adabas database processing during replication, read Adabas Nucleus Replication Setup.

Note
Replication may not be turned on for an Adabas system file, a ciphered file, or a file that allows spanned data storage records (i.e. a file compressed with the ADACMP COMPRESS option SPAN).

### RPLUPDATEONLY: Allow Only Event Replicator Processing Updates

The RPLUPDATEONLY parameter can be used in the ADAORD STORE function to indicate whether an Adabas database file may be updated only by the Event Replicator Server as part of Adabas-to-Adabas replication or by other means as well. This parameter is optional.

Valid values are "YES" or "NO". A value of "YES" indicates that the file can only be updated via Event Replicator processing; a value of NO indicates that the file can be updated by any normal means, including Event Replicator processing.

If the file is a new file, the default for this parameter is "NO".

However, if the file specified in the ADAORD STORE function is an existing file, there is no default for this parameter. If no value is specified for the RPLUPDATEONLY parameter in the ADAORD STORE function for an existing file, the value used previously for the file is used.

### Examples

    ADAORD STORE FILE=60,RPLTARGETID=13,RPLKEY=AA,RPLDSBI

## ADAORD STORE Parameters for the Event Replicator Server

The REPLICATOR and SLOG parameters are used when the ADAORD STORE processes Replicator system files.

The replication-related parameters for ADAORD STORE are described below:

- REPLICATOR: Store the Replicator System File

- SLOG: Store the SLOG System File

- Examples

### REPLICATOR: Store the Replicator System File

Use this parameter to store the Replicator system file from the DDFILEA tape as the new Replicator system file for the database. The new Replicator system file must have the same file number as the old Replicator system file.

When the REPLICATOR parameter is not specified, the Replicator system file on the DDFILEA tape is not stored in the database, even if it is specified by a FILE or ALLFILES parameter.

### SLOG: Store the SLOG System File

Use this parameter to store the SLOG system file from the DDFILEA tape as the new SLOG file for the database. The new SLOG file must have the same file number as the old SLOG file.

When the SLOG parameter is not specified, the SLOG system file on the DDFILEA tape is not stored in the database, even if it is specified by a FILE or ALLFILES parameter.

### Examples

    ADAORD STORE ALLFILES,SLOG

or

    ADAORD STORE FILE=89,REPLICATOR,OVERWRITE

### On this page

- ADAORD REORASSO Parameters for the Adabas Database
- ADAORD STORE Parameters for the Adabas Database
- ADAORD STORE Parameters for the Event Replicator Server