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:
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.
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:
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.
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.
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).
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.
ADAORD STORE FILE=60,RPLTARGETID=13,RPLKEY=AA,RPLDSBI
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:
Use this parameter to store the Replicator system file from the DDFILEA/FILEA 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/FILEA tape is not stored in the database, even if it is specified by a FILE or ALLFILES parameter.
Use this parameter to store the SLOG system file from the DDFILEA/FILEA 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/FILEA tape is not stored in the database, even if it is specified by a FILE or ALLFILES parameter.
ADAORD STORE ALLFILES,SLOG
or
ADAORD STORE FILE=89,REPLICATOR,OVERWRITE