Salesperson's Analysis: Sloppy Joe's Burger Joint

SETUP
-------------------------------------------------
The following files are required in order to run
this sample application.

        SALES.EXE               'Main sample application
        MAKECHRT.XLM            'Excel macro to create a 3-D bar chart
        GETHWND.DLL             'Dynamic Link Library needed by the app.
        CMDIALOG.VBX            'Common dialog custom control VBTOOLKIT
        PENCNTRL.VBX            'Pen custom control from VBTOOLKIT
        THREED.VBX              '3-D custom control from VBTOOLKIT
        ANIBUTON.VBX            'Animate button

To insure that the VBX and DLL files will be found when the app (SALES.EXE)
is run, copy these files to the Windows 3.1 directory.  The MAKECHRT.XLM
file should be included in the same directory as the app (SALES.EXE) you
may also want to copy it to your EXCEL directory to insure that it will
be found.

DESCRIPTION
-------------
This application is a demonstrates an implementation of a salesperson's
analysis form for Windows for Pen Computing.  The application consists
of three main forms.  The first form contains three fields (date, sales
rep name and territory) which are used as indexes into a database.  
The available sales reps and territories are stored within a drop down list
box.  You have the option of adding sales reps and territories to the
list of available sales reps and territories.

If information is found for the date, sales rep, territory entered, 
the second screen (revenue and expense report)
will contain the information from the database.  If no information is
found the forecast column (for the current month) will contain the
forecasts for the current month, the column of actual figures will be 
blank and the forecast column (for  next month) will contain calculated 
suggested forecasts which can be changed.  From this form you can
enter notes or view a "Year to date profit" chart in Excel (the report).

The third screen also contains a forecast (current month), actual
and forecast (next month) columns.  This form displays information
regarding days worked, calls taken, new accounts and total accounts.
From this screen you can also enter notes or view a "Year to date
profit" chart in Excel.

The notes screen (entered from the second or third screen) allows
to enter notes for the form.  You have the options of OK, Clear All or 
Cancel from the notes window which will take you back to the previous
screen.  The notes are maintained while viewing/modifying the information
for a particular date, sales rep and territory.  Once you return to
the first screen or exit, the notes will be lost. 

CUSTOMIZATION
--------------
By creating or modifying data files, you can customize the company name,
available sales reps and territories.  Using a text editor such as
MS-DOS 5.0 EDIT, you can enter information into the following files.
If no file exists, the program will assume defaults which are also
listed below:

        Files           Description
        ---------------------------------------------------------
        COMPNAME.DAT    Contains the company name.  This file        
                        should only contain 1 line of text for
                        the name.
        SALESREP.DAT    Contains a list of available sales reps.
                        The name of each sales rep should be listed on a
                        separate line within this data file.  This file
                        will be created if you add sales reps while running
                        the program.
        TERRITRY.DAT    Contains a list of available territories.
                        The name of each territory should be listed on
                        a separate line within this data file.  This
                        file will be created if you add any territories
                        while running the program.

        Note: It is not required that these files exist for the
        program to run.  These files should be placed in the same
        directory as SALES.EXE so that the program can find them.
        If these files are not found, the program will assume defaults.

DEFAULTS

Below are the defaults assumed by the program for the company name,
sales reps and territories.

        Configurable Item       Default(s)
        -----------------       --------------------------
        Company Name            Sloppy Joe's Burger Joint

        Sales Reps              Bugs Bunny
                                Elmer Fudd
                                Daffy Duck

        Territories             Toronto
                                Vancouver
                                Montreal

The above defaults are only assumed if there is no data file for                                
each of the above.  If data files do exist, the information contained
within the data file(s) override the defaults.



