From helens!relgyro!shelby!decwrl!ucbvax!ucsd!usc!zaphod.mps.ohio-state.edu!rpi!uupsi!sunic!kth.se!draken!d88-jwa Wed Jun 20 17:34:51 PDT 1990
Status: RO

Article 1977 of comp.sys.handhelds:
Path: helens!relgyro!shelby!decwrl!ucbvax!ucsd!usc!zaphod.mps.ohio-state.edu!rpi!uupsi!sunic!kth.se!draken!d88-jwa
>From: d88-jwa@nada.kth.se (Jon W{tte)
Newsgroups: comp.sys.handhelds
Subject: CASH.01B - cash management application
Keywords: cash management, application, HP 48SX, CASH
Message-ID: <1990Jun20.202627.14560@nada.kth.se>
Date: 20 Jun 90 20:26:27 GMT
Reply-To: d88-jwa@nada.kth.se (Jon W{tte)
Organization: Royal Institute of Technology, Stockholm, Sweden
Lines: 265


Gee, what a pretentious title...

Be sure to read this documentation, and especially the
copyright notice, before you download the application.
Also, never distribute the application without this
file.

--- Start file CASH.01B.TXT ---


		CASH  by Jon W{tte
		  h+@nada.kth.se

	     Version 0.1b documentation


CASH is a small application for the HP 48SX programmable
personal miracl... erh, calculator. It enables you
somewhat to keep track of where your money goes,
provided you use it.


DOWNLOADING

The program distribution consists of this file, cash.txt
and the actual application directory, cash.01b. You have
to distribute these two files together if you choose to
distribute the program further. (see the copyright
license)

To install the application in your HP 48, you need about
4k of free memory, a personal computer equipped with a
program supporting the Kermit protocol, and a cable
between your computer and your HP 48.

The application will create it's own directory named
"CASH" in the directory that is the current directory
during download. Move to the directory where you want
the program installed.

Make sure the HP is set-up to receive data with
translate code 3, and that the speed and other kermit
and communications settings match between your HP 48 and
your computer.

Enter receive mode on your HP 48, and send the file
cash.01b from your computer. The transfer should take
less than 20 seconds (if you use 9600 baud) and you
should find the directory "CASH" created in the current
directory. If this isn't the case, refer to your HP 48
manual for trouble-shooting HP 48 <-> computer
communications. (One tip is to clear IOPAR and restart,
since a XON or XOFF might be missing/hanging loose.)


SETUP

Enter the "CASH" directory. You will find several
variables and programs / routines. They have the
following use:

VER	a utility and setup program
KADD	a program used to add new account names
BOOK	do end-of-period bookkeeping, reshuffling and
	reporting
CDATE	the routine used to mangle HP 48 internal date
	to a sane (i.e. ISO standard) format. If you
	want another date format, you can change this
	routine
SUMUP	a co-routine for BOOK, building the report after
	each period
LESS	a string list viewer used by SUMUP
CST	the variable describing the account menu
KOF	a simple "confirm" subroutine
CKORR	a routine that patches data
KORR	a subroutine used when taking back transactions
CBEL	one of the data variables
KBEL	the other of the data variables
TRANS	a subroutine used for doing transactions
ARCH	an empty library where archived transactions go

You will need to use only VER, KADD and BOOK.

The first thing you have to do is to decide how you want
to organize your accounts. Maybe you want to have three
accounts ("Food", "Rent", "Other",) maybe twelve ("Coca
Cola", "Batteries", ...) It's up to you.

When you have decided on what set of accounts you want
to keep track of, continue as follows:

For each account name, enter the name in a string. Press
"ENTER" so that you have two copies of the string on the
stack. Now, press KADD to add the account. Repeat for
all accounts you wish to use.

You're done. (No worries, you can add accounts later, or
even reset and start from the beginning. See below.)


USAGE

When you want to enter a transaction into an account,
make sure you are in the "CASH" directory, and press the
"CST" key on the HP 48 keyboard (2nd down to the left
of the middle of the keyboard.) You are prompted with a
menu of your accounts. (If you have more than six
accounts, you have to press the "NXT" key to see the
rest of them)

Enter the amount you wish to register, and press the
menu key corresponding to the account you wish to
register on. The transaction is now added to the
internal list of transactions, together with the date.

If you want to see how much you've spent in one account
so far, press right-shift (blue arrow) and the menu key
corresponding to the account.

If you want to take back a transaction already entered,
press left-shift (orange arrow) and the menu key
corresponding to the account. You will be prompted with
the latest transaction in that account, and asked if you
want to delete the transaction. Press the menu key to
the left ("A") to do it, or the menu key to the right
("F") to cancel. (These keys are labelled YES and NO
respectively on the screen.)

NOTE: You can only take back the latest transaction in
an account (and then repeat to delete subsequently older
transactions.) If you want to delete the
second-to-latest transaction in an account, you'll have
to remember the latest transaction, delete it and the
second latest, and then enter the latest transaction
again. It will then receive a new date-stamp.


ARCHIEVAL

After some time (a week or two, usually) the
application becomes sluggish because of the amount of
data in the internal list of transactions. To avoid
this, you are encouraged to make periodical summaries.
If you press BOOK while in the "CASH" directory, the
following will happen:

All transactions will be stored in the "ARCH" directory.
The internal list of transactions will then be reset to
0. You are also given a short summary of transactions in
the accounts. To scroll through this summary, use the
following keys:

UP ARROW	scroll up one line
DOWN ARROW	scroll down one line
RIGHT ARROW	go to the end
LEFT ARROW	go to the beginning
'+'		scroll down one page (five lines)
'-'		scroll up one page (five lines)
ENTER		quit viewing.

This summary will be stored in the "ARCH" directory.

Now, all accounts are zeroed, and you start a new
period.

NOTE: Archives are stored using the current date in the
name. If you do this transaction more than once in any
day, you will overwrite the previously archived
transactions with the new archive, deleting the
previously archived transactions.


MAINTAINANCE

Press VER while in the "CASH" directory to enter the
maintainance program. You are greeted with a screen
giving the version of CASH (Present version 90.06.19 is
0.1b) Continue by pressing any key. You will be given a
few questions, to which you answer by pressing the YES
(A) or NO (F) menu keys. The questions have the
following meanings:

"Reset data ?"
	If you choose YES, all transactions done since
	the last archival will be lost, and all accounts
	are set to 0.
	If you choose NO, no changes are made.

"Reset archive ?"
	If you choose YES, all data in the "ARCH"
	directory (that is, all archived transactions)
	will be purged. Do this only after you have
	assured yourself that you have a valid backup of
	the "ARCH" directory, or that you do not need
	the saved transactions in the "ARCH" directory.
	(You will have to do this sooner or later - lots
	of saved transactions is a good memory-eater)
	If you choose NO, no changes are made.

"Reset setup ?"
	If you choose YES, all transactions since the
	last archival will be lost, as will all
	information about accounts and account names.
	Transactions in the "ARCH" directory will still
	have their account names left. You will have to
	start over adding accounts with KADD.
	If you choose NO, no changes are made.


COPYRIGHT

This application is copyrighted by me (Jon W{tte.) It
may be used and distributed freely as long as no changes
are made to the application nor to this document.

Under no circumstances are you allowed to distribute the
application without accompaniment of this document.
PLEASE be sure to give a printed copy of this file away
if you transfer the application to another user's HP 48.

I demand no charge for use or distribution, but I do
want these premises adhered to. If you make any changes
to the program(s) or just want to send some bug reports/
comments/praise/beer, I'm reachable as:

h+@nada.kth.se
Jon W{tte, Svartmangatan 18, S-111 29 STOCKHOLM, Sweden


COMMENTS

The application and this document was first developed in
Swedish. I figure you agree that it gained enough in the
translation to warrant for the wait...

I will try to continue developing this program. Send any
comments/suggestions/improvements to me at my addresses
above.

You may use single parts of this program (the string list
viewer, the confirmer or the date mangler, for instance)
in your own program, provided you give me proper credit
if you distribute it.


BUGS

There is no way to retrieve the data archived except for
looking at the raw data. This will be fixed in a coming
release.

Pressing the ON key while the program is running may
corrupt the internal data structures and result in loss
of data or even program functionality (some of the parts
modify themselves or other executable parts).

Probably several other.


CUTE SAYING

"You'd better spend your CASH before you run out of it."
-- 
	Jon W{tte, Stockholm, Sweden, h+@nada.kth.se