Two separate ADADBS utility functions impact replication processing for an Adabas database or for an Event Replicator database:
The REPLICATION function controls whether replication is activated for an Adabas database file. This function should be used for Adabas database files, and not with Event Replicator database files.
The REPTOR function to activate and deactive specific DBID, destination, and subscription definitions in the Replicator system file (Event Replicator database) and to open or close destination and inqueue definitions in the Replicator system file.
In addition, the ADADBS MODFCB function includes a parameter that can be specified to indicate whether an Adabas database file only by the Event Replicator Server as part of Adabas-to-Adabas replication or by other means as well.
The RPLUPDATEONLY parameter can be used in the ADADBS MODFCB 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 ADADBS MODFCB function, the value used previously for the file is used.
The ADADBS 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.
This section covers the following topics:
FILE is 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.
One of the parameters ON, OFF, or MODIFY must be set. There is no default. Each parameter is described below:
ON turns replication on for the specified file.
OFF turns replication off for the specified file.
MODIFY allows you to modify one or more of the replication-related values (KEY, TARGET, DSBI) for a replicated file. The ACTIVATE and DEACTIVATE parameters allow you to change the replication status for a replicated file.
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.
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.
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:
Possible values: "ON", "OFF"
The parameter is optional when "ON" or "MODIFY" is specified.
The parameter has a default value of
"ON" when ADADBS REPLICATION ON is
specified.
The parameter is not allowed when ADADBS REPLICATION
OFF is specified.
For more information about how this parameter is used in Adabas database processing during replication, read Nucleus Processing.
The KEY parameter defines the primary key for replication. Following are rules for setting the KEY parameter:
The parameter is optional when "ON" or "MODIFY" is specified.
The parameter is not allowed when "OFF" is specified.
The parameter may not be specified when "OFF" or NOKEY is specified.
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.
The NOKEY parameter removes the primary key setting when MODIFY is specified. Following are rules for setting the NOKEY parameter:
The parameter is not allowed when "OFF" is specified.
The parameter is the default setting when "ON" is specified and neither NOKEY nor KEY is specified.
The parameter may not be specified when KEY is specified.
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.
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
The ADADBS REPTOR function provides activation and deactivation control of Event Replicator database processing. This function should be used with Event Replicator databases; it is not valid with other Adabas databases.
This section covers the following topics:
One of the parameters, ACTIVATE, DEACTIVATE, OPEN, or CLOSE must be set. There is no default. Each parameter is described below:
ACTIVATE requests activation for the specified file, database ID, destination, or subscription.
DEACTIVATE requests deactivation for the specified file, database ID, destination, or subscription.
OPEN requests that an unavailable destination or input queue be opened. When this parameter is specified, either the DESTINATION or IQUEUE parameter must be specified.
CLOSE requests that an available destination or input queue be closed. When this parameter is specified, either the DESTINATION or IQUEUE parameter must be specified.
The DBID parameter, when specified without the FILE parameter, will activate replication for any inactive files or deactivate replication for any active files for a given DBID. When specified with the FILE parameter, the DBID parameter identifies the database in which the file specified by the FILE parameter resides.
The DBID parameter is mutually exclusive with the DESTINATION, IQUEUE, and SUBSCRIPTION parameters.
The DESTINATION parameter can only be specified when the ACTIVATE, DEACTIVATE, OPEN, or CLOSE parameters are specified. The DESTINATION parameter supplies the name of the destination that should be activated, deactivated, opened, or closed. The destination specified must be defined to the Event Replicator Server.
If "ACTIVATE" is specified, the destination must already be inactive; if "DEACTIVATE" is specified, the destination must already be activated.
If "OPEN" is specified, the destination must be in an unavailable state; if "CLOSE" is specified, the destination must be in an available state.
The DESTINATION parameter is mutually exclusive with the DBID, FILE, IQUEUE, and SUBSCRIPTION parameters.
The FILE parameter will activate or deactivate replication for a single file in a specific database. A corresponding DBID parameter must also be specified.
If "ACTIVATE" is specified, the file must already be deactivated; if "DEACTIVATE" is specified, the file must already be activated.
The FILE parameter is mutually exclusive with the DESTINATION, IQUEUE, and SUBSCRIPTION parameters.
The IQUEUE parameter can only be specified when the OPEN or CLOSE parameters are specified. It supplies the name of the input queue (IQUEUE) that should be opened or closed and must be defined to the Event Replicator Server.
If "OPEN" is specified, the input queue must be in an unavailable state; if "CLOSE" is specified, the input queue must be in an available state.
The IQUEUE parameter is mutually exclusive with the DBID, DESTINATION, FILE, and SUBSCRIPTION parameters.
The subscription specified for the SUBSCRIPTION parameter must be defined to the Event Replicator Server. It specifies the name of the subscription definition to use.
If "ACTIVATE" is specified, the subscription must already be deactivated. If "DEACTIVATE" is specified, the subscription must already be activated.
The SUBSCRIPTION parameter is mutually exclusive with the DBID, FILE, IQUEUE, and DESTINATION parameters.
The following example requests that the Event Replicator Server activate all inactive files for database 232.
ADADBS REPTOR ACTIVATE,DBID=232
The following example requests that the Event Replicator Server activate file 2 on database 232. The file is currently inactive.
ADADBS REPTOR ACTIVATE,DBID=232,FILE=2
The following example requests that the Event Replicator Server activate the destination defined by the DEST0001 destination. The destination is currently inactive.
ADADBS REPTOR ACTIVATE,DESTINATION=DEST0001
The following example requests that the Event Replicator Server activate the subscription defined by the SUBS0001 subscription. The subscription is currently inactive.
ADADBS REPTOR ACTIVATE,SUBSCRIPTION=SUBS0001
The following example requests that the Event Replicator Server deactivate all active files for database 232.
ADADBS REPTOR DEACTIVATE,DBID=232
The following example requests that the Event Replicator Server deactivate file 2 on database 232. The file is currently active.
ADADBS REPTOR DEACTIVATE,DBID=232,FILE=2
The following example requests that the Event Replicator Server deactivate the destination defined by the DEST0001 destination. The destination is currently active.
ADADBS REPTOR DEACTIVATE,DESTINATION=DEST0001
The following example requests that the Event Replicator Server deactivate the subscription defined by the SUBS0001 subscription. The subscription is currently active.
ADADBS REPTOR DEACTIVATE,SUBSCRIPTION=SUBS0001
The following example requests that Event Replicator Server open (restart) destination DEST0001. Each output task will be asked to process the destination if that output task does not already have the destination open for processing.
ADADBS REPTOR OPEN,DESTINATION=DEST0001
The following example requests that Event Replicator Server close destination DEST0001. Each output task will be asked to close the destination if that output task does not already have the destination closed for processing.
ADADBS REPTOR CLOSE,DESTINATION=DEST0001
The following example requests that Event Replicator Server open (restart) input queue IQUEUE01. Each input task will be asked to open the input queue if that input task does not already have the input queue open for processing.
ADADBS REPTOR OPEN,IQUEUE=IQUEUE01
The following example requests that Event Replicator Server close input queue IQUEUE01. Each input task will be asked to close the input queue if that input task does not already have the input queue closed for processing.
ADADBS REPTOR CLOSE,IQUEUE=IQUEUE01
