V 1.1 : Bugfix : Trap D bei nicht gefundener Sig-Datei
Bugfix : 60h Problem beseitigt
V 1.2 : Workaround für 49 Tage Problem implementiert
V 1.3 : manuell setzbarer Tages-Offset implementiert
frei konfigurierbarer Ausgabetext in der jeweiligen Landessprache
Achtung : die Aufruf-Parameter werden dem Programm jetzt über eine externe Konfigurationsdatei mitgeteilt!
V 1.4 : Zeile des Meldetextes in der Sig-Datei ist jetzt frei wählbar
XUpdSig.EXE hinzugefügt
V 1.5 : XUpdSig Fix : die Umgebungsvariable musste eine der ersten 32 sein, sonst wurde sie nicht erkannt.
V 1.6 : kleines Bugfix in XUpdSig
V 2.0 : völlig frei konfigurierbarer Meldetext
Was ist UpdSig?
===============
Das kleine Tool UpdSig ergänzt bzw. aktualisiert in einstellbaren Intervallen bis zu 10 verschiedene Signaturdateien für Mailer/Newsreader um die Zeile :
>This OS/2 system uptime is 0d 5h 23m 45s 437ms (en).
>Der gesamte Meldetextes kann frei gewählt werden. Der Zusatz »(en).« ist die interne Kennung, anhand derer UpdIni die Position des Meldetextes innerhalb der Signaturdatei erkennt und daher leider unverzichtbar.
Ich habe es geschrieben, damit wir alle auf unkomplizierte Weise in den Genuss dieser kleinen Spielerei kommen. Die Verwendung von REXX-Scripts in Verbindung mit weiteren externen Tools schien mir etwas zu aufwändig.
Was ist XupdSig?
================
Dieses Tool hat den gleichen Effekt, geht aber andere Wege.
Manche Newsreader und Mailer, wie z.B. PMiNews und PMMail erlauben es, dass eine Nachricht noch vor dem eigentlichen Versenden mit einem Rexx-Script oder einem EXE-File bearbeitet werden kann. Genau das macht XupdSig.
Vor dem Versenden einer Nachricht liest XupdSig die komplette Nachricht ein und ergänzt an der durch einen Platzhalter markierten Stelle die Uptime Message.
Vorteil :
das Programm läuft nicht ständig im Hintergrund, sondern wird nur dann gestartet, wenn es auch wirklich benötigt wird. Dadurch lassen sich z.B. die Platten auch wieder abschalten. Außerdem stimmt die Uptime immer genau.
Nachteil :
kein Workaround für das 49 Tage Problem möglich. Die vollständige Nachricht und nicht nur die Signatur wird gelesen.
auf alle anderen Spielereien habe ich verzichtet.
Die Kommandozeilen-Parameter
============================
gibt es nicht mehr. Statt dessen erwartet das Programm eine Textdatei namens UPDSIG.CFG, die im gleichen Verzeichnis wie UpdSig.EXE liegen muss. Beispiel für den Inhalt der Datei :
;Messagetext :
>MessageText =This OS/2 system uptime is %u days %2u:%2u hours and %2u seconds
; Timing descriptions :
UpdateInterval = 600
OffsetInDays = 123
;all the signature files, paths included
;one line per file, max. 10 lines
e:\internet\myreader\myreader.sig
e:\internet\mynews\mynews.txt
Zeilen, die mit einem ";" beginnen, sind Kommentarzeilen.
In diesem Beispiel würden im 10 Minuten (600 Sekunden) Rhythmus die Signaturdateien des Mailers und des Newsreaders aktualisiert.
Gleichzeitig geht UpdSig davon aus, dass das System bereits 123 Tage ununterbrochen in Betrieb ist und addiert diesen Offset hinzu.
Da UpdSig vollkommen im Hintergrund arbeitet, kann keine Ausgabe auf dem Bildschirm erfolgen. Sollte UpdSig eine der Signaturdateien nicht finden können, werden Sie lediglich durch einen kurzen Piepser auf diesen Fehler aufmerksam gemacht. In diesem Fall wird das Programm beendet.
>Der Meldetext
>=============
>
>Das Programm schreibt die Angaben für Tage, Stunden, Minuten, Sekunden und Millisekunden an vorher durch Platzhalter im Meldetext festgelegten Stellen, und zwar genau in dieser Reihenfolge, die auch nicht geändert werden kann. Haben Sie als Meldetext etwa :
>This OS/2 system uptime is %ud %2uh %2um %2us %3ums
>angegeben, so erhalten Sie genau die in der Version 1.x ausgegebene Mitteilung. Ein Parameter wird also durch %u angegeben. Die Zahl zwischen % und u gibt dabei die Feldbreite an. Hat die auszugebene Zahl weniger Stellen, als in der Feldbreite angegeben ist, so wird die Eintragung mit führenden Nullen aufgefüllt.
>Die Angabe von %d überspringt einen der Parameter, wenn Sie also nur Stunden und Minuten ausgeben wollen, wäre folgende Angabe möglich :
> This OS/2 system is running for %d%2u:%2u hours
>In der Datei UpdSig.Cfg finden Sie das (fast) vollständige Syntax-Diagramm in EBNF, wo Sie weitere Details entnehmen können.
Die Installation von UpdSig
===========================
Die Installation ist denkbar einfach.
Kopieren Sie einfach UpdSig.EXE und UpdSig.CFG in ein beliebiges Verzeichnis Ihrer Festplatte. Anschließend passen Sie die Datei UpdSig.CFG Ihren Bedürfnissen an und ergänzen dann entweder die CONFIG.SYS um die Zeile
run=drive:\path\updsig.exe
drive steht für das Laufwerk und path für den Pfad, in den Sie UpdSig kopiert haben.
oder Sie erzeugen sich ein Symbol im Systemstart-Ordner.
in diesem Fall werden Sie allerdings nach dem Start ein Symbol auf der Arbeitsoberfläche erhalten.
Soll UpdSig auf einem bereits laufenden System gestartet werden, so können Sie in einem OS/2 Fenster folgende Befehls- zeile eingeben :
detach drive:\path\updsig.exe
Normalerweise fügt UpdSig beim ersten Start die Uptime Meldung hinter der letzten Zeile der Signaturdatei an und aktualisiert sie dann dort in dem angegebenen Zeitintervall.
Wenn die Meldung an anderer Stelle erfolgen soll, z.B. als erste Zeile, so bearbeiten Sie einfach die Signaturdatei mit einem Texteditor und verschieben Sie die Uptime Zeile an die gewünschte Position. UpdSig wird künftig die Uptime Meldung an dieser Stelle aktualisieren.
Die Installation von XupdSig
============================
Das hängt von dem verwendeten Mailer/Reader ab. Ich will hier nur kurz am Beispiel von PMMail erläutern, wie es geht :
Zunächst kopieren Sie XupdSig.EXE in einen beliebigen Pfad, der PATH-Statement der CONFIG.SYS eingetragen ist, am einfachsten nach X:\OS2\APPS. Der Meldetext lautet standardmäßig :
>"This OS/2 system uptime is 3 days 04:37 hours"
Dieser Text kann beliebig geändert werden, indem Sie eine Environment-Variable in der CONFIG.SYS definieren :
>SET XUPDSIG=Ihre eigene Meldung (siehe Abschnitt "Meldetext")
Öffnen Sie nun in PMMail unter "Account" das Notizbuch "Account Settings" und darin die Seite "Rexx".
Klicken Sie dann "Message Send Exit" an, so dass dort ein Häkchen erscheint. In das Feld "Script to run" tragen Sie dann XupdSig.EXE ein. Das Feld "Execute Script in Foreground" wird nicht aktiviert.
Schließlich Öffnen Sie die Seite "Signature" und tragen in Ihrer Signatur in der gewünschten Zeile den Platzhalter "UpTimeMessage" (ohne die Anführungszeichen) ein.
Diese Eintragungen müssen Sie für jeden Mail-Account wiederholen, der XupdSig benutzen soll.
das "49 Tage Problem"
=====================
der verwendete TopSpeed Compiler kann lediglich 16 Bit Applikationen erzeugen. Dadurch steht mir nur ein 32 Bit Systemzähler zur Verfügung, der fortlaufend die verstrichenen Millisekunden seit Systemstart zählt. Dieser Zähler läuft nach etwa 49 Tagen und 17 Stunden über, so dass man dann wieder bei 0 anfängt zu zählen.
Ich habe nun einen internen Überlauf-Zähler in UpdSig eingebaut, der bei jedem Überlauf des Systemzählers um 1 inkrementiert wird. Hiervon kann ich 10 Bit nutzen, so dass man jetzt auf etwa 50000 Tage kommt, bevor auch hier ein Überlauf eintritt, das entspricht etwa 137 Jahren und sollte ausreichend sein :-)
Wenn UpdSig auf einem Rechner gestartet werden soll, der bereits länger als 49 Tage läuft, so können Sie mit dem Parameter OffsetInDays angeben, um wieviele Tage die Systemzeit erhöht werden soll. Ansonsten tragen Sie hier bitte 0 ein, schummeln verboten ! :-)
(deshalb war das ursprünglich auch nicht implementiert!)
Interna
=======
UpdSig und XupdSig wurden in TopSpeed Modula-2 geschrieben und sind 16 Bit OS/2 Programme.
UpdSig ist ein Multithreading Programm und belastet daher das System so gut wie nicht.
Registrierung
=============
UpdSig und XupdSig sind Freeware und dürfen von jedermann beliebig genutzt werden, solange keine Änderungen an den Programmen oder der Dokumentation vorgenommen werden.
Wenn Sie eines der Programme regelmäßig nutzen, würde ich mich über eine kleine eMail sehr freuen :
eMail : p.engels@gmx.de
URL : http://www.uni-bonn.de/~uzs0ad
Falls Sie Verbesserungs- oder Änderungsvorschläge haben, oder einen Bug finden, bitte auch eine eMail an mich!
Legal Disclaimer:
=================
Permission is granted to any individual or institution to use, copy, or redistribute this executable as long as it is not modified and that it is not sold for profit.
UpdIni is provided AS IS and comes with no warranty of any kind, either expressed or implied. In no event will the copyright holder be liable for any damages resulting from the use of this software.
