JMS Event Handler

Java Message Service (JMS) event handlers are used to trigger events or to collect information for reporting purposes.

Create New JMS Connection Factory

A JMS client uses a connection factory to connect to a JMS provider. Follow these directions to create a new JMS connection factory.
  1. From the JMS screen, click Commands > New Connection Factory. The Enter the Connection Factory details screen appears.
  2. In the Connection Factory Name field, type a unique name for the connection factory.
  3. In the JNDI Provider URL field, type the web address for the service provider. (JNDI is Java Naming and Directory Interface)
  4. In the JNDI Initial Context Factory field, type the initial context name.
  5. From the Deployment Id drop-down list, select an ID. This is optional.
  6. Click the Save button. The JMS screen appears with the connection factory listed.

Refresh Connection Factory

If you add information or the server is shut down, you need to refresh the connection factories. To refresh the factories, click Commands > Refresh. The connection factories are refreshed.

Add Destination

A destination object specifies the message target the the JMS client produces and the message source the JMS client receives. In Connect, the destination accepts a Request Queue and a Response Queue.

Follow these directions to create a destination.
  1. From the JMS screen, click Actions > Add Destination on the row with the connection factory you want. The Please enter the information for the requst and response queues screen appears.
  2. In the Destination Name field for the Request Queue and the Response Queue, type a unique name for each.
  3. In the Username field for each queue, type the appropirate user name.
  4. In the Password field for each queue, type the appropriate password.
  5. Click the Save button. The JMS screen appears.
To view the Destinations you added, click the arrow beside the appropriate connection factory. The row expands to display the destinations.

Edit Connection Factory

Follow these directions to edit a connection factory.
  1. From the JMS screen, click Actions > Edit on the row with the connection factory you want to edit. The Enter the Connection Factory details screen appears.
  2. Make your changes.
  3. Click the Save button. The JMS screen appears.

Delete Connection Factory

Follow these directions to delete a connection factory.
  1. From the JMS screen, click Actions > Delete on the row with the connection factory you want to delete. A confirmation dialog box appears.
  2. In the confirmation dialog box, click OK. The connection factory is removed from the list.
Note:

If a connection factory has destinations, you cannot delete the connection factory.

Edit Destination

Follow these directions to edit a destination.
  1. Click the arrow beside the appropriate connection factory. The row expands to display the destinations.
  2. Click Actions > Edit for the destination pair you want to edit. The Please enter the information for the request and response queues screen appears.
  3. Make your changes.
  4. Click the Save button. The JMS screen appears.

Delete Destination

Follow these directions to delete a destination.
  1. Click the arrow beside the appropriate connection factory. The row expands to display the destinations.
  2. Click Actions > Delete for the destination pair you want to delete. A confirmation dialog box appears.
  3. In the confirmation dialog box, click OK. The destination is removed.