                           ST Exchange
                          -------------
                      From Edtrad Computers
                       Programmed by: NED
                         12th July 1989
                    Distributed by ST User.


                          Introduction
                         --------------

     ST Exchange is a clever little program which can help you to 
make your fortune by buying and selling currencies.
     Wow!  You say but how?  Well, first of all you must maintain 
a database of all the various exchange rates you are thinking  of 
investing  in.  The  program  allows you to plot  graphs  of  the 
data  on the database and do fancy things with it  to  facilitate 
the prediction of good buy and selling points.
     The  program has been designed to work in  pounds  sterling, 
this means that when you type in your data you type in the  pound 
against the US Dollar, pound against the swiss franc etc...  This 
doesn't mean that you can't use any other currency,  you can! The 
only  trouble is that the program will get the headings mixed  up 
in some cases. 



                        Using ST Exchange
                       -------------------
     I  think before I go into detailing any of the menu  options 
it is necessary to mention certain essential concepts which  must 
be grasped before you use this program.

     1. The whole program relies on a database which contains the 
data.  This data should be updated at REGULAR intervals using the 
update  option  on ST Exchange.  If the database  is  updated  at 
irregular  intervals you will get a distorted graph which may  be 
misleading. I find that updating once a month is sufficient for a 
general  trend,  but for more accurate graphs updating should  be 
performed once a week (or even once a day if you are keen!).  You 
must  remember that the more data items there are the longer  the 
data  will take to be read or updated.  If you update once a  day 
for  two years you will have about 600 entries,  although  a  3.5 
inch floppy can hold much more than this you may get annoyed with 
the time it takes to read the data, here a hard disk is useful.     

     2.  You have a unit currency. This is the currency which the 
computer works in.  If you are unsure about what I mean by a unit 
currency then consider this:

     1=234 Yen
     1= $1.4
     1= 63 Belgian francs
     ...etc....
                              Here  your unit currency is  always 
.

 

     3. ST Exchange is designed to work off floppy disk A using a 
folder called STEXCHANG in the root directory. If you have a hard 
disk  you  can  change the drive and folder it  works  in  but  I 
suggest  that  for floppy disk users wishing to use  ST  Exchange 
that  they  copy  the STEXCHANG.PRG into the  root  directory  on 
another  disk and then create a folder called STEXCHANG  in  that 
root directory. 
     4.  Throughout ST Exchange you will be asked for the name of 
your data file. You will get a list like this:
A:\STEXCHANG\

$    .INF           YEN       .INF           BF        .INF
SF   .INF           LIRA      .INF           FF        .INF


     When  asked for the name of your file you must NOT  type  in 
the extension (this is the .INF or in some cases .BSM). So if you 
wanted  the Belgian Franc (file name BF) you would only type  bf. 
It does not matter if you type the name in capitals or not. 
     


                       Loading ST Exchange
                      ---------------------

     To  load ST Exchange double click on the STEXCHAN.PRG  icon. 
When  it has loaded,  you will be presented with a page  of  text 
telling you about the program and crediting the programmer etc... 
Press  any  key to get down to the serious  stuff.   If  you  try 
running  the  program  in low res you will be  presented  with  a 
dialogue box telling you that the program will not work very well 
in this resolution.  You can click in OK if you wish to brave the 
result.{Typical problems with doing this are:   Messed up  menus, 
data  scrolling  off the screen and very short headings  for  the 
graphs.  ST  Exchange will plot a perfectly presentable graph  in 
low  res  however.}   If you wish to change to  a  more  sensible 
resolution (recommended!), medium or high then click in quit.



                        Using The Options
                       ------------------- 


     1. Read and plot a file.

          This option allows you to plot the data which you  have 
put onto the disk.  The program prints the data EXACTLY as it was 
typed  in,  the  only thing to look out for is that  the  program 
magnifies the graph so the X axis is at the minimum value. 
          To  select  this option you must press 1  on  the  main 
menu.  All the available files to plot are listed.  You must type 
in the file's name which you want to plot. The computer will read 
the data and plot the graph.  You may press any key to return  to 
the main menu or press P to print {do a screen dump} the graph on 
an  Epson (or compatible) printer.  You may need to set  up  your 
printer  using  the  control panel  accessory,  the  ST  Exchange 
program  does  not use any menu headings so you  can't  use  desk 
accessories  in the program but you may set up  your  preferences 
using the control panel and then load ST Exchange.  By saving the 
desktop you make these settings selected on the control panel  be 
the  default settings on booting,  thus eliminating the need  for 
the control accessory to be present all the time.
     

     2. Make a file.
          This  option allows you to create a new  exchange  rate 
