Use the Listener Properties tab to set up the Pega Platform configuration options for the listener, including to which service rule it routes the JMS messages from the queue or topic it monitors.
|Service package||Use the Service package, Service class, and Service method fields to identify which JMS service rules ( Rule-Service-JMS ) are to process the messages this listener retrieves. Use the Service package field to specify the first key part — the Customer Package Name — of the rule.|
Optional. Select the second key part —
— of one or more Service JMS rules within the package identified.
This listener ignores messages that reference other classes within the package.
If this field is blank, the listener uses the
Optional. Enter the third key part —
— of the Service JMS rule that will process the requests. This
listener ignores messages that reference other methods within the
If this field is
blank, the listener uses the
|Send error messages||
If this check box is selected, and a processing error occurs that is not
handled by a configured response message, the listener responds with a text message
that contains the error message.
Error messages can be sent only if the sender
of the message identified a Reply To queue in the
This option is disabled if you select
|Container-managed transaction||Select this check box to generate the MDB deployment descriptor with transaction attributes that cause message redelivery in the case of processing failure. This allows the Pega Platform service to re-process the message.|
|Requestor user id||Optional. If the service rule is to run as an authenticated user, specify the name of an Operator ID record to use for authentication.|
|Password||Optional, but required if an Operator ID is specified in the Requestor user id field. Enter the password for the operator specified in the Requestor user id field.|
The remote logging feature streams the contents of the Pega log file to the
LogFactor5 application installed on your workstation. For information about this
How to install and use remote logging.
To view only those log messages that are about the service rule this listener listens for, complete the fields in this section. Remember to start the LogFactor5 application on your workstation before updating this form to identify your workstation as a logger.
|Remote host||Optional. To use the remote logging feature, specify the server name of your workstation.|
|Port||Optional. To use the remote logging feature, specify the TCP/IP port number of the port where the log4j Socket Server applet listens. The default port is 8887.|