Overriding JMS message header properties

You can override the default JMS message header properties you had set for a source table to XML mapping in the XML Settings tab.

About this task

Depending on the JMS message property you want to override, the CDC Replication Engine for Event Server lets you specify parameters for the following methods in the EventServerIF interface:
  • setJmsCorrelationID()
  • setJmsCustomProperty()
  • setJmsDeliveryMode()
  • setJmsPriority()
  • setJmsReplyTo()
  • setJmsTimeToLive()
  • setJmsType()

For an example of a user exit that overrides the JMS properties of an existing source table to XML mapping, see SampleUserExit1.java located in the samples folder or directory of your installation of the CDC Replication Engine for Event Server.

Procedure

  1. Click Configuration > Datastores.

    Ensure that you are connected to a CDC Replication Engine for Event Server datastore.

  2. Click Configuration > Subscriptions.

    Ensure that you have created a subscription that uses the CDC Replication Engine for Event Server datastore as the target.

  3. Ensure that you have created at least one source table to XML message destination mapping within this subscription.
  4. Select the table mapping and right-click Open Details....
  5. Click the User Exits tab.
  6. Choose Java Class from the User Exit Type box.
  7. In the Class Name box, enter the Java™ class name of the user exit that implements the UserExitIF interface if you have developed the user exit in Java.
  8. Enter the parameters that you want to make available to the user exit program in the Parameter box.

    You can access the parameters in the Java class by invoking the getParameter() method during the initialization process. There are no conventions for specifying the parameters. The values you type in this box are free-form. The string of parameter values cannot exceed 255 characters in length.

  9. Enable the Before or After check box for one or more of the following operations:
    Insert
    The CDC Replication Engine for Event Server runs the user exit before or after applying an insert operation to a table you have staged, before or after applying an insert operation to a JMS message destination, or both.
    Update
    The CDC Replication Engine for Event Server runs the user exit before or after applying an update operation to a table you have staged, before or after applying an update operation to a JMS message destination, or both.
    Delete
    The CDC Replication Engine for Event Server runs the user exit before or after applying a delete operation to a table you have staged, before or after applying a delete operation to a JMS message destination, or both.
    Refresh
    The CDC Replication Engine for Event Server runs the user exit before or after applying a refresh operation to a table you have staged, before or after applying a refresh operation to a JMS message destination, or both.
    Truncate
    The CDC Replication Engine for Event Server runs the user exit before or after applying a truncate operation to a table you have staged, before or after applying a truncate operation to a JMS message destination, or both.