Chapter 12: Using jagtool and jagant

jmslist_messages

Lists the messages in the specified message queue.

Local mode support: No.

Command line:

jmslist_messages connect-args [-maximum #messages]
[-selector expression]
MessageQueue:QueueName

Ant build file:

<jag_jmslist_messages [“maximum = #messages]
[“selector = expression”]
type=”MessageQueue:QueueName” />

Option	Description	Default	Required
connect-args	Arguments to specify a connection to the server. See “Using connected mode”.	-	Yes
#messages	The maximum number of messages to list. If 0 or a negative number, all messages are listed.	100	No
expression	A selector expression. Only messages that match the selector expression are returned. If set to true, all messages are returned. The number of these messages that are listed is determined by #messages.	true	No

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

This command line example lists the first 25 messages in “MyQueue”:

jagtool jmslist_messages -maximum 25 MessageQueue:MyQueue

This example does the same in an Ant build file:

<jag_jmslist_messages “maximum=25” type="MessageQueue:MyQueue" />