Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

Unable to configure custom JMS MDB listener in JBoss EAP 6.x



Unable to configure a custom JMS MDB listener to receive messages from a remote HornetQ queue with name MY.CUSTOM.QUEUE in JBoss EAP 6.x

Error Messages

2017-05-19 13:32:10,939 INFO [] (service thread 1-15) JBAS014142: Started message driven bean 'MyCustomeMDBListener' with 'hornetq-ra' resource adapter
2017-05-19 13:32:11,083 INFO [org.hornetq.ra] (default-threads - 2) HQ151000: awaiting topic/queue creation java:jboss/jms/queue/MY.CUSTOM.QUEUE
2017-05-19 13:32:13,084 INFO [org.hornetq.ra] (default-threads - 2) HQ151001: Attempting to reconnect org.hornetq.ra.inflow.HornetQActivationSpec(ra=org.hornetq.ra.HornetQResourceAdapter@1f38386c destination=java:jboss/jms/queue/MY.CUSTOM.QUEUE destinationType=javax.jms.Queue ack=Auto-acknowledge durable=false clientID=null user=null maxSession=15)

Steps to Reproduce

  1. Configure the JMS MDB listener on JBoss EAP 6.x.
  2. After the deployment descriptors in the Pega 7 application’s prbeans.jar file are updated, redeploy and restart your Pega 7 application.
  3. Observe that messages in the remote queue are not being consumed

Root Cause

An environment configuration issue:
The MDB was unable to lookup the remote destination as, by being remote, it was not included in the local JNDI tree.
Issue is caused by lack of configuration details to properly identify the remote destination.
This is because a brand new MDB Listener, when configured in PRPC, expects just a destinationType and the destination property.

This, in case of a JBoss server, leads to the creation of the following changes to deployment descriptors:
  • in ejb-jar.xml:

  • in jboss-ejb3.xml:
In the snippets above the destination is identified by mean of a JNDI name. It’s up to the EJB Container to provide an instance of this JNDI entry.
This is a configuration task usually performed at deployment time by the application server that maps a physical resource to a
JNDI entry.
Each application server has its own ways to accomplish this task.

In JBoss EAP 6.x this task can be accomplished in different ways:
  • Provide extra activation-config-property entries in ejb-jar.xml for the custom MDB.
  • Define a remote netty-connector managed by the JEE container in the standalone(-full),xml configuration file then provide a resource-adapter-binding in the jboss-ejb3.xml to point to the name of the pooled-connection-factory resource
  • Define a JMS bridge in the message consumer to map remote destination to an existing local one then point the MDB to listen to the local destination
Which one to choose depends from the specific usage context.


Given a remote HornetQ queue is in use in this case make the following change to the ejb-jar.xml deployment descriptor:Add the following activation config properties to the activation-config element of the message-driven stanza for the custom MDB replacing <REMOTE_HOSTNAME> and <REMOTE_PORT> placeholders with the actual values of the remote HornetQ server:

Published June 16, 2017 - Updated October 8, 2020

Was this useful?

0% found this useful

Have a question? Get answers now.

Visit the Collaboration 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.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us