Overview:
=========
  The purpose of the jms_secured quickstart is to show how JMS destinations 
  can be configured with security properties. 
  
  This quickstart is exactly like the basic helloworld quickstart except that 
  'jms-security-principal' and  'jms-security-credential' properties are 
  specified for the jms-bus elements.
  
  NOTE: this quickstart copies message-roles.properties and message-users.properties
  to ${org.jboss.esb.server.home}/server/${org.jboss.esb.server.config}/conf/props,
  and this will require a server restart to funktion correctly.

Running this quickstart:
========================
  Please refer to 'ant help-quickstarts' for prerequisites about the quickstarts
  and a more detailed descripton of the different ways to run the quickstarts.

To Run standalone mode:
=======================
  1. In a command terminal window in the quickstart folder type
     'ant deploy-jms-dests'.
  2. In a command terminal window in this folder ("Window1"), type 'ant run'.
  3. Open another command terminal window in this folder ("Window2"), type
     'ant runtest'.
  4. Switch back to "Window1" to see the output from the ESB
  5. When finished, interrupt the ESB using Ctrl-C and, in this folder
     ("Window1"), type 'ant undeploy-jms-dests'.

To Run '.esb' archive mode:
===========================
  1. In a command terminal window in this folder ("Window1"), type 'ant deploy'.
  2. Open another command terminal window in this folder ("Window2"), type
     'ant runtest'.
  3. Switch back to Application Server console to see the output from the ESB
  4. In this folder ("Window1"), type 'ant undeploy'.

What to look at in this Quickstart:
===================================
  1. src/org/jboss/soa/esb/samples/quickstart/jmssecured/test/SendJMSMessage
  	 Notice how the username(gatewayuser) and password for the destination 
  	 queue/quickstart_jms_secured_Request_gw  is specified during the creation of 
  	 the QueueConnection.
  2. jbm-queue-service.xml (JBM) or jbmq-queue-service.xml
  	 Notice how quickstart_jmssecured_Request_gw is defined with a SecurityConfig
  	 attribute and specifies two roles. One is a gatewayrole, which is used by the
  	 SendJMSMessage class to publish messages to the destination. The 'gatewayrole'
  	 can only write to the destination and not read. 
  3. jboss-esb.xml
     The message-filter for the jms-bus now specifies 'jms-security-principal' and
     'jms-security-credential'
  	 

