 
/ $Header: aqjmsREADME.txt 13-jan-2005.13:54:27 jleinawe 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)
/   jleinawe    01/13/05 - no jdk11 
/   rbhyrava    03/01/02 - ORAData
/   rbhyrava    07/16/01 - port specific
/   rbhyrava    06/19/01 - jndi location
/   rbhyrava    03/12/01 - jndi.jar
/   rbhyrava    03/06/01 - jndi
/   rbhyrava    01/26/01 - classes111
/   rbhyrava    11/14/00 - jdbc path
/   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 aqjmsdemo04 
 aqjmsdemo03.java - depends on aqjmsdemo03 - setup Message Listener and dequeue
 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 - 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 
                    ORAData 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.2.x: 
the CLASSPATH need to have the following:
   $ORACLE_HOME/jdbc/lib/classes12.zip 
   $ORACLE_HOME/jdbc/lib/nls_charset12.zip 
   $ORACLE_HOME/jlib/jndi.jar 
   $ORACLE_HOME/rdbms/jlib/aqapi.jar 
   $ORACLE_HOME/rdbms/jlib/jmscommon.jar 

Make sure LD_LIBRARY_PATH contain the directory of OCI JDBC driver shared 
  library objects (libocijdbc*.so). 

Eg: 
   for Solaris, add ORACLE_HOME/lib to LD_LIBRARY_PATH 
    In C-Shell
    %setenv LD_LIBRARY_PATH ${ORACLE_HOME}/lib:${LD_LIBRARY_PATH}

 Refer to platform specific documentation for setting up the above. 

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

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

     jpub -user=aqjava/aqjava -sql=ADDRESS,PERSON -case=mixed -methods=false 
     jpub -user=jmsuser/jmsuser -sql=Emp -case=mixed -methods=false 
     jpub -user=jmsuser/jmsuser -sql=Cars -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 

5. Drop demo scripts 

    % sqlplus system/manager @aqjmsdrp.sql  
        drops jmsuser user

    % sqlplus system/manager @aqoradrp.sql  
        drops aqjava user

