The operation of JMS listeners (not JMS MDB listeners) depend on whether Pega 7 Platform is deployed as an Enterprise application (EAR file) or a Web application (WAR file). See PDN article Using MQ and JMS Services with Enterprise Application deployment regarding EAR deployment and polling.
For an EAR deployment example, see PDN article How to deploy a JMS Listener as a Message-driven bean.
Two settings affect how JMS MDB listeners run. If your listener is not behaving the way you expect, examine the following:
initServices/initJMS — At startup, Pega 7 Platform starts execution of a JMS MDB listener only if the prconfig.xml file or Dynamic System Setting parameter initServices/initJMS is set to true. If you notice that your JMS listeners do not route messages, examine the setting to determine if the value is “false.”Node Based startup option is selected, ensure that the desired node is added to the list. If Host Based startup is selected, ensure that the desired host is added to the list. Pega 7 Platform provides four application-specific JMS properties that the sender can set to provide information about the messages consumed by Pega 7 Platform JMS services.
PegaRULES_ServiceMethod
This JMS property identifies the third key part of a JMS service rule. You can use this property in the following two ways:
PegaRULES_ServiceMethod property in the messages.PegaRULES_ServiceMethod property to identify which listener is to consume the message.PegaRULES_UserID and PegaRULES_Password
Two properties identify the user name and password of a valid user.
Typically, if the message-driven bean and the service rule are to run as an authenticated user, specify the appropriate user on the JMS Properties tab of the JMS MDB Listener form. Values provided in the message with the PegaRULES_UserID and PegaRULES_Password override the values specified on the JMS Properties tab.
PegaRULES_SessionID
When a JMS service sends a reply in response to a message, the listener uses this property to specify the ID of the session used by the requestor that processed the original message. If the sending application sends a reply in response to the service's response, it can use this property to specify that the same session be used to process this message. This mechanism allows the sending application and the JMS service to conduct stateful sessions.
When the service rule is configured to send a response, the listener adds property values for the following properties to the message:
PegaRULES_ServiceMethod. If the request message contained a value for this property, the response message echoes the input value.PegaRULES_SessionID. A text string that identifies the session used by the requestor that processed the message.PegaRULES_ServiceStatus. Specifies whether there were errors during the processing of the message. If errors occur, this property is set to false. Otherwise, it is set to true.PegaRULES_ErrorMessage. If the value of PegaRULES_ServiceStatus is set to false, this property contains the default, system-generated error message. Use the Response tab of the service rule if you want more information than the default error message to be sent in the response message.The listener also sets a value in the JMSCorrelationID message header. By default, this value is copied from the JMSMessageID field from the request message unless it is overridden in the data mapping on the Response tab of the service rule.