                         "Monnaie" v.2.1.
                         ================


 
Scripts.
========
The following scripts are supplied:
- 3user.sco
- monnaie.sco

Copy them to an \sco\ directory. They are translated scripts,
which will run under the ReadCIS application, in conjunction with
ThreeCIS. Monnai.sco is "switch driven" in the same way as ThreeCIS.

The corresponding *.scr files are also supplied. You can copy them
to an \scr\ directory, read them and modify them, if you wish, with
the script editor (see your 3Fax or 3Link reference book).

3user.sco is called by ThreeCIS, when the "user.on" switch is
detected (see ReadCIS documentation on switches). The only function
of 3user is to call monnaie.sco. If you have already written your
own 3user script for another purpose, do not copy the supplied
3user.sco file, but modify your own to make sure that its final
module calls monnaie.sco.

Note on the scripts:
For the use of the script I recommend to set the session parameters
as suggested by Dennis Lefebvre in the ReadCIS documentation
(topic 3.1.1). Do not forget that these parameters must be setup
separately for each different network you are using for access to
CompuServe (I have been caught...).

To retrieve "CLOSING EXCHANGE RATES" from PA News Financial.
To automatically retrieve these exchange rates at your next
connection to CompuServe through ReadCIS, you must:
- start ReadCIS
- create a "user.on" switch
- create a "citynews.on" switch

After your next CompuServe connection, you will find a
"closing.txt" file in the \cis\library\ directory of your
default disk. Previous editions of this file are automatically
erased at each connection. If  you do not want to retrieve exchange
rates, toggle the "citynews" switch or the "user" switch off.

To import exchange rates from "closing.txt" into Monnaie.
Exchange rates in this file are in units per UK. You must do
the following from within Monnaie:
- "manually" adjust the exchange rate of UK against US$
  (Psion-U)
- set the UK as "home currency" (i.e. bring it to line 1). You
  can use the "Rotate" option of the menu (Psion-R).
- Set "Format for exchange rates" (Psion-P) to "units per UK".
  Current setting can be checked by pressing <Tab>.
- make sure that all the "currency strings" correspond to the
  strings in the "closing.txt" file (Psion-S to display all,
  Psion-Y to modify).
- press Psion-I
- select "closing" as the import file in the dialog box and
  press Enter.

To retrieve exchange rates from Global Report.
The monnaie.sco script can retrieve selected pages from the "Foreign
Exchange / Cross Rates / Menu" (page FXC/CRO/MEN) of Global Report
on CompuServe. Note that access to Global Report is not cheap (US$30
to 60 per hour). I strongly recommend the user to follow the script
as it runs, in order to crash-terminate it in case the dialog stops
for some reason, while the Global Report meter is still running (press
Esc and answer "yes" to terminate the script, then Psion-X or whatever
is required to logoff - check your "Comms" reference book in advance).
I will not accept any responsibility for a big CompuServe bill
resulting from an unended Global Report session...

To automatically retrieve exchange rates at your next connection
to CompuServe through ReadCIS, you must:
- start ReadCIS
- create a "user.on" switch
- create a "glo_rep.on" switch and toggle the "citynews" switch 
  off, if you had created one previously ("glo_rep" will be ignored
  if "citynews" is on)
- create one "glo_xxx.on" switch for each xxx/CRO/RAT page you wish
  to retrieve ("glo_mcu" for the MCU/CRO/RAT page, "glo_asi" for the
  ASI/CRO/RAT page,...), or a single "glo_all" switch to retrieve
  all pages listed in the script. 

After the next CompuServe connection, you will find a "glo_rep.txt"
file in the \cis\library\ directory of your default disk. The
glo_rep.txt file, which is included in the present package was
obtained with the glo_all switch on. Note that I have not included
a reference to all the pages of the FXC/CRO/MEN in my monnaie.scr
script. You can add more if you wish, either in the upper part of
the script (with corresponding tests on glo_xxx switches), or in the
lower part (controlled by the glo_all switch).

To import exchange rates from "glo_rep.txt" into Monnaie.
Exchange rates are in units per US$ (only the first column of Global
Report is used for import in Monnaie). You must do the following
from within Monnaie:
- set "Format for exchange rates" (Psion-P) to "units per US$"
- make sure that all the "currency strings" correspond to the
  strings in the "glo_rep.txt" file (Psion-S to display all,
  Psion-Y to modify).
- press Psion-I
- select "glo_rep" as the import file in the dialog box and press Enter.


Disclaimer of responsibility.
=============================
Users of Monnaie must accept this disclaimer of warranty:
"Monnaie is supplied as is. The author disclaims all warranties,
expressed or implied, including, without limitation, warranties of
fitness for any purpose. The author assumes no liability for damages,
direct or consequential, which may result from the use of Monnaie or
any of its accompanying files".


Acknowledgement.
================
The set of scripts supplied with Monnaie cannot be used alone.
They must be called by ThreeCIS or another connection software to
access CompuServe. ReadCIS and ThreeCIS are copyright material of
David Keppler and Dennis Lefebvre.