file.  When  you  select this option (by pressing 2 on  the  main 
menu)  you will be asked for the number of data  items.  (If  you 
press 0 you will return to the main menu) If you enter 1 you will 
be  told that you can't plot this graph.  This is for the  simple 
reason  that  the computer needs at least 2 points  (2  items  of 
data) before it can plot a line. You data will be save though for 
future update. 
          The computer will list the current files.  This is  not 
so  you can type in one of the listed names.  No!  what  you  are 
meant to do is to avoid using one of the existing names.  If  you 
do  type  in a name of a file which already exists  you  will  be 
given  the option to Cancel or Overwrite (Replaces the  old  file 
for the new one)
          You  will then be asked for the multiplier.  This is  a 
constant  which the computer uses in option 7.   Most  currencies 
are measured per 1 unit, however the Lira for example is measured 
per thousand, so here the Lira's multiplier would be 1000 but the 
$  would be 1.  The multiplier does not affect the shape  of  the 
graph in option 7 but does affect the Y axis labelling.
          When  you have entered all this you will be  asked  for 
the data items.  When all this is done the ST will save the  data 
onto the disk and you may press any key to return to the menu.


     3. Update a file by 1 entry.
          This option is designed for your regular update,  where 
you  only want to add one item.  When you select this option  (by 
pressing  3 surprisingly enough!) you will be asked for the  name 
of the file to be updated.  Your possible selections are  listed. 
When you have done this the data entered so far is listed and you 
will be asked for your new data item.  The file will be saved and 
the new graph plotted.


     4. Amend Buy/Sell markers.
          This option is selected by pressing 4. It allows you to 
place  little crosses on your graph at various places  indicating 
where  you bought that currency so that you may then see when  it 
is a sensible time to sell.  You may have as many markers on your 
graph  as you have data items.
          Upon selection your screen will display a second  menu. 
This allows you to select one of 3 options. You may:

1. Put a marker on a specific file.
2. Remove all markers on a specific file.
3. Return to the main menu.

          On  selecting  1,  the ST will list all  the  available 
files  to  for plotting.  You must type in one  of  these  file's 
names.   The  rest is very well explained but just for those  who 
need extra help I will more or less repeat what you will be told.
            You  will be told how many data items there  are  and 
will be asked upon which data item should a cross be put. You are 
told  that the most distant item is 1 and the most  recent  being 
the number of data items.  Below is a worked example:


The file YEN contains 52 data items.
Please type in the data item number upon which a
X will be put.
The most recent being 52 and the most distant
being 1 

           If  we wanted to place a cross on the very  last  data 
item  ie  the end of the graph you would type 52 (the  number  of 
data  items)
           If you wanted a cross on the  very  first 
data item (where it touches the Y axis) you would type 1
           If  you wanted a cross on the second to last  (Not  the 
very last but the one behind it) you would type 51


          The computer will create a separate file which contains 
the  crosses  data,  you may notice a slight lack in  speed  when 
updating and plotting files which have crosses on them,  this  is 
normal.
     If  you select 2 then you will be asked which file you  want 
to  remove.  You  may notice that not all the files  are  present 
here.  This is because you are only deleting a files crosses data 
not  the actual file itself,  so the ST need only list the  files 
with crosses data files.
        You  will  be  asked  to confirm your  delete  as  it  is 
important data. After that it will be too late!
         This option's recommended use is for when you have  sold 
your  currency  and no longer need to have silly  little  crosses 
cluttering up graph which have no practical use.
          The third option is very simple indeed.  All it does is 
return you to the main menu.


       5. Update a file by 1 or more entries.
          This   option  (selected  by  pressing  5)  is   almost 
identical to option 3 except that you are asked for the number of 
data items you want to add. This option was included for when you 
miss an update (when you are on holiday, for example) and need to 
type in several items. Apart from this you should find it similar 
to option 3.


     6. Remove a file.
          This  option  is selected by pressing  6,  it  destroys 
(removes  actually!)  data files.  It is useful  when  a  country 
discontinues its currency (not very likely!) or when you give  it 
up for various reasons. (One may be when you realise it is a dead 
loss!)  
          You will be asked which,  from the usual selection,  of 
