Monnaie

Monnaie v.2.1e ================ Shareware for Psion S3a and S3c proposed by Guillaume Dupont CompuServe ID 100740,1033 e-mail:100740.1033@compuserve.com Introduction. ============= Instant conversion of an amount expressed in any currency of a list into all the other currencies. Handles up to 62 currencies simultaneously. Easy update of exchange rates,... Keywords: CURRENCY CONVERT CONVERSION FINANCE S3A S3C This evaluation version is fully operational, except for limitations on: - the format for input and display of exchange rates (fixed to "units per USD". The 3 other formats are not available) - the file import function (one exchange rate only is read) - the "preferences" menu (regions, decimals, line keys). Content. ======== The monnaie.zip file contains the following: - readme.txt is this documentation - changes.txt is a summary of major changes from the previous version - monnaie.opa is the application - monnaie.upd is a parameter file - monnaie.rat is a data file - monnaie.rsc is a help file - 3user.sco and monnaie.sco are scripts for the download of closing rates from PA News Financial (CompuServe, GO CIS:CITYNEWS), and for the download of some exchange rates from Global Report (CompuServe, GO CIS:GLOREP). Examples of the import text files which can be produced are attached. - 3user.scr and monnaie.scr are the corresponding source files. - closing.txt is a sample text file for import of exchange rates to Monnaie (from PA News Financial), produced with monnaie.sco. - glo_rep.txt is a sample text file for import of exchange rates to Monnaie (from Global Report), produced with monnaie.sco. Installation. ============= To install "Monnaie": - copy monnaie.opa to any \app\ directory - copy monnaie.rat, monnaie.upd and monnaie.rsc to an \opd\ directory on any disk (not a flash SSD). The 3 files must be in the same \opd\ directory. - install monnaie like any other Psion application (press Psion-I,..). To install version 2.1e if you had already installed a version of Monnaie older than 2.0: - delete existing monnaie.opo - copy monnaie.opa to any \app\ directory - replace the existing monnaie.rat, monnaie.upd and monnaie.rsc with the newly supplied files with the same names To install version 2.1e if you had already installed version 2.0 or later, simply replace monnaie.opa and monnaie.rsc with the newly supplied files. In all cases also replace 3user.sco, 3user.scr, monnaie.sco and monnaie.scr with the newly supplied files with the same names. In all cases the three files monnaie.upd, monnaie.rat and monnaie.rsc must be located in the same \opd\ directory. Operation. ========== Press "Enter" when the "Monnaie" icon is highlighted in the system screen. Once Monnaie is started, the <Help> key gives access to a fairly comprehensive instruction menu. It is strongly recommended, that you read the different help screens, if you want to get the full benefit of Monnaie. Monnaie.rsc is the help file. You can delete it once you feel familiar enough with the programme, if you need to save disk space. The <Help> key will then become ineffective. The menu options themselves, which are displayed when the <Menu> key is pressed, are self explanatory. In addition to these commands and their corresponding Psion+x short cuts, some "hot keys" are also available. See the corresponding Help page. Registration. ============= Monnaie is Shareware. You can use it freely during 14 days. After this period, if you find it useful, please register. Otherwise remove it from your computer. Registration fee is US$20.00. On CompuServe, you can register via SWREG (GO SWREG. Registration ID: 8418). Alternatively you can send US$20, GBP15, DEM30, CHF25, or FRF100 in cash by mail. Send bank notes, no checks. Do not forget to send your e-mail address with payment. Note that sending cash by mail is at sender's risk. My address is: Guillaume Dupont 25, rue Pauline Borghese 92200 Neuilly sur Seine France Upgrade from a previous version is free. Registered users receive a registration code by e-mail, which removes nagging screens and unlocks: - the file import function - alternative formats for the input and display of exchange rates - the "preferences" menu (regions, decimals, line keys). Scripts (for users of ReadCIS on CompuServe). ============================================= The following scripts are supplied: - 3user.sco - monnaie.sco Copy them to an \sco\ directory. These are translated scripts, which will run under the ReadCIS application, in conjunction with ThreeCIS. Monnaie.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 GBP. You must do the following from within Monnaie: - "manually" adjust the exchange rate of GBP against US$ (Psion-U) - set the GBP 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 GBP". Current setting can be checked by pressing <Tab>. - make sure that all the "currency strings" correspond to the strings in the "closing.txt" file (Press Diamond twice to display all, Psion-Y to modify). Ex: "Austria", "Belgium",.. - press Psion-I - select "Closing" as the import file in the dialog box and press Enter. - select "Tab1" as file type - select "...can contain spaces" for Currency strings - confirm the date and enter 1 as "first character for labels" and 20 as "first charater for values" 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). Here is the comprehensive list of switches readily available in the script, with the corresponding page codes and names (see the sample file glo_rep.txt for the corresponding currencies and their "currency strings"): glo_mcu MCU/CRO/RAT Major Currencies/ Cross/ Rates glo_esc ESC/CRO/RAT European Secondary glo_sea SEA/CRO/RAT Southeast Asian glo_asi ASI/CRO/RAT Asian glo_asc ASC/CRO/RAT Asia-Pacific Secondary glo_cam CAM/CRO/RAT Central American glo_sam SAM/CRO/RAT South American glo_eaf EAF/CRO/RAT East African glo_saf SAF/CRO/RAT Southern African glo_arp ARP/CRO/RAT Arabian Peninsula glo_mea MEA/CRO/RAT Middle Eastern 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). Ex: "Swiss Fr", "HongKg Dlr", "French Fr", "UK Stg",... - press Psion-I - select "glo_rep" as the import file in the dialog box and press Enter. - select "Tab1" as file type - select "...can contain spaces" for Currency strings - confirm the date and enter 7 as "first character for labels" and 20 as "first charater for values" 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. Last update 21 Sep 1997.