This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

JMS Message Store

JMS Message Store is shipped with WSO2 ESB. It can be configured by giving class value as org.wso2.carbon.message.store.persistence.jms. JMSMessageStore Messages are stored in a configured JMS queue lying in a JMS Broker.

Since they persist messages in a JMS queue in an ordered manner, JMS Message Stores can be used to implement store and forward patter that have QoS parameters like in order delivery and reliability.

Configuration to connect to a broker is provided as parameter values.

JMS Message Store Parameters

Parameter Name

Value

Required

java.naming.factory.initial

Initial Context Factory to use to connect to the JMS broker

YES

java.naming.provider.url

Url of the naming provider to be used by the context factory

YES

store.jms.destination

JNDI Name of the Queue Name that message store is connecting

NO but for some JMS clients this will be needed

store.jms.connection.factory

JNDI name of the Connection factory which is used to create jms connections

NO but for some JMS clients this will be needed

store.jms.username

User Name that is used to create the connection with the broker

NO

store.jms.password

Password that is used to create the connection with the broker

NO

store.jms.JMSSpecVersion

1.1 or 1.0 JMS API specification to be used (Default 1.1)

NO

store.jms.cache.connection

true/false Enable Connection caching

NO

For more information about message stores, see Message Stores .

UI Configuration

  1. Click Message Stores in the left navigator of the main tab to open the  Manage Message Stores.
  2. Click Add JMS Message Store to open the JMS Message Store page with its default view.


    The following parameters are specific to the JMS Message Store
    • Name - The unique name of the message store.
    • Initial Context Factore - The initial context factory to be used to connect to the JMS broker.
    • Provider URL - The url of the naming provider to be used by the context factory.
  3. If you want to configure the additional parameters, click Show Additional Parameters.

  4. Then the page with all the available JMS Message Store options appears.

Additional JMS Message Store parameter details are as follows:

    • JNDI Queue Name - JNDI Name of the Queue Name that message store is connecting
    • Connection factory - JNDI name of the Connection factory which is used to create jms connections
    • User Name - User Name that is used to create the connection with the broker
    • Password - Password that is used to create the connection with the broker
    • JMS API specification Version - 1.1 or 1.0 JMS API specification to be used (Default 1.1)
    • Enable Connection caching - true/false Enable Connection caching
Note: Individual message priorities can be set using the following property. However this should be implemented on provider.
         <property name="JMS_PRIOR ITY" value="9" scope="axis2"/>
         Eg:- Value can be 0-9 for ActiveMQ

Also see  Store and Forward Using JMS Message Stores for information on configuring JMS message stores for different message broker.