Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Service JMS rules

Updated on April 6, 2022

The JMS integration interface supports interactions between your Pega Platform application and other systems through the Java Message Service (JMS). The Pega Platform supports JMS through both services and connectors. JMS services can receive (consume) messages from a JMS topic or queue and produce responses to those messages.

Note: Service JMS rules support JMS 1.0. Service JMS rules work with JMS 1.1, but only for JMS 1.0 features, for example, shared subscriptions, a JMS 1.1 feature, is not supported.

This facility supports both point-to-point and publish/subscribe messaging models. It supports durable subscriptions, automatic acknowledgment, and, if the Pega Platform is deployed as an enterprise application, transaction-based processing.

To provide a JMS service, your Pega Platform system must be able to function as a JMS client. So if the Pega Platform is deployed on a non-Java EE application server like Apache Tomcat, follow the vendor's documentation for that application server and configure the Pega Platform system as a JMS client.

JMS services generally process service requests synchronously. That is, they immediately perform their requested processing and return a configured response while the calling application waits. However, you can configure JMS services to process service requests asynchronously, which means the service queues the request for asynchronous execution and the calling application calls back later for the results. Additionally, you can configure synchronous JMS services to check for specific error conditions that you expect will be temporary — work item locks, for example — and then queue service requests that fail for those reasons for another attempt at a later time.


Use the Application Explorer to see Service JMS rules in your application. Use the Records Explorer to list all Service JMS rules that are available to you.


For a description of the development process, see the following Pega Community articles:

  • How to set up a JMS service
  • How asynchronous service processing works
  • Configure a service to process requests asynchronously
  • Configure a service that queues failed service requests for another attempt


Service JMS rules belong to the Integration-Services category. A Service JMS rule is an instance of the Rule-Service-JMS class.

  • Previous topic Unit testing a Service File rule
  • Next topic Service JMS rules - Completing the Create, Save As, or Specialization form

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us