JMS Listener form
Completing the Listener Properties tab

Field

Description

Select to control how listeners start: 5.5 GRP-308

• Run on all nodes — The listener is run on all nodes — all servers in a cluster.
• Node based startup — The listener is started only on specified nodes.
• Host based startup — The listener is started on a specified number of nodes on specific servers within the cluster.

Appears when the Node based startup option is selected. In a multinode PRPC cluster, using the SmartPrompt, enter the node ID of the server host node or nodes where this listener will run. When a PRPC server starts it activates the listener on the current node if the current node matches any node in the list (and if other requirements are met).

• If a node is specified, the current node must match a name in the list for PRPC to activate the listener.
• If a node is not specified, PRPC activates the listener on each node.

When multiple JMS listeners tend the same directory, the order in which messages are processed may not be the order in which they were put into the directory. If your application relies on processing messages in the order in which they are sent, use a single listener on one node.

See More about JMS Listeners. C-759

Appears when the Server based startup option is selected. Enter the network location name of the host server on which the listener is to start.

Appears when the Server based startup option is selected. Enter a number of nodes on which the listener is to start.

Deletes all the instances from the class Log-Connect-AssignedNodes, so that listeners can be started.

Field

Description

Select the first key part — Customer Package Name — of the set of Service JMS rules (Rule-Service-JMS rule type) that are to process arriving JMS messages. This listener ignores messages referencing other packages. B-19482 Rejected

Optional. Select the second key part — Customer Class Name — 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 PegaRULES_ServiceClass property in the request message as the second key part. R-20489

Optional. Enter the third key part — Customer Method Name — of the Service JMS rule that will process the requests. This listener ignores messages that reference other methods within the Service Class and Service Package.

If this field is blank, the listener uses the PegaRULES_ServiceMethod property in the request message as the third key part. C-759

R-10353 Identify the number of threads per server node that this listener creates when it starts. C-759

Enter an interval in seconds to specify how often the listener pauses to determine whether to stop. Enter zero if the listener is never to pause to determine whether it stops. HITZM WANGD 7/17/05 B-14606

TANDP 6/11/03 If selected, and a processing error occurs that is not handled by a configured response message, the listener sends or publishes an empty message that contains the error message in a PRPC application-specific JMS property.

Error messages can be sent only if the client application has set the JMSReplyTo header value in the request message. They are sent to the reply queue specified in that field.

This option is disabled if you select No Reply as the Preference on the JMS Properties tab. Proj-1465 5.4SP2

Used only for the condition described in PDN article Using MQ and JMS services with Enterprise Application deployment.

03-04 C-605 R-7933 Optional. After you complete this tab and save the data instance, click to confirm that PRPC can connect to the JMS Producer Model data instance identified.

C-1704The system presents test results in a separate window, identifying the parameters used in the test, the steps attempted, and the outcome of each step. (This capability is available only when JMS JAR libraries are installed on the current node. If not, a Java exception is thrown.) SOLOM 02/18/04

(If the Blocked checkbox is selected when you click this button, testing ends with a Failed message.) SOLOM B-17285 1/26/05

Field

Description

Optional. Identify an Operator ID data instance that service requestors are to use, unless they can operate as unauthenticated guest requestors.

Optional. Enter a password for the service requestor.

The remote logging feature streams the contents of the Pega log file to the LogFactor5 application installed on your workstation.

After you add your workstation as an active logger through the Logging and Tracing > Remote Logging menu item in the System Management application, your workstation receives all messages for all processes running on the server. 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.

R-10355 R-10427 C-606 0401 Optional. You can debug the listener using the remote logging feature. Enter the name of your workstation. See also How to install and use remote logging

Optional. Enter the TCP/IP port that the log4j package on your workstation listens on. By default this port is 8887.

C-407 LACOD 6/18/03 Select to prevent this listener from being started by any means. If cleared, this listener starts with system startup, or can be started using the Listener Management menu item in the System Management application. 04-02 revised See More about JMS Listeners.