This chapter explains the Databridge Server commands and the Databridge Twin commands.
Databridge Server Commands (Primary System)
Note that Databridge Server has a parameter file that you must configure. Refer to the Databridge Host Administrator’s Guide for information about configuring the DBServer parameter file.
Start Databridge Server
To start Databridge Server
Enter the following from CANDE or MARC under the usercode containing the Databridge software:
The WFL starts Databridge Server, which runs continuously.
Terminate Databridge Server
In most cases, you do not need to terminate Databridge Server.
To terminate Databridge Server
Enter the following from CANDE, MARC, or the ODT under the usercode containing the Databridge software:
mixnumber AX QUIT
where mixnumber is the task number of OBJECT/DATABRIDGE/SERVER.
Databridge Twin Commands
Databridge Twin includes the following commands, which are only applicable on the secondary system.
| Use this command | To do this | | CLONE | Replicate the primary database from the secondary system usercode that will contain the secondary database. For instructions, including syntax, see Clone Using the CLONE Command. | | LOAD | Replicate the primary database. For instructions, including syntax, see Clone Using the LOAD Command. | | LOCATION | Give Databridge Twin the audit location in the cloned database so that Databridge Twin can run in its normal tracking mode. (For the LOCATION command syntax, see Clone Using the LOCATION Command.) | | STATUS | Print a report of current audit file locations as indicated by the DBTWINCONTROL or restart data set. For syntax, see Start Databridge Twin. | | UPDATE or TRACK or empty | Cause Databridge Twin to perform normal tracking. Changes are then retrieved from the audit file and applied to the replicated database. For syntax, see Start Databridge Twin. |
Databridge Twin AX Commands
The following AX commands are available for Databridge Twin. Enter them on the secondary system.
||Terminates Databridge Twin at the end of the next transaction group.|
||Displays Databridge Twin’s location and timestamp in the primary database audit file, as well as the number of records replicated to the secondary database. See the following sample output.|
Use AX STATUS to view the current audit location and record counts. The line starting with Updates as the first word is the number of successful updates of each type. The line starting with Errors is the number of failed updates of each type.
mixnumber AX STATUS
where mixnumber is the task number of OBJECT/DATABRIDGE/TWIN
Sample Output for Databridge Twin AX STATUS Command
DBTwinEngine: Waiting for AFN 41 to become available. DBTwinEngine: Errors Create:0 Modify:0 Delete:0. DBTwinEngine: Updates Create:0 Modify:3 Delete:0. DBTwinEngine: Audit time: month day, year @ 16:42:52. DBTwinEngine: Audit location: AFN=40 ABSN=3552 (70%).
In this example, (
70%) means that 70 percent of audit file number (AFN) 40 has been processed.
Use AX QUIT to stop Databridge Twin. In most cases, terminating Databridge Twin is not necessary.
mixnumber AX QUIT
where mixnumber is the task number of OBJECT/DATABRIDGE/TWIN.