Scenario: Notifying a User after an Adabas Database Record is Updated

Scenario: I have a mainframe Adabas database and want to notify a user when a record is updated.

Solution: Use the Event Replicator for Adabas to send a message to the webMethods Integration Server via Direct RPC, and use Integration Server logic to send an email to the target user.

graphics/ars-scenarios-direct-steps.png

graphics/blue_1.gif Event Replicator for Adabas listens for specific actions on the database.
graphics/blue_2.gif Event Replicator for Adabas sends an XML message to Integration Server via Direct RPC of Integration Server
graphics/blue_3.gif The EntireX Adapter listens to the respective message queue and triggers an IS service to send the email.

This scenario requires the following Software AG products:

  • Mainframe Adabas

  • Event Replicator for Adabas

  • webMethods Integration Server

  • EntireX Adapter

This scenario consists of the following steps:


Step 1 - Configure your Integration Server

This section covers the following topics:

Check the EntireX Adapter Package is Available

Before you begin, ensure that the EntireX Adapter package is available on the webMethods Integration Server.

Start of instruction setTo ensure that the EntireX Adapter package is available on the webMethods Integration Server

  1. In the webMethods Integration Server Administration interface, go to Packages > Management.

  2. Click on WmEntireX for details. A screen similar to this should be displayed (extract):

    graphics/ars-scenarios-direct-config-check.png

Enable Autostart (Optional)

We recommended enable the autostart option of the EntireX Adapter in the webMethods Integration Server; the EntireX Adapter is then launched automatically when the Integration Server starts up.

Start of instruction setTo enable the EntireX autostart option

  1. In the webMethods Integration Server Administration interface go to EntireX Adapter > Direct RPC Administration.

    graphics/ars-scenarios-direct-config-auto.png

  2. In the Configuration menu go to the Auto Start option and check whether it is set to Enabled. If it is not yet enabled, click on Enable.

Creating an Adabas Replication Direct Listener Connection

Start of instruction setTo create an Adabas Replication Listener Connection

  1. In the EntireX Adapter menu go to Connections. Click on Adabas Replication Listener Connection to display the following screen:

    graphics/ars-scenarios-direct-config-listener.png

  2. Add the name of the package where the connection is stored.

  3. Add the name of the folder where the connection is stored.

  4. Add the name of the connection.

  5. Add the server address in the format <class>/<server>/<service>.

    Note:
    All other parameters are optional. Normally you can use the default values for these. All parameters are described here.

  6. Click on Save Connection.

In the next step, create a listener for this connection, using the Adabas Replication Wizard.

Step 2 - Create Listener Objects with the Adabas Replication Wizard

Start of instruction setTo generate a listener and all required objects for an existing connection

  1. In the webMethods Integration Server, choose Adapters > EntireX Adapter > Listener and make sure the listener you created in the previous step is enabled.

    graphics/ars-scenarios-direct-create-enable.png

  2. In the Integration Server, choose EntireX Adapter > Adabas Replication Wizard.

    graphics/ars-scenarios-direct-create.png

  3. Select the connection you created previously.

  4. Enter the name of the new listener.

  5. Choose Create.

    The listener will be stored in the same location as the connection.

Note:
Document types can be optionally created to restrict the scope of the listening operation. See Create Document Type from Adabas File.