Adding and configuring connections
When you first add the correlator-integrated messaging for JMS bundle to an Apama project, the list of connections is initially empty. You can add one or more connection to JMS providers.
To establish a connection to a JMS broker
1. In the Project Explorer, expand the project's Adapters node and then expand the JMS Correlator-Integrated Adapter node.
2. Double-click the adapter's instance. This opens the instance's configuration in the editor for the correlator-integrated adapter for JMS.
3. In the adapter editor's Settings tab, click the Add Connection button (
) to display the JMS Configuration wizard. 4. In the JMS Configuration wizard, specify the following:
a. JMS Provider, select from the drop-down list.
b. Connection ID must be unique. The Connection ID is used throughout the configuration files and Apama application to identify this broker connection. The value for the Connection ID should not contain any spaces. The Connection ID is used when sending JMS messages from the Apama application. This Apama connection identifier is not exposed to the JMS provider in any way.
c. Description is optional and currently unused.
5. Click Next.
6. The Classpath details of the JMS Configuration wizard displays the default classpath details for the JMS Provider that you selected in the previous step. Add or modify the values as appropriate for your environment.
To add or modify the Classpath details:
a. The Select Installation Directory field lists the default directory where the JMS provider's JAR files are located. You can change this directory by clicking the Browse button (...).
b. To add an entry to the CLASSPATH, click the Add Classpath button (+) and add the new value in the Add Classpath Variable dialog. You can also remove an entry by selecting it and clicking the Remove Classpath button (x).
7. Click Next to proceed to the Connection Properties page of the JMS Configuration wizard. If necessary, add or modify the values as appropriate.
a. By default, the JMS Connection uses JNDI, which is the recommended option. Clear Use JNDI if your application does not use JNDI and your JMS provider supports non-JNDI instantiation of the ConnectionFactory class (note that many providers do not).
b. By default, the JMS Configuration wizard lists a subset of standard connection properties. If Use JNDI is enabled, the Connection details field shows JNDI Environment properties. If Use JNDI is not enabled, the connection details field shows ConnectionFactory properties. To show the complete list of properties add a check to the Show advanced properties check box.
c. You can add and remove properties and you can modify the properties' values. To modify a value, click in the Value column and enter the required information.
8. Click Finish.
The adapter editor is updated to display the new connection in the JMS Connections section.
After you establish a connection to a JMS broker, you need to add JMS receivers and specify mapping configurations for receivers and senders.