Adding a JMS connection (Windows)

You can create a JMS connection and add a message destination (queue or topic).

Before you begin

This task is optional when configuring the CDC Replication Engine for Event Server. Complete these steps only if you want to build an XML message using columns from outside of your current database table. The CDC Replication Engine for Event Server connects to the table using JDBC.

Procedure

  1. Launch the configuration tool at the command prompt by issuing the following command in the specified directory: 
    \<CDC Replication installation directory>\bin\dmconfigurets.exe
  2. Ensure you have stopped the CDC Replication Engine for Event Server service.
  3. Ensure you have added the correct JAR file so that the XML message is sent to the appropriate queue or topic. You can add third party libraries in the Environment tab.
  4. Select an existing CDC Replication Engine for Event Server instance that you have added and click Edit.
  5. Click the Message Destinations tab.
  6. Click Add Connection.
  7. Click the JMS Server tab.
  8. Enter the name that you want to give to the connection in the JMS Connection box. The name of the connection must be unique for the replication agent.
  9. Choose Queue or Topic from the Destination Type list.
  10. Enter a description for the connection in the Description box.
  11. Enter the name of the remote connection factory in the Remote JMS Connection Factory Name box. A connection factory encapsulates a set of connection configuration parameters that has been defined by an administrator. The CDC Replication Engine for Event Server uses it to create a connection with your JMS provider.
  12. If the JMS server to which you want to connect requires authentication, then you need to provide the user name and password to connect to that system in the JMS Server Authentication area.
    Option Description
    User Name Enter the user name to access the queue or the topic. This user name is defined by your JMS provider. Contact your system administrator for more information.
    Password/Confirm Password Enter and confirm the password associated with the user name.
  13. Click the JNDI Server tab.
  14. Enter the constant that holds the local or remote connection factory name and in the JNDI Initial Context box. Java™ Naming and Directory Interface (JNDI) is a programming interface from Sun for connecting Java programs to naming and directory services.
  15. Enter the URL that is relative to the JNDI initial context in the JNDI URL box. In JNDI, all naming and directory operations are performed relative to a context. Therefore the JNDI defines an initial context that serves as a starting point for naming and directory operations. This value should be the fully-qualified class name of the factory class that will create the initial context.
  16. If the JNDI server to which you want to connect requires authentication, then you need to provide the user name and password to connect to that system.
    Option Description
    Principal (User Name) Enter the JNDI user name used to access the JNDI resources. Contact your system administrator for information about the user name that you should specify.
    Credentials (Password)/Confirm Password Enter and confirm the password associated with the user name.
  17. Click OK to save the connection.
  18. Click OK to update your CDC Replication Engine for Event Server instance.