/
/ $Header: aqjmsREADME.txt 24-aug-00.16:14:51 rbhyrava Exp $
/
/ aqjmsREADME.txt
/
/ Copyright (c) Oracle Corporation 2000. All Rights Reserved.
/
/   NAME
/     aqjmsREADME.txt - <one-line expansion of the name>
/
/   DESCRIPTION
/     <short description of component this file declares/defines>
/
/   NOTES
/     <other useful comments, qualifications, etc.>
/
/   MODIFIED   (MM/DD/YY)
/   rbhyrava    08/24/00 - jdbc classes
/   rbhyrava    07/10/00 - fix bug 1319922
/   rbhyrava    07/11/00 - aqjmsdemo.tar
/   rbhyrava    04/14/00 - demo drop
/   rbhyrava    03/20/00 - required init.ora setup
/   rbhyrava    03/15/00 - AQ JMS demo README
/   rbhyrava    03/15/00 - Creation
/
The following files are required for running JMS samples 

 aqjmsdmo.sql     - Setup file for AQ JMS demos
 aqjmsdemo01.java - Enqueue Text Message and Dequeue based on Message Properties
 aqjmsdemo02.java - Message Listener demo- enqueue messages - 
                    run aqjmsdemo03  to dequeue 
 aqjmsdemo03.java - Message Listener tests - run aqjmsdemo02 first 
 aqjmsdemo04.java - Oracle Type Payload - Dequeue on Payload content 
 aqjmsdemo05.java - Queue Browser Example
 aqjmsdemo06.java - Schedule Propagation between queues in the database
 Cars.java        - Jpublisher generated class ; used in aqjmsdemo04.java 
 Emp.java         - Jpublisher generated class ; used in aqjmsdemo04.java 
 MesgListener.java- Message Listener - used in aqjmsdemo03.java 
 Message.java     - Definition of Serializable Object-used in aqjmsdemo06.java 
 aqjmsdrp.sql     - Cleanup for  AQ JMS demos

The following files are required for running AQ Java API samples 

 aqoradmo.sql     - Setup file for AQ java API demos
 aqorademo01.java - Enqueue and Dequeue RAW messages 
 aqorademo02.java - Enqueue and Dequeue Object Type messages using 
                    CustomDatum interface
 ADDRESS.java     - Jpublisher generated class ; used in aqorademo02.java 
 PERSON.java      - Jpublisher generated class ; used in aqorademo02.java 
 aqoradrp.sql     - Cleanup for AQ java API demos

Setup:
------

All the examples can be run for either for JDK1.1.x or JDK1.2. 
The CLASSPATH and PATH need to be set appropriately. 

For JDK1.1.x: 
the CLASSPATH need to have the following:
   $ORACLE_HOME/jdbc/lib/classes111.zip 
   $ORACLE_HOME/rdbms/jlib/aqapi11.jar 
   $ORACLE_HOME/rdbms/jlib/jmscommon.jar 

For JDK1.2.x: 
the CLASSPATH need to have the following:
   $ORACLE_HOME/jdbc/classes12.zip 
   $ORACLE_HOME/rdbms/jlib/aqapi.jar 
   $ORACLE_HOME/rdbms/jlib/jmscommon.jar 

[ORACLE_HOME]/lib directory contains:
  - libocijdbc8.so (on Solaris): the shared library used by the 
    JDBC OCI8 driver. This should be added to LD_LIBRARY_PATH 

    In C-Shell
    %setenv LD_LIBRARY_PATH ${ORACLE_HOME}/lib:${LD_LIBRARY_PATH}

 Refer to JDBC Readme.txt for setup of CLASSPATH for various platforms.

Database Setup:
--------------
   Before running the demo, add the following lines to your init.ora file:
        compatible = 8.1.0
        aq_tm_processes = 1
        job_queue_processes = 2
        job_queue_interval = 1
   shutdown and restart the database.

Compilation: 
------------
    
 2. The Jpublisher classes can be optionally generated using the following
    syntax. 

     jpub -user=aqjava/aqjava -sql=PERSON -case=mixed -methods=false 
     jpub -user=jmsuser/jmsuser -sql=Emp -case=mixed -methods=false 


How to Run the demos: 
---------------------

1. Verify the CLASSPATH and PATH setup based on platform and jdk version.

2. Compile the demos 

   %javac aqjmsdemo*.java  aqorademo*.java

   Refer to the individual demos files for more information.


3. Run the setup scripts

    % sqlplus system/manager @aqjmsdmo.sql  
        creates jmsuser user

    % sqlplus system/manager @aqoradmo.sql  
        creates aqjava user

4. Run the demos 

    %java aqjmsdemo01 [SID] [HOST] [PORT] [DRIVER]
    %java aqjmsdemo02 [SID] [HOST] [PORT] [DRIVER]
    %java aqjmsdemo03 [SID] [HOST] [PORT] [DRIVER]
    %java aqjmsdemo04 [SID] [HOST] [PORT] [DRIVER]
    %java aqjmsdemo05 [SID] [HOST] [PORT] [DRIVER]
    %java aqjmsdemo06 [SID] [HOST] [PORT] [DRIVER]

    %java aqorademo01 [SID] [HOST] [PORT] [DRIVER]
    %java aqorademo02 [SID] [HOST] [PORT] [DRIVER]

   Example: 
     java aqjmsdemo01 orcl dlsun673 1521 thin 
