JMS Connector > Mappings for JMS > JMS sources in mappings
  

JMS sources in mappings

To read data from JMS, configure a JMS object as the Source transformation in a mapping.
Specify the name and description of the JMS source. Configure the source and advanced properties for the source object.
The following table describes the source properties that you can configure for a JMS source:
Property
Description
Connection
Name of the source connection.
You can select an existing connection, create a new connection, or define parameter values for the source connection property.
If you want to overwrite the source connection properties at runtime, select the Allow parameter to be overridden at run time option.
Specify the parameter file directory and name in the advanced session properties.
Source Type
Type of the source object.
Select one of the following source types:
  • - Single Object
  • - Parameter
Default is Single Object.
Object
Name of the JMS source object type.
Select a JMS queue or topic from the list. Specify the name of the JMS queue or topic in the JMS Destination advanced source property.
Parameter
A placeholder to dynamically assign values at run time for the source object without the requirement to edit the task.
Select an existing parameter for the source object or click New Parameter to define a new parameter for the source object.
The Parameter property appears only if you select parameter as the source type.
If you want to overwrite the parameter at runtime, select the Allow parameter to be overridden at run time option.
The following table describes the advanced source properties that you can configure for a JMS source:
Property
Description
Stop Session
Stops session if multiple retries yield no new data and some data is already received.
If you clear this check box, JMS Connector continues polling the JMS provider for new data.
JMS Destination
The name of the JMS queue or topic on the JMS provider from where you receive JMS messages.
Client ID
The client identifier used to identify and set up a JMS connection.
Durable Subscription Name
Applicable only to JMS topics.
The unique string identifier for a durable subscriber that allows the subscriber to receive messages from a JMS topic even if the subscriber is inactive.
To create a durable subscriber, you need to configure both the client ID and durable subscription name.
JMS Message Selector
Filters messages from a topic or queue based on the criteria defined in the message header fields or properties.
Tracing Level
Determines the amount of detail that appears in the log file.
Select one of the following options:
  • - Terse
  • - Normal
  • - Verbose Initialization
  • - Verbose Data
Default is Normal.

Configure a mapping to read data from JMS in real-time

You can configure a mapping to read data from a JMS topic in real-time.
To read data from a JMS topic in real-time, perform the following tasks:
  1. 1In the JMS advanced source properties, clear the Stop Session check box.
  2. 2Enable message recovery in the Advanced Session Properties section on the Runtime Options tab of the mapping task.
    3. For more information about how to configure the message recovery, see Configure message recovery strategy for a JMS mapping.