mq5.0-source.src.share.java.examples.applications.uclient.README Maven / Gradle / Ivy
================================================================================
@(#)README 1.1 06/01/05
================================================================================
UniversalClient example
Description
-----------
The UniversalClient example is a basic 'client' application that uses the JMS 1.1 APIs.
It uses JMS Message Producer and Consumer to send and receive messages.
UniversalClient.java does not use JNDI and relies on
the feature by which a broker can "auto-create" the destinations
desired by the user. The bulk of the application deals with the
user interface and the JMS related code is fairly straightforward.
Files
-----
UniversalClient.java Source file for this example.
*.class Prebuilt Java class files for this example.
README This file.
Configuring the environment
---------------------------
To recompile or run this example, you need to set CLASSPATH
to include at least:
jms.jar
imq.jar
directory containing this example
A detailed guideline on configuring your enrivonment and setting CLASSPATH
is found in the top-level README file of the examples (demo) directory of
the Message Queue installation (/examples/README) as well as in
the "Quick Start Tutorial" in the Oracle GlassFish(tm) Server Message Queue
Developer's Guide.
Building the example
--------------------
Run the following:
javac UniversalClient.java
Running the example
-------------------
Run the following:
java UniversalClient
The application comes up not connected to any jms session.
To connect to a broker, bring down the "Actions" menu and
select the "Connect ..." menu item. A dialog will appear to
provide broker hostname, port, username, password, clientID
etc
To disconnect from a given broker host: port bring down the
"Actions" menu and select the "Disconnect" menu item
Once the application is connected, one can send message using
a message producer. To create a producer bring down the "Actions"
menu and select the "Send Message..." menu item. The Send Message
dialog box will come up, where destination name,type and message
size,ttl etc can be specified while sending message.
To stop message sender bring down the "Actions" menu and select
the "Stop Message Sender" menu item
To receive message bring down the "Actions" menu and select the
"Receive Message..." menu item. The receive message dialog box
will come up where destination name, message consumer type and
message selector can be specified.
To stop message receiver bring down the "Actions" menu and select
the "Stop Message Receiver" menu item.
The received message are displayed on a Message Table. To see the
details of a message double click on a row of a message table or
select a row of a message table and click on "Message Details" button.
To start auto scrolling of message table i.e to always see the last
message received, drag the message table vertical scroll bar at the
bottom. To stop auto scrolling drag the message table vertical scroll
bar else where.
To clear existing messages in the message table bring down the "Actions"
menu and select the "Clear Messages" menu item.
The status bar at the bottom shows Message Queue Client Runtime
Connection Notification And Connection related log
To exit from the application, bring down the "console" menu and
click "exit"