Administration Version 2.6.1
 —  Using Event Replicator Administration  —

Controlling Connections to Adabas Databases

By default, Event Replicator for Adabas attempts to connect with any Adabas database encountered during an Event Replicator Server session. You may, however, prefer to control these connection attempts using an Adabas database connection definition. This document describes how to maintain these definitions using Event Replicator Administration.


Listing Adabas Database Connection Definitions

Start of instruction setTo list the connection definitions for Adabas databases in Event Replicator Administration:

  1. Select an Event Replicator Server in tree-view as described in Selecting Event Replicator Databases.

  2. Click and expand Replication Definitions in the tree-view under Replicators.

    A list of the Event Replicator definitions you can maintain in the Replication system file appears in tree-view.

  3. Click on Database IDs in the tree-view under Replication Definitions.

    A table listing the database IDs for which connection definitions have been defined appears in detail-view. This table lists the database IDs and whether or not they are connected to this Event Replicator.

Top of page

Adding a Connection Setting for an Adabas Database

Start of instruction setTo add a connection definition for an Adabas database:

  1. List the connection definitions in Event Replicator Administration, as described in Listing Adabas Database Connection Definitions.

    The destinations are listed in the Database IDs table in detail-view.

  2. Right-click on Database IDs in the tree-view under Replication Definitions.

    A drop-down menu appears.

  3. Click on Create New Database ID in the drop-down menu.

    A blank Database ID panel appears in detail-view.

  4. Fill in the fields in Value columns of the detail-view table as described below:

    Parameter Name Description Default
    Database ID (DATABASE ID) Specify the database ID of the Adabas database to which this connection definition applies. ---
    Connect at Replicator Startup(DBCONNECT) Specify whether or not the Event Replicator Server should initiate an attempt to connect to the Adabas database at Event Replicator Server startup. Valid values are "Yes" or "No".

    If you specify "Yes", the Event Replicator Server will initiate an attempt to connect to the Adabas database after the Event Replicator Server starts.

    If you specify "No", the Event Replicator Server will not initiate an attempt to connect to the Adabas database. The database may connect with the Event Replicator Server at some point, but the Event Replicator Server will not initiate the connection at Event Replicator Server startup.

    Yes
  5. Click OK key to save the connection definition and return to the Database IDs screen.

    The database connection definition is added.

Top of page

Modifying the Connection Definition for an Adabas Database

Start of instruction setTo modify a connection definition in the Event Replicator Administration:

  1. List the connection definitions in the Event Replicator Administration, as described in Listing Adabas Database Connection Definitions.

    The destinations are listed on the Database IDs screen.

  2. Locate the definition you want to modify in detail-view and click on the database ID.

    The Database ID panel appears in detail-view showing the definition.

  3. Click Modify.

    The Database ID panel refreshes, allowing you to change the connection information for this database. For information on modifying this screen, read the description of Adding a Connection Setting for an Adabas Database.

  4. When all modifications have been made, click OK to save the changes and return to the Database IDs screen.

Top of page

Copying the Connection Definition for an Adabas Database

Start of instruction setTo copy a connection definition in the Event Replicator Administration:

  1. List the connection definitions in the Event Replicator Administration, as described in Listing Adabas Database Connection Definitions.

    The destinations are listed on the Database IDs screen.

  2. Locate the definition you want to copy in detail-view and click on the database ID .

    The Database ID panel appears in detail-view showing the definition.

  3. Click Copy.

    The Database ID panel refreshes, allowing you to specify a new Adabas database ID for the new definition.

  4. Specify a new Adabas database ID for the copy of the definition and click OK.

    The connection definition is copied and the copy appears on the Database IDs screen.

Top of page

Activating and Deactivating Databases and Files

You can use Event Replicator Administration to activate and deactivate databases or individual files within a database.

Warning:
Be careful when you activate and deactivate replication definitions and databases, especially if replication is ongoing at the time. Whenever you activate or deactivate definitions or databases, you run the risk of altering what data is replicated and how that replication occurs. If the Event Replicator Server receives data from an Adabas database for which it has no active definitions, replication simply does not occur.

This section covers the following topics:

Activating Databases

Start of instruction setTo use Event Replicator Administration to activate a database:

  1. Select an Event Replicator Server in tree-view as described in Selecting Event Replicator Databases.

  2. Click and expand Active Parameters in tree-view under the selected database.

  3. Click and expand Replication in tree-view under Active Parameters.

  4. Click on Database IDs in the tree-view under Replication.

    A table listing the database connections in the Replicator system file appears in detail-view.

  5. In detail-view, click on the name of the database you want to activate.

    Details about the database appear in detail-view.

  6. To activate the entire database (including all files in the database), click on the Activate button in detail-view.

    The database and all of its files are activated.

Activating Files

Start of instruction setTo use Event Replicator Administration to activate an individual file:

  1. Select an Event Replicator Server in tree-view as described in Selecting Event Replicator Databases.

  2. Click and expand Active Parameters in tree-view under the selected database.

  3. Click and expand Replication in tree-view under Active Parameters.

  4. Click on Database IDs in the tree-view under Replication.

    A table listing the database connections in the Replicator system file appears in detail-view.

  5. In detail-view, click on the name of the database containing the file you want to activate.

    Details about the database appear in detail-view.

  6. Click on the Number of Files field name in detail-view.

    A list of the files in the database appears in detail-view

  7. Click the Activate button next to the file (or files) you want to activate.

    The file is activated.

Deactivating Databases

Start of instruction setTo use Event Replicator Administration to deactivate a database:

  1. Select an Event Replicator Server in tree-view as described in Selecting Event Replicator Databases.

  2. Click and expand Active Parameters in tree-view under the selected database.

  3. Click and expand Replication in tree-view under Active Parameters.

  4. Click on Database IDs in the tree-view under Replication.

    A table listing the database connections in the Replicator system file appears in detail-view.

  5. In detail-view, click on the name of the database you want to deactivate.

    Details about the database appear in detail-view.

  6. To deactivate the entire database (including all files in the database), click on the Deactivate button in detail-view.

    The database and all of its files are deactivated.

Deactivating Files

Start of instruction setTo use Event Replicator Administration to deactivate an individual file:

  1. Select an Event Replicator Server in tree-view as described in Selecting Event Replicator Databases.

  2. Click and expand Active Parameters in tree-view under the selected database.

  3. Click and expand Replication in tree-view under Active Parameters.

  4. Click on Database IDs in the tree-view under Replication.

    A table listing the database connections in the Replicator system file appears in detail-view.

  5. In detail-view, click on the name of the database containing the file you want to deactivate.

    Details about the database appear in detail-view.

  6. Click on the Number of Files field name in detail-view.

    A list of the files in the database appears in detail-view

  7. Click the Deactivate button next to the file (or files) you want to deactivate.

    The file is deactivated.

Top of page

Deleting the Connection Definition for an Adabas Database

Start of instruction setTo delete a connection definition in the Event Replicator Administration:

  1. List the connection definitions in the Event Replicator Administration, as described in Listing Adabas Database Connection Definitions.

    The destinations are listed on the Database IDs screen.

  2. Locate the definition you want to delete in detail-view and click on the database ID .

    The Database ID panel appears in detail-view showing the definition.

  3. Click Delete.

    A verification panel appears in detail-view

  4. Click OK to delete the definition or click No to stop the deletion.

    The definition is deleted if you clicked OK; otherwise it is not.

Top of page