Metamerge logo
Search

Advanced Search
*
*
*
* HOME DOCUMENTS & RESOURCES DOWNLOADS EARLY TECH ACCESS SUPPORT FAQ KNOWN ISSUES OLD VERSIONS
*

 

JMS Connector

(A newer version of this Connector is available see the See Also section below).

Overview

The JMS Connector provides access to a variety of JMS based systems. The current version has been tested with SonicMQ and FioranoMQ and IBM MQ Series.  

Refer to Specific topics to see what you might need to do to your Metamerge Installation in order to make the JMS Connector work. 

The Connector enables communication of both native Entry objects and XML text to be passed using a Java Message Server product.

The JMS Connector supports JMS message properties. Each message received by the JMS Connector will populate the conn object with properties from the JMS message (see the getProperty() and setProperty() methods of the entry class to access these). conn object properties are prefixed with "jms." followed by the JMS message property name. The property holds the value from the JMS message. When sending a message the user can set properties which will then be passed on to the JMS message sent. The JMS Connector will scan the conn object for properties that starts with "jms." and set the corresponding JMS message property from the conn property.

  • JMS: correlationID=12 ----> conn jms.correlationID=12
  • conn:jms.inReplyTo=12 ----> JMS:inReplyTo=12

The conn object is only available in a few hooks: See When is the conn object available under Attribute Mapping for where.

Configuration

The Connector needs the following parameters:

Parameter

Description

connectorType com.architech.connector.rscJMSConnector
jms.broker The URL for the JMS server (e.g. 
jms.username Username for authenticating access to the JMS
jms.password Password for authenticating access to the JMS
jms.topic The topic with which messages are exchanged.
jms.connectionID The connection ID if you share a username with other sessions.
jms.mode Specify subscriber or publisher.
Parser If specified, the Text message of a JMS message will be parsed using this Parser.
jms.driver Select the JMS server type
jms.autoAcknowledge If true, each message is automatically acknowledged by this Connector. If false, you must manually acknowledge the receipt of a JMS message.

Example

Demo package containing a ready to run configuration for the JMS Connector is included here. In addition you need a SonicMQ JMS server.

Specific Topics

Here are some files that you need to add to the Metamerge jars directory (or to the classpath)

JMS Implementation Files needed
Soniq MQ client.jar
Fiorano MQ fmprtl.zip (must to be added to classpath )
IBM MQ Series
com.ibm.mqjms.jar
com.ibm.mq.jar
jms.jar

Known Issues

Before version 4.6 a bug caused the IBM-MQ series Connector not to support topics.  You might want to check out the the See Also section for a newer (beta) version of the Connector.  If you want to stay with the old version, download IBM-MQ.jar and replace the one existing in your metamerge/jars/connectors directory.

See Also 

A newer version of this  Connector is about to be released.  Refer to Early Technology Access for more information on the new functionality.

 

*
  Metamerge Integrator version 4.6 ©Copyright Metamerge AS 2000-2002 Last edited 2002-06-10 contact us