# JBoss Messaging Topic Example

$Revision: 82920 $

## Overview

This example creates a JMS Connection to a JBoss Messaging instance and uses it to create a session, a publisher and a subscriber. The publisher sends a message to the topic. The example is considered successful if the topic subscriber receives the message.
This example relies on having access to a running JBoss default instance. However, the example will automatically deploy its own topic, unless a topic with the same name is already deployed.

## Running the example

1. Set up the JBOSS_HOME environment variable to point to the JBoss instance you deployed JBoss Messaging into. For example, if you deployed JBoss Messaging in C:\jboss-5.0.0.GA\server\default\deploy, then your JBOSS_HOME value should be C:\jboss-5.0.0.GA.
2. Go to the example's home directory
cd ...\examples\topic
3. Run the example:
ant
The output of a successful run should be similar to:

$ ant Buildfile: build.xml identify: [echo] XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX [echo] X Running the TOPIC example X [echo] XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX [echo] The topic: testTopic sanity-check: init: [mkdir] Created dir: C:\work\src\cvs\jboss-head\jms\docs\examples\topic\output [mkdir] Created dir: C:\work\src\cvs\jboss-head\jms\docs\examples\common\output compile: [javac] Compiling 2 source files to C:\work\src\cvs\jboss-head\jms\docs\examples\common\output [javac] Compiling 2 source files to C:\work\src\cvs\jboss-head\jms\docs\examples\topic\output run: [java] Topic /topic/testTopic exists [java] The message was successfully published on the topic [java] Received message: Hello! [java] The example connected to JBoss Messaging version 1.4.1.GA (1.4) [java] ##################### [java] ### SUCCESS! ### [java] ##################### BUILD SUCCESSFUL Total time: 4 seconds

## Troublesooting

### 1. I get "javax.jms.JMSSecurityException: User null is NOT authenticated"

You probably didn't install JBoss Messaging correctly. A fresh JBoss Messaging installation requires changes in the security configuration of a default JBoss instance, specifically a properly configured "messaging" security domain. Follow the instructions from the "Installation" paragraph of the release documentation.