JMS Listener form – Completing the JMS Properties tab
Use the JMS Properties tab to set up JMS configuration options for the listener, including the topic or queue and which messaging domain to use.
Messaging model
Field | Description |
---|---|
Messaging Model | Specify which messaging model to use: Publish-and-Subscribe
or Point-to-Point . |
Session
Field | Description |
---|---|
Resource Name Resolution |
To use resource references to identify the JMS resources, select
|
JNDI Server | 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. Your system
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 |
Connection Factory Name |
Select or enter the name of the JMS Connection Factory. If you selected
For example: 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. |
Factory Username | 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. |
Factory Password | 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. |
Acknowledgement | Optional. Select:
|
Durable Subscriber? | 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. |
No Local Messages | 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 check box 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. |
Request
Field | Description |
---|---|
Request Destination Name | 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 you can connect to the JNDI server identified in the JNDI Server field. This field supports the Global Resource Settings syntax (=
PageName.PropertyName ). The default property name for this
field is Click Message explorer to display a list of JMS messages, add a message, or remove a message. |
Message Selector | 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 Javadoc documentation for
the Java class named |
Response
Field | Description |
---|---|
Response | |
Preference | Determines whether this listener, or the incoming messages, provide the
identity of the response destination:
|
Response Destination Name | 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 This field is not available if you selected Click Message explorer to display a list of JMS messages, add a message, or remove a message. |
Test Connectivity | After you save the JMS Listener form, click Test
Connectivity to test whether your system 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. If this system is not correctly configured as a JMS client, a Java exception appears when you click this button. If the Blocked check box on the Listener Properties tab is selected when you click this button, testing ends with a Failed message. |