Skip to main content

This is documentation for Caché and Ensemble. See the InterSystems IRIS version of this content.Opens in a new tab

Please read this important announcement about the future of Caché and Ensemble maintenanceOpens in a new tab. Contact your account team to migrate to InterSystems IRIS.

JMS Overview

The Java Messaging Service (JMS) is a Java messaging framework for providing communication between two or more systems. In this framework, a JMS provider manages a queue of messages sent by JMS clients. A typical JMS message has the following path:

  1. A JMS client sends the message to a JMS provider.

  2. The JMS provider sends the message to another JMS client.

With interoperability productions, InterSystems products can be a JMS client that both sends and receives JMS messages. InterSystems JMS clients use the EnsLib.JMS.Operation business host to send messages to JMS providers and the EnsLib.JMS.Service business host to receive messages from JMS providers. Advanced users who are familiar with ObjectScript can create their own custom JMS business hosts rather than using these built-in components.

The JMS feature is available in Ensemble 2018.1.2 and later. For the release note related to this feature, see Caché & Ensemble Maintenance Release Changes (2018.1.2)Opens in a new tab.

JMS Messages

Within the JMS client’s interoperability production, the JMS messages are EnsLib.JMS.MessageOpens in a new tab objects. The text property of message object contains the message content. The type property of the message object specifies the message type such as TextMessage and BytesMessage. The EnsLib.JMS.Message class also provides methods for setting and retrieving properties of the message.

InterSystems Java Gateway

InterSystems’ support for JMS messaging relies on the InterSystems Java Gateway. The easiest way to set up the Java Gateway is to add the EnsLib.JavaGateway.Service business host to the JMS client’s interoperability production. Once added, the Java Gateway automatically starts when the production is started and stops when the production is stopped. For more information about the Java Gateway, see Using the Java Gateway.

Jar Files

The jar file for the JMS feature is available at: install-dir\dev\java\lib\JDK18\cache-enslib-jms-2.0.0

The following client development jar files are also available:

  • install-dir\dev\java\jms\wljmsclient.jar

  • install-dir\dev\java\jms\wlthint3client.jar

Next sectionConfiguring and Using JMS Business Services and Operations
Previous sectionAbout This Book
FeedbackOpens in a new tab