TEST MDBs with OJMS
                  ===================

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

Also assumes that a properly configured Oracle database is available
for hosting the OJMS queues.

DATABASE SETUP
--------------

 # Connect to database as sys (or equivalent) user and run the jmsuser.sql
   script. This is create the user and queues required for the demo.
   (e.g)
       sqlplus sys/change_on_install @jmsuser.sql

OC4J setup
----------

 # Configure a resource provider named "cts" to access OJMS queues in
   config/application.xml.

   NOTE: Do not use a different name since the resource provider name is
         hardcoded in the MDB's deployment descriptors. Use name of "cts" only.

   IMPORTANT: For correct transactional (BMT and CMT) behaviour, configure
              resource provider using a emulated datasource 

   (e.g)
        
            OJMS/AQ 
           
        

  # Configure the emulated DS referenced above to connect to the 
    database and schema used in "database setup" above.

    (e.g)
        


Deploy Demo Applications
------------------------
  # Start OC4J


  # Deploy and bind web application

    cd web
    testrp.ear is the ear file for the web application.

    (e.g) (Using RMI and binding to default-web-site)
       java -jar ${OC4J_HOME}/admin.jar ormi://${DB_HOST}:${RMI_PORT} admin welcome -deploy -file testrp.ear -deploymentName testrp

       java -jar $J2EE_HOME/admin.jar ormi://${DB_HOST}:${RMI_PORT} admin welcome -bindWebApp testrp testrp default-web-site /testrp


  # Deploy mdb application

    cd mdb
    testmdb.ear is the ear file for the mdb application.

    (e.g) (Using RMI)
       java -jar ${OC4J_HOME}/admin.jar ormi://${DB_HOST}:${RMI_PORT} admin welcome -deploy -file testmdb.ear -deploymentName testmdb


Run Demo
--------
   From a browser, browse to the web application, with following parameters.
   Replace HOST and PORT below with OC4J's hostname and port.

   http://:/testrp/testrp?testmdb=

   The parameter "testmdb" is required to test MDBs. Otherwise, only the
   resource provider configuration is tested.