                  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 


Start the OC4J server:
-----------------------
cd $J2EE_HOME
java -jar $J2EE_HOME/oc4j.jar

(in standalone OC4J; in iAS, use the standard DCM/EM tools to start
OC4J).


Deploy the mdb application and do the bindWeb:
----------------------------------------------
cd $J2EE_HOME
java -jar admin.jar ormi://${HOST}:${RMI_PORT} admin welcome -deploy -file mdbdemo_oc4jjms.ear
-deploymentName mdbdemo_oc4jjms

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

Please note:
============
1. If you issue the deployment command under $J2EE_HOME or somewhere which is not the
directory that your application ear file located, you would need to give the full path for
the ear file.

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

3. The deployment and bind commands above are for OC4J standalone mode. If you want to run
the demo at iAS mode, please use dcmctl command do the deployment and bind as following:

dcmctl deployApplication -f mdbdemo_oc4jjms.ear -a mdbdemo_oc4jjms -v -d

Please give the path of ear file and issue the command at proper location.


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, the http port is 8888 as
default.

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

