Skip to main content

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

About JMS Listener data instances

Updated on April 6, 2022

JMS listeners provide the information needed to route Java Message Service (JMS) messages from a specific topic or queue to a JMS service rule. A JMS listener or JMS MDB listener data instance specifies which queue or topic contains the messages to be consumed and which JMS service rule(s) will process the messages.

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

The following tabs are available on this form:

Both JMS messaging domains are supported: publish-and-subscribe (including durable subscriptions) and point-to-point.

Listener types

JMS listeners can be implemented in one of two ways:

  • When your system is deployed as a Web application, the listener runs as a Java thread, created when the system starts. The listener waits for incoming messages on the JMS destination (queue or topic). At regular intervals (as specified on the listener form), the listener checks to see the system issued a request for it to stop running. If your system is deployed as a Web application, configure JMS listeners with this JMS Listener form.
  • When your system is deployed as an enterprise application, the listener is a message-driven bean (MDB) deployed inside your PegaRULES application. The MDB routes messages to the JMS service rule. If your system is deployed as an enterprise application, configure your JMS listeners with the JMS MDB Listener form ( Data-Admin-Connect-JMSMDBListener ). Use the form to configure the listener and to generate a fragment of the EJB deployment descriptor file that describes the MDB. Insert the fragment into the message-driven beans subsection of the EJB deployment descriptor file. For deployment instructions, see the Pega Community article How to deploy a JMS Listener as a message-driven bean.

For more information, see the Pega Community article Using MQ and JMS services with Enterprise Application deployment.


To review or create JMS Listener data instances, use the Records Explorer.


You can create a JMS Listener data instance with the Service Wizard when creating JMS service rules.


The Data-Admin-Connect-JMSListener class holds JMS Listener data instances. They are part of the Integration-Resources category.

  • Previous topic Configuring Pega Platform as a Java Messaging Service receiver
  • Next topic JMS Listener data instances - Completing the New or Save As 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