#**********************************************************************#
#*                                                                    *#
#* Copyright (c) 2004 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 C.


Prerequisites and Reference 
---------------------------
Build the Sun MTP executables using kixinstall. Be sure to select "Sun MTP 
VSAM RELATIVE/INDEXED Files" as your Data Management Access 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.ccs, progs/acct02.ccs,
                progs/acct03.ccs
Maps        :   maps/ACCTSET.bms
Copybooks   :   progs/ACIXREC.h, progs/ACCTREC.h, progs/NEW_ACIXREC.h, 
                progs/NEW_ACCTREC.h, progs/OLD_ACIXREC.h,
                progs/OLD_ACCTREC.h
System files:   sys/fct.tbl, sys/pct.tbl, sys/ppt.tbl, sys/sit.tbl, 
                sys/snt.tbl, sys/vct.tbl, 
		sys/CATALOG.dta, sys/CATALOG.idx
Data files  :   data/ACCTFILE.dta, data/ALT1.dta, data/ALT3.dta,
                data/ACIXFILE.dta, data/ALT2.dta, 
		data/ACCTFILE.idx, data/ALT1.idx, data/ALT3.idx,
                data/ACIXFILE.idx, data/ALT2.idx
Other       :   makefile, setup, README.txt


Setup Procedure
---------------
1.   Copy $UNIKIX/examples/primer/C 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 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.



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

