To get started using the Event Replicator Target Adapter:

1. Install the Event Replicator Target Adapter, as described in Installing the Event Replicator Target Adapter.

   Make sure you address any Event Replicator Target Adapter installation considerations provided for your relational database, as described in the Event Replicator Target Adapter installation documentation.

2. Set up the preferences in the Administration tool so that you can specify target, target option, and source definitions for Event Replicator Target Adapter processing. These preferences identify, among other things, the location of the context.xml file used to store the Event Replicator Target Adapter definitions, the locations of the Event Replicator Target Adapter startup and shutdown commands, and the location of the Event Replicator Target Adapter log files.

   Warning: We do not recommend that you alter Event Replicator Target Adapter definitions in the context.xml file using a text editor or any other editor other than the Event Replicator Target Adapter Administration tool. If you do, errors may result.

   For more information, read Setting Configuration File and Preferences.

3. Use the Administration tool to configure the target definitions for your installation. Target definitions define the RDBMS data base or web service targets to which the Event Replicator Target Adapter should direct the replicated data. For more information, read Configuring Target Definitions for Event Replicator Target Adapter.

4. Use the Administration tool to set up any target database processing option definitions needed for Event Replicator Target Adapter processing. Target database processing option definitions specify options regarding how the Event Replicator Target Adapter processes the data submitted to the RDBMS data base and web service targets. For more information, read Specifying Target Database Processing Options

5. Use the Administration tool to configure the source definitions for your installation. Source definitions define the messaging system to be used (webMethods EntireX or WebSphere MQ) and associated target definition to use which the Event Replicator Target Adapter should direct the replicated data acquired from the source definition. For more information, read Configuring Source Definitions for Event Replicator Target Adapter.

6. Optionally, use the Administration tool to configure any filter definitions for Event Replicator Target Adapter processing. For more information, read Specifying Filter Definitions

7. Start the Event Replicator Target Adapter (if it is not already started), as described in Starting the Event Replicator Target Adapter.

8. Edit the Event Replicator subscriptions you want to use to transform and submit data to the Event Replicator Target Adapter. For each subscription, verify that:

   • A global format buffer (GFB) and field table (GFFT) are generated for at least one SFILE definition in the subscription. The GFB and field table must be generated either by Event Replicator for Adabas using Predict file definitions or using the Data Mapping Tool.

   • At least one destination definition used by the subscription specifies a value of "SAGTARG" for the Destination Class field (DCLASS parameter).

     Note:
     DCLASS=SAGTARG cannot be specified for Adabas or file destinations (DTYPE=ADABAS or FILE). It is only valid for webMethods EntireX, WebSphere MQ, or NULL destinations. When DCLASS=SAGTARG is specified, the ADARUN RPLPARMS parameter must be set to "FILE" or "BOTH" to provide access to any field table (GFFT) definitions.

   Be sure to save the subscription definitions and any destination definitions you modified.

   For more information on Event Replicator for Adabas subscription, SFILE, GFB, and destination definitions, read Definition Descriptions.

9. Activate the Event Replicator subscription and destination definitions. To activate subscription and destination definitions using Adabas Online System (AOS), read Managing Replication Definitions from AOS.