JMS Listener form
Completing the JMS Properties tab

Field

Description

Specify which messaging model to use: Publish-and-Subscribe or Point-to-Point.

Field

Description

To use resource references to identify the JMS resources, select Resource Reference. Otherwise, select Direct JNDI Lookup. See PDN article Configure a JMS service or connector to find JMS resources through resource references.

If you selected Direct JNDI Lookup in the Resource Name Resolution field, select the JNDI Server data instance that represents the server hosting the queue or topic specified below. PRPC connects to the JNDI server identified in that data instance to obtain JMS producer properties.

This field supports the Global Resource Settings syntax (=.PageName.PropertyName). The default property name for this field is pyJNDIServerName. For more information, see Using the Global Resource Settings feature.

Select or enter the name of the JMS Connection Factory. If you selected Resource Reference in the Resource Name Resolution field, the list shows the connection factory references from the PRPC deployment descriptor file. If you selected Direct JNDI Lookup, SmartPrompt is available if PRPC can connect to the JNDI server identified in the JNDI Server field. B-15953

For example:

weblogic.jms.XAConnectionFactory

Optional. If the Connection Factory is to connect to the topic or queue specified below as an authenticated user, enter the name of a valid user. B-13257

Optional, but required if a user name is specified in the Factory Username field. Enter the password for the user specified in the Factory Username field.

Optional. Select:

• Blank to send no acknowledgments.
• On Message Receipt to cause the listener to acknowledge an arriving message automatically when it receives a message, but before the service rule processes the message.
• After Message Processing to cause the listener to wait to acknowledge that it received a message until after the service processes the message. With this option, no acknowledgment is sent if an error occurs during message processing. TANDP 11/22/04

If the Topic or Queue Name field specifies a topic and the messaging domain is set to Publish and Subscribe, select to indicate that the listener is a durable subscriber.

A local message is one whose client ID identifies it as being posted to the queue by the services specified in the Service Package, Service Class, and Service Method fields.

Select the No Local Messages option to specify that the listener will leave local messages on the queue. Clear this checkbox to specify that the listener will process all messages posted to the queue.

If a publisher and subscriber share a common client ID, messages from the publisher are considered to be local, too. In such a case, clear the No Local Messages option.

Field

Description

If the messaging domain is Publish-and-Subscribe, select or enter the JMS Topic object from which the listener will receive messages.
If the messaging domain is Point-to-Point, select or enter the JMS Queue object from which the listener will receive messages.

SmartPrompt is available if PRPC can connect to the JNDI server identified in the JNDI Server field. B-15953 BUG-4518

This field supports the Global Resource Settings syntax (=.PageName.PropertyName). The default property name for this field is pyRequestDestination. For more information, see Using the Global Resource Settings feature.

Click to display a list of JMS messages, add a message, or remove a message. GRP-315

Optional. To filter messages, enter a JMS selection expression. A message selector is a string whose syntax is based on a subset of the SQL 92 conditional expression syntax.

For details and examples, see the JavaDocs topics for the Java class named javax.jms.Message.

Field

Description

Determines whether this listener, or the incoming messages, provide the identity of the response destination:

• Message (default) indicates that the listener is to use the response destination information from the ReplyTo headers of the incoming messages.
• Listener indicates that the listener is to use the destination specified in the Response Destination Name field, below.
• No Reply indicates that the listener does not send any response, including error messages. Selecting "No Reply" disables the Send Error Messages checkbox on the Listener Properties tab. Proj-1465 5.4SP2

If the Preference field is set to Listener and this listener is to send responses, specify the destination of the response. If the messaging domain is Publish-and-Subscribe, select the JMS Topic object from which messages are to be received. If the messaging domain is Point-to-Point, select the JMS Queue object from which messages are to be received.

This field supports the Global Resource Settings syntax (=.PageName.PropertyName). The default property name for this field is pyResponseDestination. For more information, see Using the Global Resource Settings feature.

This field is not available if you selected No Reply for the Preference field.

Click to display a list of JMS messages, add a message, or remove a message. GRP-315

03-04 C-605 R-7933After you save the JMS Listener form, click Test Connectivity to test whether PRPC can connect to the server identified by the JNDI Server data instance selected in the JNDI Server field above.

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.

If this PRPC system is not correctly configured as a JMS client, a Java exception appears when you click this button. SOLOM 02/18/04

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