Chapter 12: Using jagtool and jagant

jmsmanage_listeners

Description

Adds and removes listeners to and from JMS message queues.

Syntax

Local mode support: No.

Command line:

jmsmanage_listeners 
connect-args 
-action "Component:comp" 
MessageQueue:queue

Ant build file:

jag_manage_listeners action=”action” listener="Component:comp" entity="MessageQueue:queue"/>

Option	Description	Required
connect-args	Arguments to specify a connection to the server. See “Using connected mode”.	Yes
action	`add` to add the listener to the queue or `remove` to remove the listener from the queue.	Yes
comp	The component that listens for messages on the specified queue, in the format `package/component`.	Yes
queue	The message queue name.	Yes

Returns

Return value	Indicates
0	The command ran successfully; the result is true/success.
2	The command did not run successfully; an exception was thrown.

Examples

Example 1

These commands add and remove the component JmsListenerTest/JmsListener to the queue MyQueue:

jagtool jmsmanage_listeners -add Component:JmsListenerTest/JmsListener MessageQueue:MyQueue

jagtool jmsmanage_listeners -remove Component:JmsListenerTest/JmsListener MessageQueue:MyQueue

View this book as PDF