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

Application Overview
--------------------
This primer application demonstrates the ability of Sun MTP to execute CICS
transactions that access VSAM files.

The application programs are written in COBOL and executed in ACUCOBOL-GT(R)
runtime.


Prerequisites and Reference
---------------------------
Build the Sun MTP executables using kixinstall. Be sure to select 
"ACUCOBOL-GT" 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.cl2, progs/ACCT01.cl2, progs/ACCT02.cl2
                progs/ACCT03.cl2, progs/ACCT04.cl2
Maps       :    maps/ACCTSET.bms
Copybooks  :    progs/ACIXREC, progs/ACCTREC
Tables     :    sys/fct.tbl, sys/pct.tbl, sys/ppt.tbl, sys/sit.tbl,
                sys/snt.tbl, sys/vct.tbl
Data Files :    data/ACCTFILE.dta, data/ALT1.dta, data/ALT3.dta,
                data/ACIXFILE.dta, data/ALT2.dta, sys/CATALOG.dta
                data/ACCTFILE.idx, data/ALT1.idx, data/ALT3.idx,
                data/ACIXFILE.idx, data/ALT2.idx, sys/CATALOG.idx
Other      :    makefile, setup, README.txt

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

2.  Change to that directory.

3.  Edit the setup file.

4.  Source the setup file.


Preparing the Application Components
------------------------------------
1.  Compile the application components:

    $ make


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

    $ kixstart

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

       $ kixstart -t <directory>/unikixtran

2.  Start a user 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.



Shutting Down
-------------
1.  Stop the Sun MTP system using either method:

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

2.  Remove all the compiled programs and BMS maps:

    $ make clean
