Java Message Service (JMS) Sample Server

June 14, 2013


The following sample demonstrates creating a messaging engine (using the JMSServer-1.0 feature), the MDB feature (mdb-3.1), and the JMS Client feature (JMSMessaging-1.1).


The JMS sample contains a server definition which includes the features for creating the messaging engine (wasJmsServer-1.0), MDB feature (jmsMdb-3.1), JMS Client feature (wasJmsClient-1.1). It also contains a very simple JMS application, JMSSample.war, which contains couple of servlet for performing Point to Point and Publish/Subscribe messaging.The JMS Servlet provides means to send/receive messages to a queue and also publish and subscribe messages from a Topic. For each of the function, servlet logs the appropriate logs into the console.log.

This sample can be installed onto runtime versions and later.


To run the JMSApp application:

  1. Extract the sample into the Liberty installation by running the command below from the root of your server installation:
    java -jar JMSSampleServer.jar
  2. Start the JMSSampleServer server by running the command below from the bin directory in the Liberty profile installation:
    server run JMSSampleServer
  3. Confirm the application started by looking for the following message in the log:
    CWWKZ0001I: Application JMSApp started in XX.XX seconds.
  4. In your browser, enter the URL for the application (see notes for other actions):
    For Point to Point (P2P) - http://localhost:9124/JMSApp/JMSSampleP2P?ACTION=SendMessage 
    For Publish Subscribe (Pub/Sub) - http://localhost:9124/JMSApp/JMSSamplePubSub?ACTION=NonDurableSubscriber 

    (where 9124 is the HTTP endpoint on which the JMSSample servlet is running).

  5. Once you run the above link you should see a completion message on the Web browser.


If you want to know the list of supported actions for P2P enter http://localhost:9124/JMSApp/JMSSampleP2P?ACTION=ListActions for PubSub enter http://localhost:9124/JMSApp/JMSSamplePubSub?ACTION=ListActions.

The JMSApp.war file contains the source and binaries for the application, and can be used to import it to Eclipse.

Sample structure

Support Information

For further information and resources for developers using IBM WebSphere Application Server, please visit