#**********************************************************************#
#*                                                                    *#
#* Copyright (c) 2004 by Sun Microsystems, Inc.                       *#
#* All rights reserved.                                               *#
#*                                                                    *#
#**********************************************************************#


Application Overview
--------------------
This Primer application demonstrates the ability of Sun MTP to execute embedded
SQL code within CICS transactions and access an Oracle database.

The application programs are written in C.


Prerequisites and Reference
---------------------------
Read the Sun MTP Configuration Guide, specifically the chapter on configuring a
region to work with an RDBMS.

Build the Sun MTP executables that will work with Oracle using kixinstall. Be 
sure to select Oracle as your RDBMS and choose the default as your Application 
Language.

Make a note of the target directory for the executables that you specify during
the build process.

The Sun MTP Installation Guide contains information on using kixinstall.

Contents of Directories
-----------------------
Programs    :   progs/acct00.ccs, progs/acct01.pc, progs/acct02.pc,
                progs/acct03.ccs, progs/acctfet.pc
Maps        :   maps/ACCTSET.bms
Copybooks   :   progs/ACIXREC.h, progs/ACCTREC.h, progs/histset.h,
                progs/NEW_ACIXREC.h, progs/NEW_ACCTREC.h,
                progs/OLD_ACIXREC.h, progs/OLD_ACCTREC.h
DDLs        :   util/createdemo.sql, util/dropdemo.sql
Data        :   util/actrec.ctl, util/acctocrs.ctl
System files:   sys/pct.tbl, sys/ppt.tbl, sys/sit.tbl, sys/vct.tbl
		sys/CATALOG.dta, sys/CATALOG.idx
Other       :   makefile, setup, README.txt, progs/tran.exp


Setup Procedure
---------------
1.   Copy the $UNIKIX/examples/oracle/C directory structure to a new
     location.

2.   Change to that directory.

3.   Edit the setup file for your environment.

4.   Source the setup file.

Preparing the Application Components
------------------------------------
1.   Log in as the Oracle administrator and bring up an Oracle session.

2.   Create the Oracle database:

     SQL> GRANT connect,resource to unikix identified by unikix;

3.   Log out as the Oracle administrator.

4.   Log in as the Sun MTP user, if necessary.

5.   Create the database tables for the sample application:

     $ sqlplus unikix/unikix @util/createdemo.sql

     The script creates tables in the database 'unikix' which is also the
     database name in the System Initialization Table.

6.   Load the sample data:

     $ sqlldr control=util/actrec.ctl   userid=unikix/unikix
     $ sqlldr control=util/acctocrs.ctl userid=unikix/unikix

     Note: If you are using older versions of Oracle (e.g. 8.1.6) you will
           have to use "sqlload" instead of "sqlldr". Refer to the Oracle
           documentation.

7.   Compile the application components:

     $ make


Executing the Sample Application
--------------------------------
1.   Start the region.

     $ kixstart

     Note - If you specified a different target directory during the kixinstall
     process, you must use the -t option to specify the path name:

       $ kixstart -t <directory>/unikixtran

2.   Start a Sun MTP session. For example, to start a local client type:

     $ ncd101unikix unikix

3.   On a blank transaction screen, type ACCT and press Enter.

4.   On the ACCOUNT FILE: MENU screen, type G in the Surname field.

     The Greenfield entries are displayed.

5.   Try the other functions of the application.

     Note: The 'P' (print) option is not supported.

6.   When you are finished, press the Clear key to exit the application.


Shutdown procedures
-------------------
1.   Stop the Sun MTP system using either method:

     - Type the kixstop command at a UNIX shell prompt.
     - Type CSMT SHUT,YES on a blank transaction screen.

2.   Delete the database tables for the sample application:

     $ sqlplus unikix/unikix @util/dropdemo.sql

3.   Log in as the Oracle administrator and bring up an Oracle session.

4.   Delete the 'unikix' database in the Oracle instance:

     SQL> DROP user unikix;

5.   Log out as the Oracle administrator.

6.   Log in as the Sun MTP user, if necessary.

7.   Remove all the compiled programs and BMS maps:

     $ make clean

