CONTENTS
________________________________________________________________







Introduction                                   1



Section 1
  Brief Theoretical Background

        Fundamental Concepts  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .   4

        Definition of the Problem   .  .  .  .  .  .  .  .  .  .  .  .  .   8

        Solution to the Problem  .  .  .  .  .  .  .  .  .  .  .  .  .  .  10

        Assumptions of CRAFT and M.A.C.R.A.F.T. .  .  .  .  .  .  .  .  .  16



USER'S GUIDE


Section 2
  Using M.A.C.R.A.F.T.

        Brief Description of the Program  .  .  .  .  .  .  .  .  .  .  .  18
             Data Entry Section  .  .  .  .  .  .  .  .  .  .  .  .  .  .  18
             Algorithm Execution Section  .  .  .  .  .  .  .  .  .  .  .  19
   
        Step-by-Step Tutorial on Utilization .  .  .  .  .  .  .  .  .  .  20
             Introduction  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  20
             Utilization Guide   .  .  .  .  .  .  .  .  .  .  .  .  .  .  20


Section 3
  The M.A.C.R.A.F.T. Program  in Detail

        General Description   .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  24
        Menu Structure Organization .  .  .  .  .  .  .  .  .  .  .  .  .  24
        The Main Menu   .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  26
             The Data Entry Section .  .  .  .  .  .  .  .  .  .  .  .  .  26
               The Introductory Screen .  .  .  .  .  .  .  .  .  .  .  .  26
               The File Naming Message Query .  .  .  .  .  .  .  .  .  .  26
               The Data Entry Menu  .  .  .  .  .  .  .  .  .  .  .  .  .  28
                 Creating a New File   .  .  .  .  .  .  .  .  .  .  .  .  28
                   The Create Matrix Menu .  .  .  .  .  .  .  .  .  .  .  28
                     Entering the Filename   .  .  .  .  .  .  .  .  .  .  29
                     The Data Input Matrix Screen  .  .  .  .  .  .  .  .  30
                 Updating an Existing File   .  .  .  .  .  .  .  .  .  .  32
             The Algorithm Execution Section .  .  .  .  .  .  .  .  .  .  33
               The Introductory Screen .  .  .  .  .  .  .  .  .  .  .  .  33
               The Execution Prerequisites Screen  .  .  .  .  .  .  .  .  33
               The File Reading Process   .  .  .  .  .  .  .  .  .  .  .  33
               The Algorithm Execution Menu  .  .  .  .  .  .  .  .  .  .  35
                 Showing Results After Each Iteration .  .  .  .  .  .  .  35
                 Showing Final Results Only  .  .  .  .  .  .  .  .  .  .  36



SOURCE CODE FILE REFERENCE
  


Main program
        File: MACRAFT.PAS  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  39


Unit files
   Main Program Declarations
        File: MAINDECL.PAS .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  43
   Screen Handling 
        File: COLRTEXT.PAS .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  44
   Execution Status Messages
        File: MESSAGES.PAS .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  54
   File-Name Retrieval
        File: GTFILNAM.PAS .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  58
   Introductory Screens and Menus
        File: INTRMENU.PAS .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  62
   File Handling
        File: FILEHNDL.PAS .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  70


Include files
   Runtime Error Handler
        File: ERRHNDLR.INC .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  74
   Algorithm Execution
        File: EXECUTE.INC  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  75
   Moves Following Algorithm Completion
        File: FCHNXTMV.INC .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  87
   File Reading and Validity Checking
        File: FLLINMTX.INC .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  88
   Matrix Fill-Out Declarations
        File: FLLOUTMX.DEC .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  92
   Matrix Fill-Out Field Handling
        File: FLLFIELD.INC .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  94
   Matrix Fill-Out Value Retrieval
        File: GETDTVAL.INC .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  96
   Matrix Fill-Out Screen Handling
        File: FLLSCRN.INC  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . 100

   Matrix Fill-Out File Handling
        File: FLLFILE.INC  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . 107
   Matrix Fill-Out Data Initialization
        File: FLLDATA.INC  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . 109
   Matrix Fill-Out Main Body
        File: FLLOUTMX.BDY .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . 112
   Matrix Updating File Handling
        File: UPDATFIL.INC .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . 116
   Matrix Creation File Handling
        File: PRCSSFIL.INC .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . 117



References                                   121


