Doc
Project: http://git-wip-us.apache.org/repos/asf/karaf/repo Commit: http://git-wip-us.apache.org/repos/asf/karaf/commit/384540d4 Tree: http://git-wip-us.apache.org/repos/asf/karaf/tree/384540d4 Diff: http://git-wip-us.apache.org/repos/asf/karaf/diff/384540d4 Branch: refs/heads/master Commit: 384540d402f648c6cec00c900ec442054387ef21 Parents: 43cf657 Author: Jean-Baptiste Onofré <[email protected]> Authored: Thu Dec 19 06:40:51 2013 +0100 Committer: Jean-Baptiste Onofré <[email protected]> Committed: Thu Dec 19 06:40:51 2013 +0100 ---------------------------------------------------------------------- manual/src/main/webapp/users-guide/jms.conf | 60 ++++++++++++++++++++++++ 1 file changed, 60 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/karaf/blob/384540d4/manual/src/main/webapp/users-guide/jms.conf ---------------------------------------------------------------------- diff --git a/manual/src/main/webapp/users-guide/jms.conf b/manual/src/main/webapp/users-guide/jms.conf index ea13a22..d411669 100644 --- a/manual/src/main/webapp/users-guide/jms.conf +++ b/manual/src/main/webapp/users-guide/jms.conf @@ -44,6 +44,26 @@ to the type that you mentioned. The {{jms:create}} command accepts different arguments and options: {code} +karaf@root()> jms:create --help +DESCRIPTION + jms:create + + Create a JMS connection factory. + +SYNTAX + jms:create [options] name + +ARGUMENTS + name + The JMS connection factory name + +OPTIONS + -u, --url + The JMS URL. NB: for WebsphereMQ type, the URL is hostname/port/queuemanager/channel + --help + Display this help message + -t, --type + The JMS connection factory type (ActiveMQ or WebsphereMQ) {code} @@ -54,5 +74,45 @@ The {{jms:create}} command accepts different arguments and options: For instance, to create a JMS connection factory for a Apache ActiveMQ broker, you can do: {code} +karaf@root()> jms:create -t activemq -u tcp://localhost:61616 test +{code} + +{warning} +The {{jms:create}} command doesn't install any feature or bundle providing the JMS connection factory classes (and dependencies). +You have to install the required features (for instance {{activemq-broker}} feature for Apache ActiveMQ), or bundles (for IBM WebsphereMQ) providing the JMS connection factory packages and classes. +{warning} + +In the previous example, we assume that you previously installed the {{activemq-broker}} feature. + +We can see the created JMS connection factory: + +{code} +karaf@root()> la +... +151 | Active | 80 | 0.0.0 | connectionfactory-test.xml +{code} + +The {{connectionfactory-test.xml}} file has been created in the {{deploy}} folder. + +h3. {{jms:delete}} + +The {{jms:delete}} command deletes a JMS connection factory. The {{name}} argument is the name that you used at creation time: + +{code} +karaf@root()> jms:delete test +{code} +h3. {{jms:connectionfactories}} + +The {{jms:connectionfactories}} command lists the JMS connection factories: + +{code} +karaf@root()> jms:connectionfactories +JMS Connection Factory +---------------------- +/jms/test {code} + +h3. {{jms:send}} + +The {{jms:send}} command sends a message to a given JMS queue on the broker.
