README
1
2@(#)README 1.4 03/22/05
3================================================================================
4
5mqping utility
6
7Description
8-----------
9The mqping utility is similar to the Unix ping utility in some regards.
10With mqping, messages are sent to and received from a running broker.
11The utility measures the round trip time. The utility allows the user
12to control the size of the message, the destination type, delivery mode
13and send interval.
14
15Files
16-----
17mqping.java Source file for this example.
18*.class Prebuilt Java class files for this example.
19README This file.
20
21Configuring the environment
22---------------------------
23To recompile or run this example, you need to set CLASSPATH
24to include at least:
25 jms.jar
26 imq.jar
27 directory containing this example
28
29A detailed guideline on configuring your enrivonment and setting CLASSPATH
30is found in the top-level README file of the examples (demo) directory of
31the Message Queue installation (<IMQ_HOME>/examples/README) as well as in
32the "Quick Start Tutorial" in the Oracle GlassFish(tm) Server Message Queue
33Developer's Guide.
34
35Building the example
36--------------------
37Run the following:
38
39 javac mqping.java
40
41Running the example
42-------------------
43In the simplest form the mqping utility can be run with no options:
44
45 java mqping
46
47This utility takes the following arguments:
48 -t dest_type Specify the optional destination type. Valid values
49 are 't' or 'q'. Default: 'q'
50 -r Optionally indicate the message is persistent.
51 Not specifying this option indicates the message
52 should not be persisted.
53 -s size Specify the optional size of the messages in bytes.
54 Default: 1024
55 -i delay The interval (in seconds) between successive
56 transmissions. Default: 0 (no delay)
57
58 By default mqping will connect to the broker running on localhost:7676.
59 You can use -DimqAddressList attribute to change the host, port and
60 transport:
61
62 java -DimqAddressList=mq://<host>:<port>/jms mqping
63
64