Adding a JMS connection (UNIX and Linux®)

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. Enter 2 to add a JMS connection.
  2. Enter a unique JMS connection name.
  3. Decide on the type of message destination to which you want CDC Replication to send your messages:
    Option Description
    Q Enter Q if you want to send your messages to a queue.
    T Enter T if you want to send your messages to a topic.
  4. Enter a description for the JMS connection.
  5. Enter the remote JMS connection factory name. For example, jms/ConnectionFactory. 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 this to create a connection with your JMS provider.
  6. 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. Enter the user name to authenticate to the JMS server. This user name is defined by your JMS provider. Contact your system administrator for more information.
  7. Enter the password to authenticate to the JMS server.
  8. Enter the constant that holds the remote connection factory name. Java™ Naming and Directory Interface (JNDI) is a programming interface from IBM® WebSphere® MQ for connecting Java programs to naming and directory services. For example, com.sun.jndi.fscontext.RefFSContextFactory.
  9. Enter the URL that is relative to the JNDI Initial Context. 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.

Results

  • To verify that your JMS connection was added, enter 1 to list the current third party libraries.
  • Enter 2 to proceed to configure JMS destinations for the CDC Replication Engine for Event Server.