Skip to main content

This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRISOpens in a new window, see the InterSystems IRIS Migration Guide and Migrating to InterSystems IRIS, both available on the WRC Distributions pageOpens in a new window (login required).

Configuring and Using JMS Business Services and Operations

InterSystems products can be configured to be a JMS client by adding built-in business hosts to an interoperability production.

To enable an InterSystems product to receive JMS messages, add a new business service to the interoperability production, defining the service class of this business service as EnsLib.JMS.Service. This business service ignores any response.

To enable an InterSystems product to send JMS messages, add a new business operation to the interoperability production, defining the operation class of this business operation as EnsLib.JMS.Operation. This business operation returns a EnsLib.JMS.Response object back to the business host that sent the JMS message to the business operation.

Once you have added these business hosts to the production, configure the following settings on the Settings tab:

  • JMSCredentials — The credential defined for the username and password of the JMS server. For more information about creating a credential for the JMS username and password, see Defining Credentials.

  • JavaGatewayHost and JavaGatewayPort — The IP address and port of the Java Gateway that your production is using to enable JMS support. If you added the EnsLib.JavaGateway.Service business host to the production, use the IP address and port under its Basic Settings.

  • JMS Server — URL of the JMS server.

  • JMSFactory — Name of the QueueConnectionFactory.

  • JMSQueue — Name of the JMS Queue.

  • JMSClientID — Name that appears on the JMS Server’s list of active connections.

FeedbackOpens in a new window