Readme
(english Readme see end of this file)


PM-Euro 1.75 fr OS/2 (Version vom 10.01.2002)


PM-Euro ist ein Whrungsumrechner fr OS/2.

Die Anwendung wurde fr den OS/2-Presentation Manager entwickelt und erfordert
eine Rexx-Laufzeitumgebung (bei OS/2 Warp 4 in der Standardinstallation bereits
vorinstalliert, bei OS/2 Warp 3 optional installierbar).


Installation

Entpacken Sie alle Dateien des Archivs (install.exe, pmeuro.exe, surfrexx.dll und readme.txt) in ein Verzeichnis und starten Sie das Programm

    INSTALL.EXE

Definieren Sie im Installationsprogramm ein Installationsverzeichnis fr PM-Euro. Ist das gewnschte Verzeichnis noch nicht vorhanden, so wird es vom Installationsprogramm erzeugt. Beispiel fr ein Installationsverzeichnis:

   c:\pmeuro

Geben Sie im Installationsprogramm auch die gewnschte Sprache an: Default ist "english" - Sie knnen jedoch auch "german" whlen.

Nach der Installation ist PM-Euro sofort arbeitsbereit.


Hinweise fr Updates

Sie knnen PM-Euro 1.75 ber bereits installierte ltere Versionen installieren. Ihre selbst angelegten Kurse gehen dabei nicht verloren.


Benutzung

Zunchst: Die Benutzung erfolgt auf Ihre eigene Gefahr. Bei der Entwicklung von PM-Euro
habe ich mich nach bestem Wissen und Gewissen an den EU-Verordnungen und
Bestimmungen zur Umrechnung zwischen den einzelnen Whrungen gehalten. Ich kann und
will aber nicht ausschlieen, da dennoch manche Umrechnungen mglicherweise nicht
korrekt gerundet sind. Bei meinen umfangreichen Tests fielen mir solche Flle allerdings
nicht auf.

Nach dem Programmstart finden Sie sich in einer Oberflche wider, die m. E. recht
intuitiv bedienbar ist.

ber zwei Listenfelder whlen Sie die gewnschte Ausgangs- und Zielwhrung aus.
Hier ist standardmig als Ausgangswhrung Deutsche Mark und als Zielwhrung US-Dollar ausgewhlt. Sie knnen beliebige andere Kombinationen auswhlen. ber das Men Sprache whlen Sie, ob Sie PM-Euro lieber mit deutscher Oberflche oder englischer Oberflche benutzen. Standard ist englisch. ber das Hkchen "Sichern" markieren sie die Einstellungen (Ausgangs- und Zielwhrung, Anzahl der Dezimalstellen (siehe weiter unten), Auto-Kopie (siehe weiter unten) sowie die Sprachversion) zum Speichern. Das Speichern der Einstellungen erfolgt beim Beenden des Programmes. Beim nchsten Start wird PM-Euro dann diese gespeicherten Einstellungen als Standard verwenden.

Geben Sie im Eingabefeld der Zeile "Von" einen gewnschten Wert ein. Als Dezimal-
Trennzeichen knnen Sie Punkt (".") oder Komma (",") verwenden. Geben Sie flsch-
licherweise alphanumerische Werte ein, erhalten Sie beim Versuch, diese umzurechnen
einen Fehlerhinweis.

ber den Button "Umrechnen" rechnen Sie den Betrag der Zeile "Von" in die Whrung
um, die in Zeile "Nach" definiert ist. Dieser Button wird standardmig auch stets durch
Drcken der RETURN/ENTER-Taste ausgelst - auch wenn Sie sich noch im Eingabefeld
zur Eingabe der Ausgangswhrung befinden. (Achtung: Durch die in PM-Euro 1.6 eingefhrte "Type & Calc" Funktion knnen Sie auch definieren, da PM-Euro sofort bei der Eingabe eines Wertes umrechnet. In diesem Falle ist der "Umrechnen" Button nicht sichtbar)

Nachdem Sie den Wert umgerechnet haben, knnen Sie durch Anwahl einer anderen
Zielwhrung sofort den Betrag in die neue Zielwhrung umgerechnet bekommen. Ein 
weiterer Druck auf den Button "Umrechnen" ist nicht mehr notwendig. Der Ausgangs-
Betrag bleibt davon unberhrt. Ebenso knnen Sie die Ausgangswhrung durch Selektion
im Listfeld der Zeile "Von" ndern: Der Zielbetrag wird entsprechend angepasst. Auch in
diesem Falle gilt: Der Ausgangswert verndert sich nicht. Aus 10.20 DM wird also nach
nderung der Whrung von "Deutsche Mark" auf "Italienische Lira" 10.20 Lira!

