                  OC4J JMS MDB DEMO 
                  =================

This is a simple set of demo applications that demonstrate the
configuration and use of OC4J JMS with MDBs  running 
under OC4J. These work on OC4J versions 9.0.4 and higher.


Required environment and demo parameters
-----------------------------------------
ORACLE_HOME      : where the iAS is installed
J2EE_HOME        : root directory of the OC4J source tree

Make sure that you have "java" and "javac" accessible in your PATH
(i.e. you have a valid JDK, version 1.3 or greater, installed).

Requirements:
--------------

1. The users need to have a configured jms.xml at the 
$J2EE_HOME/config directory with the entry - demoQueue, as default, 
demoQueue is pre-configured in OC4J instance.

Demo compilation and build ear file:
------------------------------------
The demo uses Ant for the compilation and build ear file.

1. Clean the environment.
ant clean 

2. Compile the demo classes and build ear file.
ant 


Running the demo under iAS
--------------------------

1) Start OC4J
Use the standard DCM/EM tools to start OC4J.

2) Deploy the demo
dcmctl deployApplication -f mdbdemo_oc4jjms.ear -a mdbdemo_oc4jjms

Note that you may have to give path to the ear file.


Running the demo under OC4J
---------------------------
1) Start OC4J
  cd $J2EE_HOME
  java -jar $J2EE_HOME/oc4j.jar

2) Deploy (and bind) the demo

  cd $J2EE_HOME

  java -jar $J2EE_HOME/admin.jar ormi://${HOST}:${RMI_PORT} admin welcome -deploy -file mdbdemo_oc4jjms.ear -deploymentName mdbdemo_oc4jjms

  java -jar $J2EE_HOME/admin.jar ormi://${HOST}:${RMI_PORT} admin welcome -bindWebApp mdbdemo_oc4jjms mdbdemo-web  http-web-site /mdboc4jjms

Note: As the default, in $J2EE_HOME/config/server.xml, the web-site is
default-web-site.xml, please change it to be http-web-site.xml if you
want to use http protocol to access the web application.


Run demo:
----------
From a browser, browse to the web application. with the following 
parameters. Please replace the HOST and PORT below with OC4J's 
hostname and http port number, for OC4J Standalone, the http port 
is 8888 as default.  For iAS, the port is 7777 as default.

http://<HOST>:<PORT>/mdboc4jjms/testrp?testmdb=

