README
1@(#)README 1.14 05/03/22
2
3Oracle GlassFish(tm) Server Message Queue Examples
4--------------------------------------------------
5
6This README file describes the different categories of
7JMS2.0 examples found in the directories listed below.
8
9This README also describes how to configure your
10environment and explains how CLASSPATH should be set
11to run the Java examples.
12
13Each individual directory has README which has more details on how to run the samples.
14
15Samples under the below directories are explicitly using new com.sun.messaging.ConnectionFactory() to get the connectionfactory object.
16Applications are recommended to obtain the connection factory by doing a JNDI lookup.
17
18
19Directory Description
20--------- -----------
21asyncsend Contains sample programs that demonstrate the
22 use of new async send JMS2.0 feature with Message Queue.
23
24asynctopicconsumer Contains sample programs that demonstrate the
25 use of new JMS2.0 simplified API to send and
26 asynchrously receive messages.
27
28deliverycount Contains sample programs that demonstrate the
29 use of new JMS2.0 message property JMSXDeliveryCount
30 with Message Queue.
31
32deliverydelay Contains sample programs that demonstrate the
33 use of new JMS2.0 setDeliveryDelay & getDeliveryDelay
34 apis with Message Queue.
35
36messagegetbody Contains sample programs that demonstrate the
37 use of new JMS2.0 getBody api with Message Queue.
38
39messageheader Contains sample programs that demonstrate the
40 use of new jms2.0 simplified api to set message
41 header properties on producer.
42
43messageproperties Contains sample programs that demonstrate the
44 use of new jms2.0 simplified api to set message
45 properties on producer.
46
47selector Contains sample programs that demonstrate the
48 use of new jms2.0 simplified api to create a
49 message selector on a non-durable topic subscription.
50
51syncqueue Contains sample programs that demonstrate the
52 use of new JMS2.0 simplified API to send and
53 synchronously receive messages.
54
55sharedsub Contains sample programs that demonstrate the
56 use of new JMS2.0 simplified API to create shared
57 consumers and sharing of messages between them.
58
59-----------------------------------------------------------------
60
61Configuring the Environment For the Java Examples
62-------------------------------------------------
63
64You should install Oracle GlassFish(tm) Server Message Queue and start the
65broker (imqbrokerd) before attempting to compile and/or run the example
66applications. imqbrokerd is located in the <IMQ_HOME>/bin directory.
67
68The Message Queue examples are found under the <IMQ_HOME>/examples
69directory. If you installed SVR4 packages, the examples are under
70/usr/demo/imq. If you installed RPMs, the examples are under
71/opt/sun/mq/examples.
72
73IMQ_HOME
74--------
75IMQ_HOME denotes the directory <mqInstallHome>/mq where
76mqInstallHome is specified when you install the product.
77
78CLASSPATH
79---------
80The Java examples have already been compiled using JDK1.7.
81
82To recompile or run the examples with JDK1.7, you will need to ensure
83that the following jar files are in your CLASSPATH -
84 jms.jar
85 imq.jar
86 directory containing this example
87
88On SJSMQ/OpenMQ (all platforms):
89 set CLASSPATH to <IMQ_HOME>/lib/jms.jar:<IMQ_HOME>/lib/imq.jar:.
90
91On Solaris with SVR4 Packages:
92 set CLASSPATH to /usr/share/lib/jms.jar:/usr/share/lib/imq.jar:.
93
94On Linux with RH RPMs:
95 set CLASSPATH to /opt/sun/mq/share/lib/jms.jar:/opt/sun/mq/share/lib/imq.jar:.
96
97For running a client application that uses JNDI with File System
98Provider, fscontext.jar should be added to the CLASSPATH.
99
100Additional CLASSPATH requirements (if any) are noted with the
101description of each example.
102