Gem den Bestimmungen der Europischen Gemeinschaft wird der Zielbetrag 
standardmig stets auf zwei Nachkommastellen auf- oder abgerundet. Sie knnen 
wahlweise auch die Angabe des Betrages mit 6 Nachkommastellen auswhlen. Diese 
Einstellung nehmen Sie im Men "Einstellungen" vor. Die Einstellung fr die Anzahl 
Nachkommastellen wird gespeichert, wenn Sie das Hkchen "Sichern" im Men "Einstellungen" aktiviert haben.

Neu in Version 1.3 ist die Funktion Auto-Kopie. Ist diese Funktion aktiviert, wird nach
der Umrechnung der Zielbetrag automatisch in die Zwischenablage bernommen. Damit
haben Sie es sehr einfach, den umgerechneten Betrag in anderen Anwendungen, zum
Beispiel Ihrer Textverarbeitung, einzufgen. Aktivieren und Deaktivieren knnen Sie diese
Funktion im Men Bearbeiten.

Neu in Version 1.4 sind folgende Funktionen:

- Auto-Clip: ber Bearbeiten/Auto-Clip aktivieren Sie diese Funktion. Sie veranlasst
  PM-Euro, beim Programmstart den aktuellen Inhalt der Zwischenablage in das Programm
  einzufgen und - falls es sich um einen numerischen Wert handelt, direkt in die
  voreingestellte Zielwhrung umzurechnen. In Verbindung mit Auto-Kopie haben Sie damit
  eine sehr ntzliche Funktionskombination: Eine Zahl in der Zwischenablage wandeln 
  Sie so sehr schnell um und haben nach Start des Programmes sofort den Zielwert in 
  der Zwischenablage.

- Schriftarten speichern: Sie knnen im Hauptfenster von PM-Euro die Schriftart ndern.
  ffnen Sie dazu die OS/2-Schriftartpalette und ziehen Sie die gewnschte Schriftart
  per Drag-and-drop auf die Schaltflche "Umrechnen". Aktivieren Sie dann die Funktion
  "Sichern" und die gewhlte Schriftart wird gesichert. Beim nchsten Programmstart
  erscheint das vollstndige Hauptfenster (nicht nur die Schaltflche "Umrechnen") in der
  nun vordefinierten Schriftart.

- Die Kurse der elf Euro-Teilnehmerlnder knnen nun nicht mehr editiert werden. Das 
  machte bisher auch wenig Sinn, da diese Umrechnungskurse definitiv fest sind und sich
  niemals ndern werden. Da sie nun nicht mehr verndert werden knnen, haben Sie im
  Eingabefeld fr die Kurse (Einstellungen/Kurse) mehr Platz fr Nicht-Euro-Whrungen
  (wie z. B. US Dollar oder andere Fremdwhrungen).

Bei der Umwandlung von Whrungen wird darber hinaus stets - gem den EG-
Bestimmungen - ber Euro gerechnet. Bei der Umrechnung von Deutsche Mark nach 
Franzsische Franc wird also zunchst der Euro-Betrag ermittelt, dann erst der Betrag
in Franzsischen Franc. Angezeigt wird nur der End-Betrag in Franc.

Das Programm liefert die Whrungen der gegenwrtigen elf Euro-Teilnehmerlnder mit, die Kurse basieren auf den amtlichen Bekanntgaben vom 31. Dezember 1998. Sie knnen die Kurse beliebig auf neuere Umrechnungskurse anpassen, indem Sie ber den
entsprechenden Dialog ber das Men Einstellungen/Kurse aufrufen und dort die nderungen vornehmen und Speichern. PM-Euro erlaubt auf diese Weise die Erfassung und Nutzung von bis zu 24 Whrungen. Sie knnen auch Nicht-Euro-Whrungen, zum Beispiel US-Dollar, verwenden. Geben Sie dazu jeweils den aktuellen Kurs zum Euro ein.

Neu in Version 1.41:

- Rechengenauigkeit verbessert (betrifft Werte grer 1.000.000.000)

Neu in Version 1.5:

- Ein weiteres drittes Wertefeld gibt stets den Wert in Euro an. Wenn Sie also etwa DEM nach USD konvertieren, so zeigt Ihnen das dritte Feld zustzlich immer auch den Wert in EUR an.

Neu in Version 1.6:

- Type & Calc: Diese Funktion knnen Sie im Men "Einstellungen" aktivieren. Sie ermglicht das sofortige Umrechnen der Whrungen schon bei der Eingabe des Wertes. Ist diese Funktion aktiviert, so ist der "Umrechnen" Button nicht sichtbar, da dieser nicht bentigt wird.