the data files should be removed.  You select this as normal. You 
will  then be asked if you are sure that you want to  remove  the 
file as all its contents and crosses data will be  removed.  When 
you click on Go ahead it will be too late. You have been warned!


     7. View a graph with another currency as its base.
          This is the nifty part of the program as it allows  you 
plot a graph of 2 currencies against each other.  
          On  option 1 all you see is the pound against this  and 
the  pound  against that,  but it is sometimes  interesting  (and 
useful)  to see how different currencies have done against  other 
currencies.   This  would  normally  require  you  buying  a  odd 
newspaper and typing in lots of numbers.  Not a satisfactory  way 
of  doing  this.  However you have the data there on  your  file! 
Providing you have at least 2 data files you can use option 7. If 
you are confused then consider the following:

You have 3 data files called:

$
YEN
LIRA

You  can always plot all three against the pound as normal  using 
option 1 but using this option you can do the following:

Plot the $ against the YEN!
Plot the YEN against the LIRA!
etc....etc....etc.

     Here we must understand what a Unit and Target currency are. 
I have already explained Unit to you before but I will again  for 
clarity.   Consider the following:

                      1=65 Belgian Francs

Here  the  1 is the UNIT currency and the Belgian Franc  is  the 
TARGET currency. But here:

                           $1=180 YEN  

Here  the  $1  is the UNIT currency and the  YEN is  the  TARGET 
currency. 

     You  will be asked for the target and unit currencies  which 
you  want to see displayed against each other.You  must  remember 
beforehand which files you have,  as the available files are  NOT 
listed.  After doing this the computer's disk drive will buzz for 
a while and hey presto there is the graph.   Amazing Eh?  You may 
press P to print it or any other key to exit


     8. View a synthesised graph of many currencies.
          This  option  should  be renamed as  the  Nigel  Lawson 
killer  option!   What it does is it plots a graph showing how  a 
selection  of currencies have done against the  pound. 
          When  you  select this option (by pressing  8  surprise 
surprise!)  you will get a list of all the data files  you  have. 
But just to keep you on your toes you are asked how many files to 
plot.  This  is  so  you can select which  currencies  should  be 
averaged and plotted. Having done this you will be asked the name 
of the data files.  Just to make life really difficult, after you 
have  entered  your first item the computer checks the  name  and 
then prompts you for option 2, you will find that some of the old 
name and the checking message are still there,  don't worry! Just 
carry  on typing as normal.  The reason for this is to  stop  the 
available files from scrolling off the top of the screen.
     Once  all  this has been done,  your friendly ST  will  show 
which  file  it  is processing just to show  it  hasn't  crashed!  
Once  this  has been done the graph will be plotted and  you  may 
press P to print it or any other key to exit.


     9. Change drive and folder setting.
          This  option is selected using 9.  It is  intended  for 
hard disk users to specify which drive and which folder they wish 
to work from.  The prompts are very comprehensive so I don't need 
to go any further. 



     S. Exit this amazing program.
          This  option is selected by pressing S and  throws  you 
back into desktop.


                             Errors
                            --------

     I  have  spent about one and a half  years  developing  this 
program, testing it and making improvements.  I have tested every 
option and they all work. I cannot guarantee that this program is 
bug  free  but  I can assure you that so far no  bugs  have  been 
found.  There are error checking routines in the program; the two 
errors it does detect are disk full and file not found. Any other 
error means that something has gone drastically wrong and your ST 
will  inform you about it and throw you into desktop.  One  error 
may be a lack of memory;  this will create a error number  7.  If 
you  get  this you must remove any desk  accessories  before  you 
retry.       Although  untested,  the program should work on  any 
kind of ST with either new or old TOS.



                          Hints & Tips
                         -------------- 

     You may find that you want to neaten up your graph using  an 
art  package  or put the graph into a  DTP  program.  Although  I 
haven't  provided  any option to save the screen you  may  use  a 
snapshot  program (found in every public domain library). 
     There  are  a couple of example data files for you  to  mess 
around with.




     I  hope  you find this program useful and will help  you  to 
make   a  more  intelligent  decision  when  buying  or   selling 
currencies.  However I take no responsibility for any money  lost 
as a result of using this program.

                            Have Fun!  

                              NED
                     (Nicholas Ekins-Daukes)

