[Coco] Os9budget Draft docs

[phil pt]

                       Os9Budget Version 1.00
                     (C) 2018 By Phillip Taylor






Os9Budget is released as Freeware and this program is protected under the
U.S Federal Copyright Laws. The author grants the users the permission to
distribute this file but you may not change and make any modifications to
the executable or to the documentation.

This program has been tested the author will not be held liable for any
damages that may accure using this program.

Os9Budget was developed using The Vcc Emulator, Nitro-Os9 Level 2 and
Drivewire.


Requirements:

Coco 3 Emulaor (Vcc or Real Coco 3)
Nitro Os9 Level 2
512k of Memory
Two Double sided 80 Track Floppy Disk


Before you attempt to use Os9Budget please read the entire this entire
documentation. Since some of the devices is able to store smaller amount of
data it's very important that you have the proper amount of disk space to
prevent a 248 (Media Full) Error. If error happens when the program is
running this could result to some of the information stored in the data
files to be damaged.

Since this program is released as freeware I do not provide phone technical
support. If you encountered a error please check the documentation before
you sent technical support question to:

support[at]professionalsoftwaredevelopment dot com.

Please include on the subject of the email message Os9Budget and the issue
that your having.


Os9Budget includes:


Main executable files:

   Budget           - Main program.
   CenterText       - Center the text on the screen.
   Payments         - Handles all the transactions.
   Payees           - Payees(Payee Name, Address, Act Number ect.)
   Category         - Categories.
   Codes            - Add, Edit & Search category codes.
   Errmsg           - Handles all the errors.


Data Files:

   Config.Dat       - Holds the data path location
   Cat              - Holds all the category information.
   Payments         - Holds the Payment information.
   PayCom           - Holds all the users payment comments.
   Budget           - Holds all the budget information
   LN               - Holds the last payment record pointers.


The author will void your technical support if you make any modifications
to the executable files or changes done to the database that was done not
using the budget executable files.

The current and future release on the features and any modificatins done to
this program will be included in the release file.

Depending on if your using a Real Coco 3 or running it under the Vcc
emulator you may need to merge CenterText, Errmsg and Runb. You will need
to set thedata path location and create the data files from the config menu
and the datafiles can be located on any device or directory. For example
/dd/data/. The ending backslash must included and you will need to oreate
the proper directories. Refer to the Os9 Level 2 Operating System Manual.

Please try and resolve the issues by reading the Os9 Level 2 Manual before
you submit a helpdesk ticket.

Your current working directory is the path that is used when you typed in
the main program name. The program will check if the Os9budget.cfg exist in
your current pwd directory, reads the lines included in the config file
then checks to see if all the data files exist. If for some reason if any
of the files does not exist all the Main Menu items will be disabled accept
for the Config Menu and the other menu items will be enabled after you have
corrected the issues.

To configure Os9Budget select the Config menu and set all the correct data
paths and make sure that you have plenty of disk space or some of the other
data files could get damaged if you run out of disk space. Now you will
need to add some transaction codes see the comments below.

All the transactions is saved in your payment data file. Before you can add
new payees or payments you will need to add some records.

>From the main menu select categories and add all the new categories that
you you will be using when adding new payees and payment records. For
example I use Utils for my electronic and the water bill.

Now you will need to add some Transaction codes and they are hard coded so
you will not be able to change them. See below.

The Transaction data file is used to store all of your deposits, interest,
payments ect.  The following transaction codes are hard coded in the
program and you will not be able to change them.

DP = Deposit Cash.                WD = Widthdraw Cash
WD = Widthdraw Cash               IN = Interest earned
SC = Service charge (Bank)        EP = Electronic Deposit (Paycheck)
ED = Electronic Debit

Note: Interest would be added as a new entry when you earn interest,
Electronic Deposit for example may be your paycheck and Electronic Debit
for example ifyou pay a bill online and the company that paying ask for
information from your debit card.

The type of code that you will be used will be determine either + or Minus
transaction type. For example you could add a record named payday and use
the code EP and ED for Credit Cards or for your cell phone bills. Any
records that you add using the ED code you will be allowed to assign a
check number to that transaction.

Now you ready to use the program. Just follow the prompts and the program
will tell you what type of data that you need to type in. But some of the
codes you will have to either rember or write the down.


Rember you should alway use the proper command to find out how free disk
space that you have available before you run Os9Budget.