More about JMS Listener data instances
JMS listeners operations 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.
Three settings affect how email listener requestors 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 listener only if the prconfig.xml file or Dynamic System Settings 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 set to “false.”Pega 7 Platform provides four application-specific JMS properties that the sender can use to provide information about the messages that are consumed by Pega 7 Platform JMS services.
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 will consume the message.These 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, you specify the appropriate user on the JMS Properties tab of the JMS Listener form. Values provided in the message with the PegaRULES_UserID
and PegaRULES_Password
properties override the values specified on the JMS Properties tab.
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 Pega 7 Platform application-specific JMS 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 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 occurred, 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.
connector, prconfig.xml file, remote logging | |
About the System Management application About Service JMS rules How to install and use remote logging |