- Online-Update: Im Fenster "Kurse" knnen Sie nun - wenn eine Internet-Verbindung besteht - online die Kurse aktualisieren. Diese Online-Aktualisierung bercksichtigt folgende Nicht-EURO-Whrungen:

   US Dollar
   Australian Dollar
   UK Pounds
   Canadian Dollar
   Japanese Yen
   Swiss Francs

Beachten Sie, da die ersten sechs Whrungszeilen im Fenster "Kurse" (diese sechs Zeilen sind dunkelgrau hervorgehoben) fr diese Whrungen vorbehalten sind. Bei einer Online-Aktualisierung werden immer diese sechs Zeilen mit den aktuellen Werten aufgefllt.

Neu in Version 1.7:

- Einige Detailverbesserungen und Fehlerroutinen

- Auto Update: Mit dieser neuen Funktion, die Sie im Wechselkurs-Dialog finden, veranlassen Sie PM-Euro, die vom Online-Update bercksichtigten Kurse regelmig automatisch zu aktualisieren. Dabei definieren Sie den Zeitabstand zwischen zwei Aktualisierungsdurchgngen zwischen 1 und 60 Minuten.

Neu in Version 1.72:

- Korrigierte Online-Update-Funktion

- URL-Objekt zu finance.yahoo.com

Neu in Version 1.75:

- Option ", als Dezimaltrennzeichen" ermglicht es, den umgerechneten Betrag stets mit Komma als Dezimaltrennzeichen ausgegeben zu bekommen - unabhngig vom Format des eingegebenen Ausgangsbetrages. Standardmig ist diese Option nicht aktiviert. Sie kann durch Auswahl von Einstellungen/", als Dezimaltrennzeichen" aktiviert oder deaktiviert werden. Der Zustand wird beim Programmende gespeichert, sofern die Sicherungsfunktion (Einstellungen/Sichern) aktiviert ist.


Hinweise

PM-Euro 1.75 ist Freeware, das uneingeschrnkte Copyright liegt bei Carsten Mller (c) 1998-2002. Sie knnen das Programm im Originalzustand (pmeuro.zip mit den Dateien pmeuro.exe, pmeuro.ini, pmset.ini und readme.txt) beliebig weiter verbreiten.

Hinweise zu Updates, neuen Versionen und weiteren Programmen aus meiner Feder erhalten Sie auf meiner Homepage im Internet:
http://www.warphouse.de

Bei Fragen, Problemen oder Anregungen wenden Sie sich bitte an mich:
Per E-Mail cm@cmweb.de



Readme ENGLISH


PM-Euro 1.75 for OS/2 (Version as of january 10, 2002)

PM-Euro is a Currency calculator/converter with EURO (EUR) capability.

You can use this program to convert a currency value into another currency or to and from the new unique european currency EURO (EUR).


Installation

Please unpack the archive pmeuro.zip and copy the files pmeuro.exe, install.exe, surfrexx.dll and readme.txt into a directory. Run the setup program by entering

    INSTALL.EXE

Define a target installation directory in the setup program, i. e. "c:\pmeuro" and select the language: Default is "english", but you can also select "german".

After the setup program is finished, PM-Euro is ready to work. 


Updating from previous versions

If you're updating from a previous version of PM-Euro, you can continue to use your own
old exchange rates. You only have to replace the files pmeuro.exe and pmset.ini. The file
pmeuro.ini which contains your personal exchange rates and currencies can stay as it is.



Using PM-Euro

After starting PM-Euro, you see the main program window which comes default with
an english user interface. You can switch to german language by selecting "Language"/
"German".

You have to list boxes to select source currency and target currency. Default is "German Mark" as source currency and "US-Dollar" as target currency. You can use any other combination of currencies to convert to and from.

You can change this default settings (source and target currency, numbers of digits (see
details about this feature below), Auto-Copy (see below) and user interface language) by selecting the "Save" check box in the main program window. These settings will be 
stored during program's exit. If you start PM-Euro again, it will show these selected 
settings.

After selecting source and target currency, enter the source amount into the entry field.
Select "Convert" to convert the source value to the target currency. After doing this, you
can easily change target or source currency by changing the entry of the list boxes. You 
will see that PM-Euro converts "on the fly" both amounts to the new combination. The
button "Convert" is set to the default button, which means that it always will be selected
by pressing ENTER or RETURN. If you are entering the source currency amount, you can
simply press RETURN to convert the value to the target currency value.

