JMS MDB Listener form
Completing the JMS Properties tab

Field

Description

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

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.

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

Configure the fields in this section only if the messages delivered by this listener will have a queue or topic specified in their JMSReplyTo header fields. In that case, use these fields to specify the server to which to send the reply.

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.

To use resource references to identify the Reply To queue or topic, select Resource Reference. Otherwise, select Direct JNDI Lookup. See the PDN article 25070 How to configure a JMS service or connector to find JMS resources through resource references for information about this choice.

If you selected Direct JNDI Lookup in the Resource Name Resolution field, select the JNDI server data instance (Data-Admin-Connect-JNDIServer) that will create a reply connection if the JMSReplyTo header of the received message has a value.

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 for the reply connection. For example:

weblogic.jms.XAConnectionFactory

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

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.

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

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

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

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.

Click the magnifying glass icon to display a list of JMS messages, add a message, or remove a message.

After you save the listener, 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.

The system presents test results in a separate window, identifying the parameters used in the test, the steps attempted, and the outcome of each step.

Click to generate an updated EJB deployment descriptor file that contains the descriptor fragment for this listener. PRPC outputs the descriptor file to the ServiceExport directory.

If PRPC cannot generate the descriptor file, clicking  Update Deployment Descriptor   instead generates an EJB deployment descriptor fragment for the listener. The fragment is then available from a hyperlink added to the rule. This can occur if:

• Your deployment does not support use of a descriptor file, or
• The descriptor file already includes a fragment for this listener.

After you generate the descriptor file or fragment, obtain the output file and then follow the instructions in the PDN article 25415 How to deploy a JMS Listener as a message-driven bean (MDB).