Required OC4J and Oracle Database Installations

===============================================


This demo has been tested with OC4J standalone 9.0.3 and RDBMS 9.0.1.4.
Please note that AC4J in OC4J 9.0.3 requires either RDBMS 9.0.1.4 or 
RDMBS 9.2.0.2.


In addition, this demo uses Ant from the Apache Jakarta Project 
(http://jakarta.apache.org/ant/index.html) for building and executing 
the different demo components. The demo has been tested with Ant 1.5.



Relationship between AC4J and JEM
=================================


Active Components for Java (AC4J) were originally developed under the 
internal code name Java Expresso Machine (JEM). Therefore you will see 
all package structures, classes, code examples etc are in the JEM "namespace".
AC4J and JEM are one and the same.



Installing the AC4J Demo
========================

1) Download the ac4jdemo.jar archive from the Oracle Technology Network 
   ()

2) Once the appropriate version of OC4J and the Oracle database have been

   installed, and the environment variable $J2EE_HOME points to the 
   OC4J J2EE home directory (/j2ee/home), move to the demo
   directory of the OC4J installation, and unpack the demo archive:

cd $J2EE_HOME/demo
jar xvf /ac4jdemo.jar

   This will create the directory $J2EE_HOME/demo/ac4j and unpack the

   demo into it.

3) Download and install Ant from the Apache Jakarta Project 
   (http://jakarta.apache.org/ant/index.html)

4) Then to complete installation, set up and run the demo, follow the
   instructions given in the file $J2EE_HOME/demo/ac4j/README



Unistalling the AC4J Databus and demo tables
============================================

To uninstall the AC4J Databus and all demo related tables, simply connect to 
your databse instance and execute the following commands:

ssqlplus /nolog
SQL> connect / as sysdba
Connected.
SQL> drop user JEMUSER cascade;

User dropped.
SQL> drop user JEMCLIUSER cascade;
User dropped.
SQL> exit


Archive Directory Structure
===========================

ac4j/                                        Root directory of archive.
ac4j/INSTALL                                 This file.

ac4j/README                                  Instructions for setting up and
                                             running the demo.
ac4j/common.xml                              Ant build information common
                                             to all parts of the demo.

ac4j/javadoc/                                Directory containing AC4J Javadoc.
ac4j/javadoc/ac4j_javadoc.jar                AC4J Javadoc archive.

ac4j/purchaseOrder/                          Directory containing AC4J
                                             Purchase Order demo.

ac4j/purchaseOrder/sql/                      Directory containing SQL scripts

                                             to configure demo database tables -
                                             see README.

ac4j/purchaseOrder/purchaseOrderService/     Directories for the three EJB
ac4j/purchaseOrder/creditService/            services that comprise the
ac4j/purchaseOrder/inventoryService/         Purchase Order demo - each with
                                             standard EJB directory structure,
                                             including Ant build.xml file.
                                             See README.