JBoss default messaging JMS Topic receiver
The JMS receiver does not have a backup topic. Therefore, you must configure two different services; one to listen on the primary topic and the other to listen on the backup topic. When an exception occurs, the receiver retries to use an exponential back off mechanism with a configurable maximum wait limit between retries.
For example, if 600 seconds is the maximum wait time, the receiver first waits for 1 second, then 2 seconds, 4, 8, 16, and so forth until it reaches 600 seconds, after which, the receiver retries every 600 seconds. Therefore, there is no boundary on the total wait time.
As JMS receivers operate independently of each other with respect to the primary and backup topics, the order of messages across these topics is not supported.
Configuration properties
The following are the configuration properties of this node:
| Property | Description |
|---|---|
| Runtime Tab | |
| Sub Service Name | Enter the name of the topic to which the message is sent. |
| Topic Name | Enter the name of the topic to which the message is sent. |
| Provider URL | Enter the JMS topic server provider URL of the JMS implementation to use for JNDI lookups. For the JBoss Default Messaging JMS Topic, enter the URL as: For clustered JMS
configurations, use a comma-separated value comprising the host/IP and port of each node in the
cluster. For example, for the JBoss Default Messaging JMS Topic, enter the URL as: |
| Initial Context Factory | The class name of the initial context factory. This is the starting point for the resolution
of names for naming and directory operations. Select JBoss if you are using JBoss Default Messaging JMS Topic. This sets the class name to
|
| Connection Factory | Enter the backup topic of the JMS server connection factory name. This is used to retrieve the connection factory from JNDI. A client uses a connection factory to create connections with a JMS provider. Enter any unique identifier for the connection factory. This name must be the same as the one configured in the JBoss administration console. |
| Receiving Mode | Indicates whether the messages are received in transactional mode or non-transactional mode.
Note: If the IsReprocessible flag is checked and an exception occurs when processing
the message, before deleting the message, ensure that it is added to the YFS_REPROCESS_ERROR or
YFS_INBOX table. However, if the "service suspend" exception occurs when adding deleted messages to
a table, the messages are maintained in the topic.
|
| Initial Threads | The thread count on a receiver controls the number of simultaneous consumers that exist for
the given destination. A message to a topic is broadcast to all consumers. Therefore, if the thread
count is 4, the same message is processed 4 times. To distribute workload, use a single thread on
the topic receiver, and put each received message into a queue. The queue can have multiple
consumers, because a message on a queue is delivered to only one consumer. The Initial Threads is defaulted to 1. |
| Selector | Enter selectors based on the message headers. These selectors must be in the form Header Name='Header Value'. When specifying a selector, use only single quotes. For example, using the selector APINAME='createOrder' selects all messages with the header name='APINAME' and the value='createOrder'. |
| Service to Execute on EOF Message | Required if the message contains an EOF message ID. Click the Search
icon to select the service to invoke when an EOF message is received. Once the EOF message is
received, the framework waits for a few minutes (configurable in the
|
| Root Node Name of EOF Message | If the message contains an EOF message ID, enter your custom root node name for the EOF
message. By default the EOF message has a root node of " |
| Enable JMS Security | Check this box if you want to enable JMS Security. When this box is selected, the JMS Security Properties tab is enabled for you to configure destination and/or JNDI based JMS security. |
| Create Durable Subscription | Check this box if you want the subscriber to be durable. A durable subscriber receives every message delivered to the topic whether the subscriber is running or not. |
| Server Tab | |
| Server Name | Select the name of the server that executes the service. For more information about creating a new server, see "Adding a New Server". |
| Needs Decompression | Check this box to indicate that the incoming message is compressed and needs to be decompressed. |
| Exception Tabs | See Table 1 for the receiver link exception handling properties. |
| Reconnect Tab | |
| Maximum Time Between Retries (milliseconds) | Enter the maximum time required between reconnection attempts. |
| JMS Security Properties Tab
This tab is enabled only when you check the Enable JMS Security box provided in the runtime tab. Note: You can override the JMS security properties specified here by defining the
agent and flow authorization parameters in the
|
|
| Destination based security | Check this box if you want to provide destination based security for JMS service. |
| JNDI based security | Check this box if you want to provide JNDI based security for JMS service. Note: This checkbox is not applicable for JBoss as it does not support JNDI
based JMS security.
|
| JMS Security Parameters For more information about application server-specific JMS security parameters, see "Setting up the JMS Security Properties" section. |
|
| Parameter Name | Enter the name of the security parameter. |
| Parameter Value | Enter the value of the security parameter. |
Connection properties
The following are the Generic JMS Topic node connection properties:
| Connection | Node Connection Rules |
|---|---|
| Can be the first node after the start node | Yes, for services invoked both in a synchronous or asynchronous mode. |
| Can be placed before |
|
| Can be placed after |
|
| Passes data unchanged | Transport nodes do not modify data. |