Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Property Name

Description

RequiredDefault Value

Common adapter parameters




jms.adaptor.ClientNames

A comma-delimited list of JMS endpoints.
A separate configuration section for each listed client should be specified.
Y

jms.adaptor.ConnectionNames

A comma-delimited list of TA connections.
A separate configuration section for each listed connection should be specified.
Y

Connections parameters

jms.adaptor.Connection.[ConnectionName].InitialContextFactory

JNDI option. The fully qualified class name of the factory class that will create the initial context. An initial context is the starting point for naming operations.

C, required if JNDI mechanism is used

jms.adaptor.Connection.[ConnectionName].ProviderURI

JMS provider URI that defines where the connection that is created will connect to, as well as the protocol that should be used, for example, TCP/IP. Additionally, configuration information can be encoded in the URI.Y

jms.adaptor.Connection.[ConnectionName].User

User nameY

jms.adaptor.Connection.[ConnectionName].Password

User passwordY

jms.adaptor.Connection.[ConnectionName].ConnectionFactory

JNDI option. The connection factory object name in the JNDI objects store.C, required if JNDI mechanism is used

jms.adaptor.Connection.[ConnectionName].Reconnect

Enables or disables the reconnect procedure for connection restore.

This parameter is used for JMS brokers that don't support the failover mechanism.

N

false

jms.adaptor.Connection.[ConnectionName].ReconnectTries

Number of reconnect tries or -1 for an infinite number of attemptsN3

jms.adaptor.Connection.[ConnectionName].ReconnectInterval

Fixed interval in milliseconds between reconnection attemptsN2000

Clients parameters

jms.adaptor.Client.[ClientName].ConnectionName

Name of the primary connection used by the client. The connection should be registered in the ConnectionNames enumeration and have all required parameters.Y

jms.adaptor.Client.[ClientName].StorageDir

Directory where the persistence file is stored in case of a communication problem.Y, if the persistent mode is enabled

jms.adaptor.Client.[ClientName].SessionType

Session type:

  • Producer - the session is a message producer
  • Consumer - the session is a message consumer
Y

jms.adaptor.Client.[ClientName].MessagingMode

Session messaging mode:

Queue - Point-To-Point. Each message is addressed to a specific queue, and receiving clients extract messages from the queue(s) established to hold their messages. Queues retain all messages sent to them until the messages are consumed or until the messages expire.

Topic - Publish/Subscribe. In a pub/sub product or application, clients address messages to a topic. Publishers and subscribers are generally anonymous and may dynamically publish or subscribe to the content hierarchy. The system takes care of distributing messages arriving from a topic’s multiple publishers to its multiple subscribers. Topics retain messages only as long as it takes to distribute them to current subscribers.
Y

jms.adaptor.Client.[ClientName].DestinationURI

URI of session destination (queue/topic name)Y

jms.adaptor.Client.[ClientName].DeliveryMode

Specifies whether the sent messages are lost if the JMS provider fails.

Persist - instructs the JMS provider to take extra care to ensure that a message is not lost in transit in case of a JMS provider failure. A message sent with this delivery mode is logged to stable storage when it is sent.

NoPersist - does not require the JMS provider to store the message or otherwise guarantee that it is not lost if the provider fails.

NOTE: used only for Producer sessions.

Y

jms.adaptor.JMSTA.Client.[ClientName].TimeToLive

This value defines a message expiration time (in milliseconds) that is the sum of the message's time-to-live and the GMT when it is sent. (For transacted sends, this is the time at which the client sends the message, not the time when the transaction is committed.) Setting the parameter value to "0" will lead to infinite TTL.Y3000

jms.adaptor.JMSTA.Client.[ClientName].SessionAckMode

Defines the mode in which the JMS session will acknowledge the messages that it receives and dispatches.

Auto - the session automatically acknowledges a client's receipt of a message either when the session has successfully returned from a call to receive or when the message listener the session has called to process the message successfully returns.

Client - the client acknowledges a consumed message by calling the message's acknowledge method. Acknowledging a consumed message acknowledges all messages that the session has consumed. When client acknowledgment mode is used, a client may build up a large number of unacknowledged messages while attempting to process them.

DupsOk - instructs the session to lazily acknowledge the delivery of messages. This is likely to result in the delivery of some duplicate messages if the JMS provider fails, so it should only be used by consumers that can tolerate duplicate messages. The use of this mode can reduce session overhead by minimizing the work the session does to prevent duplicates.

Y

jms.adaptor.JMSTA.Client.[ClientName].MessageType

JMS Message type used for the session.

Bytes - A stream of interpreted bytes. This message type is for literally encoding a body to match an existing message format.

Text - Data is stored as a string. This message type is useful for exchanging simple text messages and for more complex character data, such as XML documents.

Custom - The ability to use your own message type. This message type is useful for adaptation to already existing systems. For this message type, the property jms.adaptor.Client.[ClientName].CustomMessageType is required.

Y

jms.adaptor.Client.[ClientName].CustomMessageType

Class of custom message type implementation. This should be the implementation of one of the interfaces:
com.epam.fixengine.jms.client.consumer.IFromMessageConverter
com.epam.fixengine.jms.client.consumer.IToMessageConverter

NOTE: used only for Custom message type

Y, if MessageType is Custom

jms.adaptor.Client.[ClientName].Transacted

Determines whether the sending/consuming of messages in the session is transacted.

true - transacted.

false - not transacted. The value is used by default.

Nfalse

jms.adaptor.Client.[ClientName].TransactionBatchSize

Max number of messages for one transaction. Take the available number of messages from the queue but no more than the amount specified in this property.

NOTE: used only if transacted is enabled.

N20

jms.adaptor.Client.[ClientName].QueueSize

Max number of messages in the outgoing endpoint queue. Messages are queued until successfully sent. Waits for space to become available if the queue is full.N100

jms.adaptor.Client.[ClientName].QueuePersistent

Store messages in the file until committed. It allows to restore and send messages after a sudden cardiac application.

true – persistent queue.

false – in-memory queue. Faster but less safe; some messages may be lost after restart.
Ntrue

jms.adaptor.Client.[ClientName].QueueNormalFileSize

After reaching this size, the endpoint waits until the queue is empty to truncate the file. File size in Mbytes.

NOTE: used only for the persistent queue.

N10

jms.adaptor.Client.[ClientName].QueueMaxFileSize

After reaching this size, the endpoint truncates the file and overwrites the messages that are queued. File size in Mbytes.

NOTE: used only for the persistent queue.

N50

jms.adaptor.Client.[ClientName].DurableSubscription

Durable topic subscriptions allow receiving messages published while the subscriber is not active. Durable subscriptions offer the reliability of queues to the publish/subscribe message domain.

true - Subscription is durable.

false - Subscription is not durable.

NOTE:

  • used only for Consumer sessions.
  • checks that the Producer sends messages using persistent delivery mode.
Nfalse

jms.adaptor.Client.[ClientName].DurableSubscriptionName

Durable subscription name.Y, required if DurableSubscription set to true.

jms.adaptor.Client.[ClientName].ConnectionsCount

Number of JMS connections.

The endpoint will open a given amount of connections to the JMS server for the given session to send simultaneously.

NOTE: If the number of connections is greater than 1, there is no guarantee that messages will be placed into JMS in the same order they were received by the endpoint.

N1

jms.adaptor.Client.[ClientName].ThreadsPerConnection

The number of threads per JMS connection. The endpoint will open a given amount of JMS sessions for each JMS connection to send simultaneously.

NOTE: If the number of threads per connection is greater than 1, there is no guaranty that messages will be placed into JMS in the same order they were received by the adapter.

N1

...