Striim 3.9.8 documentation

JMS Reader

Reads data using the JMS API 1.1.

See Supported reader-parser combinations) for parsing options.

property

type

default value

notes

Compression Type

java.lang.String

Set to gzip when the input is in gzip format. Otherwise, leave blank.

Connection Factory Name

java.lang.String

the name of the ConnectionFactory containing the queue or topic

Crash On Unsupported Message Type

java.lang.Boolean

True

With the default value of True, when JMSReader encounters a message of an unsupported type, the application will crash. Set to False to ignore such messages.

Ctx

java.lang.String

the JNDI initial context factory name

Durable Subscriber Name

java.lang.String

Leave blank to create a nondurable subscription. Specify a subscriber name to create a durable subscription.

Password

com.webaction. security.Password

see Encrypted passwords

Provider

java.lang.String

the path to the JNDI binding

Queue Name

java.lang.String

leave blank if Topic is specified

Topic

java.lang.String

leave blank if QueueName is specified

Transaction Policy

java.lang.String

Specify a message count and/or interval (s / m / h / d) to have the JMS broker group messages as transactions. This will ensure that all messages are processed by JMSReader before they are removed from the queue.

For example, with the settingTransactionPolicy='MessageCount:100, Interval:10s, JMSReader will send a commit message to the broker every ten seconds or sooner if it accumulates 100 messages. If JMSReader is stopped or crashes before sending a commit, the broker will resend the messages in the current transaction when JMSReader is restarted.

When using a transaction policy:

This feature has been tested with ActiveMQ and WebLogic.

User Name

java.lang.String

a messaging system user with the necessary permissions

The output type is WAevent except when using JSONParser.

The following example is for ActiveMQ:

CREATE SOURCE AMQSource USING JMSReader (
  ConnectionFactoryName:'jms/TestConnectionFactory'
  Ctx:'org.apache.activemq.jndi.ActiveMQInitialContextFactory',
  Provider:'tcp://192.168.123.200:61616',
  QueueName:'jms/TestJMSQueue',
  UserName:'striim',
  Password:'******'
) ...

Note that JMSReader's properties must accurately reflect your configuration. See Using JMSReader with IBM WebSphere MQ for a detailed discussion.

In this section: