CrOsborne Currency Exchange Calculator

Installation instructions:

EXCHANGE.ZIP is an archive file containing four files:

   EXCHANGE.OPA - the Psion application.
   EXCHANGE.DBF - an initial data file to get you started.
   EXCHANGE.RSC - Psion help file.
   RDMEEXCH.TXT - these instructions.

Use WinZip and PsiWin (or whatever other means you normally use) to extract
the files.

Copy EXCHANGE.OPA to a directory called \APP on any Psion drive.

Copy the data file EXCHANGE.DBF to the \DAT directory on the internal
memory disc.

The Help file EXCHANGE.RSC can optionally be installed in the \OPD
directory. If you leave it out you can still enter registration details
but other help functions will not work.

On the Psion system screen postion the cursor to the right of where
you want the icon for Exchange to appear (I suggest next to the Calc icon)
and select Menu - Apps - Install&nbsp; (press Psi-I). Exchange.opa should
appear in the list, select it. Finally you might like to assign the Ctrl+Calc
button combination to give you a shortcut to the application: position
the cursor under the Exchange icon which has appeared on the system screen,
select Menu - Apps - Assign button (or press Psi-A) and you can choose
a shortcut key combination.

Operation of the program should be self evident; if in doubt refer to
the help file. The program has only been extensively tested on a 1Mb Psion
3a - there are almost certainly undiscovered bugs and problems - if you
are first to find and report one I'll try and fix it and get a new version
to you.

No warranty is given or implied - you should always back up your data
regularly, use of the program is entirely at your own risk.

     (I use it regularly on my Psion without problems).


Text version of the help file:

=======================================================
Currency Exchange

=======================================================
Quick Keys
Change country     left: PsiQ   right: PsiP
Set sterling rate    left: PsiA   right: PsiL
   PsiS:  swap left and right country
Exchange rates
   PsiD:  set direct (non-sterling) exchange rate
   PsiC:  calculate rate from sterling rates
   PsiF:  reset to rates from data file
   PsiE:  edit data file EXCHANGE.DBF
Memory functions - arrow keys
   PsiUp / PsiDn:  select memory to use
   PsiRight:  save to memory   PsiLeft:  recall from memory
   Psi+ / Psi-:  add / subtract to memory
   Psi*:  multiply result by memory.
                   PsiR  Registration Info
                   PsiX  Exit programme


=======================================================
Memories
Eight memories are available and are shared with the
Psion Calculator application as M0 to M7.
Use the arrow keys with the Psion key (Psi) to 
select the memory and store or recall numbers. 
Psi+  adds the current result to the current memory
Psi-  subtracts from the current memory the result
Psi*  multiplies the result by the current memory

This last option is useful if you are converting prices
which do not include state tax. Store the tax rate in a 
memory (eg enter M0=1.06 in PsiCalc for a 6% rate) and 
press Psi* after each conversion to add the tax.

Results transfered to memory can be accessed in 
PsiCalc by entering the memory name (M0 to M7) 
in calculations.



=======================================================
Currency Data File
The country and currency details are stored in a
Psion Data file called M:\DAT\EXCHANGE.DBF.

If the data file is not found a new file will be created
containing UK, Germany and USA only with default values
for the exchange rates.

PsiE allows you to edit the data file, you can also
use the Psion Data application to edit the file. 

For each country the currency name, symbol (prefix 
or suffix) for the currency, and exchange rate to
the pound are stored.

Only the first five fields of each record are used 
by Exchange Calculator - you can add additional 
fields to store extra info if you wish, they will be
ignored by Exchange.


=======================================================
Exchange Rates
Currency exchange rates are stored in the data file
as rates to the UK Pound.  When converting between
two non-UK currencies the rate is calculated from
the two UK rates.  This calculation can be overridden
by setting a direct rate from the menu or key PsiD.

PsiA or PsiL allows you to set a new exchange rate to the
pound for the displayed currencies. When you alter 
the rate you can optionally save it to the data file.

PsiC recalculates the rate from the current pound rates
PsiF resets the rates to those in the data file.

Conversions are displayed rounded to 2 decimal places 
but are calculated using floating point precision.


=======================================================
Program startup
Until registered ExchangeCalculator always starts up 
set to convert Germany DMarks to Pounds Sterling at a 
rate of 3.00.

Once the program has been registered, it restarts in
the same state it was last used. 
NB This includes restoring any conversion rates in use 
but not saved in the file. Press PsiF to get back to 
the rates from the data file.


=======================================================
Preferences File
Entering a valid registration code creates a file
M:\OPD\EXCHANGE.PRF.  As well as the user details
this file contains the current setup (countries,
rates, and default memory).  The setup is restored
when the programme is restarted.

If EXCHANGE.PRF is corrupted or deleted the
registration details will have to be re-entered.

Please keep a note of your registration name and key.


=======================================================
Help File
         This help file is M:\OPD\EXCHANGE.RSC.  
It was created with Jezar at Psion's Help Compiler kit.
If you are short of space delete it. You will still be 
able to access the Help-About and Registration dialogs.


=======================================================
About Exchange Calculator
CrOsborne Currency Exchange Calculator for the
Psion 3a is copyright (c) Roger Creagh-Osborne,1998.
Exchange Calculator is Shareware for individual use, 
registration costs 10UK or $20US.
Current version is 3.1 dated July 1998
For latest version check
http://www.crosborne/demon.co.uk/psion.htm
Multiple licence enqires welcome, contact by eMail:
       roger@crosborne.demon.co.uk


=======================================================
Registration
You can register CrOsborne Currency Exchange
online through  RegNet (http://www.swregnet.com)
Alternatively send 10 (Ten pounds UK) cash or 
money order payable to: Roger Creagh-Osborne
at Colloggett Cottage, Landulph,
Saltash,  Cornwall, PL12 6ND, UK.
Specify your Psion username to be displayed on screen.
Registration key can be returned by email or post -
please include your return address.


=======================================================
Author & Programme
Roger Creagh-Osborne, CrOsborne Systems, Cornwall.
          eMail:  roger@crosborne.demon.co.uk
Exchange was written in OPL for the Psion 3a, it should
also work on Psion 3c. A Psion5 version is in preparation.