To convert currency amounts, PM-Euro uses the official restrictions of the European
Community.
This means: If you - for example - want to convert "German Mark" (DEM) to 
"French Francs" (FRF) , PM-Euro first converts the DEM value to EUR. After that, 
EUR value will be converted to FRF. You only see the end value in FRF. As by default
settings, all target value will be shown rounded to 2 digits. If you prefer using 6 digits,
you can simply select this in the "Settings" menu. This setting will also be stored when
the "Save" checkbox in the "Settings" menu is checked.

New in version 1.3 is the feature Auto-Copy. It provides you to automatically copy the
target amount into the OS/2 clipboard. Using this, it's easy to insert the new amount into
other applications, such as your word processor software. You can activate/deactivate
Auto-Copy with selecting Edit/Auto-Copy. The status of the Auto-Copy feature will also
be stored when the "Save" checkbox is checked.

New in version 1.4 are the following features:

- Auto-Clip: It enables PM-Euro to automatically take the current clipboard value to insert
  in the "From" entry field of PM-Euro during by starting the program. In combination 
  with the function Auto-Copy you have a powerful feature to convert automatically the
  clipboard value (if it is a number format) to the target amount/currency and you will 
  receive the target amount automatically in the clipboard. This feature will be set/unset
  with Edit/Auto-Clip and will be saved when the "Save" checkbox is activated.

- Font changing: You now can change the font of the main program window. Just open 
   the OS/2's font palette and drag-and-drop the font you want to use to the "Convert" 
   button of PM-Euro. Activate "Save" function and close PM-Euro. After restarting   
   PM-Euro the new font will be shown on the whole main program window (not only on 
   the "Convert" button!).

- The exchange rates of the eleven Euro member currencies can no longer be edited. In
  the exchange rates window (Settings/Exchange rates) you now have place for 24
  additional non-Euro currencies, such as US Dollar or other foreign currencies.
  Please note: In previous versions it didn't make sense to change the exchange rates of
  Euro member currencies, because these values are as they are and will never change
  until the Euro is the one and only currency from year 2002 on. So you have no lack of
  features that PM-Euro 1.4 doesn't allow changing these rates.

New in version 1.41:

- Fixed problem regarding very big values (bigger than 1.000.000.000)

New in version 1.5:

- A third field will always show the value in EUR currency. For example, if you convert DEM to USD, this third new field will additionaly show the value in EUR.

New in version 1.6:

- The "Type & Calc" feature. You can find it in the "Settings" menu. If this feature is enabled, PM-Euro calculates the target currency value immediately during you enter the source value. If this feature is enabled, the "Convert" Button is hidden.

- Online-Update: On the exchange rates screen you now can run an online update to update the rates of the following Non-EURO-currencies:

   US Dollar
   Australian Dollar
   UK Pounds
   Canadian Dollar
   Japanese Yen
   Swiss Francs

New in version 1.7:

- Some error correcture routines

- Auto Update: You will find this new feature within the exchange rates dialog. This feature forces PM-Euro to automatically update all the currencies which are included in the Online-Update feature. You can define a time frequence for this feature between 1 and 60 minute(s).

New in version 1.72:

- fixed bug in online update

- URL object for finance.yahoo.com

New in version 1.75:

- New option ", as decimal separator". If this option is activated (default: not activated), PM-Euro uses "," instead of "." as decimal separator to format the target value. This option setting will be stored at program exit if the Save option is activated (Settings/Save).


Please note, that the first six lines in the exchange rates dialog are reserved for these currencies. During every online update, these six lines will be updated. Please note: For this feature to work, an internet connection has to be established first.

As far as I experianced PM-Euro is calculating correctly, using the EG-restrictions to 
convert currencies. However, I don't give any guarantee. Could be that in some cases the
calculation may not be absolutely correct. I hope not and as far as I see, such problem doesn't exist. But again, no guarantee.

PM-Euro allows you to change the exchange rates and to add new ones.
After installing, you will have the currencies and quotations of all EURO member countries 
with their official quotations as announced on december 31, 1998 by the European 
Community. If you want change a quotation or currency or add a new one, you have to select "Settings"/"Exchange Rates". You also can use other currencies than 
EURO-member currencies. For example: To use US-Dollar, simply add US-Dollar and it's 
actual exchange rate in the Settings/Exchange Rates dialogue.


PLEASE NOTE

PM-Euro 1.75 is freeware, but copyrighted 1998-2002 by Carsten Mller. All rights 
reserved. The program may be distributed as is, including all original files without any
changes or additions.

Check the author's homepage for information about new versions and updates and to find
information about more Carsten Mller's Warphouse Software programs. The URL is:
http://www.warphouse.de

For questions and suggestions, please contact the author via E-Mail:
E-Mail: cm@cmweb.de
