#**********************************************************************#
#*                                                                    *#
#* 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 a Sybase 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 Sybase using kixinstall. Be 
sure to select Sybase 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.cp, progs/acct02.cp,
                progs/acct03.ccs, progs/acctfet.cp
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,
                util/actrec.fmt, util/acctocrs.fmt
Data files  :   util/actrec.dat, util/acctocrs.dat
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

Setup Procedure
---------------
1.   Copy the $UNIKIX/examples/sybase/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.   Create the Sybase database and the database tables for the sample
     application:

     $ isql -Usa -Psa_password <util/createdemo.sql

     Replace "sa_password" with the password of the Sybase system
     administrator userid.

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

2.   Load the sample data:

     $ bcp acct..ACTREC in util/actrec.dat -f util/actrec.fmt -Uunikix -Punikix
     $ bcp acct..ACCTOCRS in util/acctocrs.dat -f util/acctocrs.fmt -Uunikix -Punikix

3.   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 tables, the database, and the default userid 'unikix'
     for the sample application:

     $ isql -Usa -Psa_password <util/dropdemo.sql

3.   Remove all the compiled programs and BMS maps:

     $ make clean

