@DATABASE "RealTimeWatch"
@$VER: RealTimeWatch Guide V1.2 (26.01.97)
@(C) Hoin 02/1997
@AUTHOR "Thomas »Hoin« Heinrich"

@REMARK "Dieses AmigaGuide®-Dokument wurde in mühevoller Handarbeit erstellt !"
@REMARK "This AmigaGuide®-document was created with much effort by hand !"

@SMARTWRAP
@TAB 3

@NODE MAIN "RealTimeWatch/Intro"
@{JCENTER}


Willkommen zu

Welcome to


@{U}RealTimeWatch V1.6@{UU}



@{B}Bitte wählen Sie Ihre bevorzugte Sprache

Please choose your preferred language@{UB}



@{" DEUTSCH " link deutsch 0}
@{" ENGLISH " link english 0}

@ENDNODE


@REMARK "HIER BEGINNT DIE DEUTSCHE SEKTION"


@NODE deutsch "RealTimeWatch/deutsch"


@{B}ACHTUNG:@{UB}


Dieses AmigaGuide®-Dokument benutzt einige Features, die erst ab V40
(Kickstart 3.1) implementiert sind. Unter älteren Versionen des Amiga-OS kann
es Probleme bei der Darstellung geben und/oder AmigaGuide®-Schlüsselwörter
können als Klartext ausgegeben werden. Lassen Sie sich nicht davon irritieren,
oder besser, rüsten Sie Ihren Amiga auf Kickstart 3.1 auf.@{PAR}

@{CODE}@{LINDENT 4}
@{" Copyright      " link copydeutsch 0} - was Sie wissen müssen
@{" Überblick      " link overdeutsch 0} - was Sie bekommen
@{" Anforderungen  " link harddeutsch 0} - was Sie brauchen
@{" Installation   " link instdeutsch 0} - was Sie tun müssen
@{" Optionen       " link optdeutsch 0} - wie Sie es tun können
@{" Bedienung      " link usedeutsch 0} - wo Sie Einfuß haben
@{" Geschichte     " link histdeutsch 0} - was einmal war
@{" Vorankündigung " link previewdeutsch 0} - was noch kommt
@{PARD}


Erreichen können Sie mich per EMail: T.Heinrich\@t-online.de
(Wer hat da gelacht ?!)@{PAR}
@{CODE}
Oder per Post:@{LINDENT 4}
Thomas Heinrich
Brunnenstraße 1
74405 Gaildorf
Deutschland
@{PARD}

Bitte KEINE Telefonanrufe oder Faxe !

@ENDNODE

@NODE copydeutsch "RealTimeWatch/Copyright/deutsch"


Das Programm "RealTimeWatch" in der Version 1.6 unterliegt den Beschränkungen der
Softwarekategorie "FD" (Freely Distributable). Das bedeutet, daß die Software
ohne Einschränkungen kopiert werden darf, solange alle zugehörigen Dateien intakt,
unverändert und vollständig weitergegeben werden. Die empfohlene Methode ist, das
unausgepackte Archiv weiterzugeben.@{PAR}

Alle Rechte zu dem Programm liegen bei mir, der Sourcecode ist nicht veröffentlicht.
Jede Art der Veränderung an dem Programm oder der Dokumentation stellt eine Verletzung
des Urheberrechts dar.@{PAR}

Zum Programm "RealTimeWatch" gehören eine zweisprachige Anleitung im AmigaGuide-Format
(deutsch und englisch), sowie jeweils eine deutsche und eine englische Version des
Programms. Die Versionen unterscheiden sich nur in der Sprachführung voneinander.@{PAR}

Ich gebe keine Garantie auf Funktion des Programms und übernehme keine Haftung für
Schäden, die aus der Anwendung des Programms entstehen. Sie starten das Programm auf
eigene Gefahr.@{PAR}

Sollten Sie für dieses Programm Geld bezahlt haben, sind Sie selber schuld !
Verklagen Sie denjenigen, der es Ihnen verkauft hat.@{PAR}

08. Februar 1997@{PAR}
Thomas Heinrich

@ENDNODE

@NODE overdeutsch "RealTimeWatch/Überblick/deutsch"
@{JCENTER}

@{B}RealTimeWatch V1.6@{UB}@{PAR}
@{JLEFT}

Was ist RealTimeWatch ?@{PAR}

Bestimmt haben Sie auch schon erlebt, daß irgendein Programm Ihnen die
Uhrzeit völlig verstellt hat. Abgesehen davon, daß es ärgerlich ist,
jedesmal wieder die Uhr neu zu stellen, gibt es Software, die Ihren
Dienst verweigert, wenn das Datum nicht stimmt.@{PAR}

Offensichtliches Beispiel ist der "V43 picture.datatype", der nur 4
Monate funktioniert und danach durch die neue Version ersetzt werden muß.
Aber auch der gute, alte ToolManager2.1 verweigert den Betrieb, wenn
die Hardware-Uhr verstellt wird.@{PAR}

Was tun ? Zuerst dachte ich daran, den Adressbereich der Hardware-Uhr
per MMU zu schützen - aber wer hat schon eine MMU ? Unter Amiga-User noch
immer eine Ausnahme. Der nächste gangbare Weg war eine Art Wachhund für
die Uhr: Ein Hardware-Clock-Watchdog, also ein "echter Zeitwächter" ->
 RealTimeWatch !@{PAR}

Das Phänomen des Uhrverstellens ist zweigeteilt: Zuerst flippt irgendein
Programm aus und überschreibt dabei beliebige Adressbereiche, mit Vorliebe
die Uhr. Danach wird irgendwann neu gebootet und die verstellte Uhrzeit als
Systemzeit übernommen. Damit ist klar: Man muß die Hardware-Uhr regelmäßig
auslesen, um Veränderungen zu erkennen, dann kann man die Zeit wieder auf
den richtigen Wert zurücksetzen.@{PAR}

Beachten muß man dabei nur, daß sich mit der Sommerzeit die Uhr "legal"
um 60 Minuten ändern kann, wenn der User sie neu stellt. Da ein überschreiben
der Hardware-Uhr aber eine Änderung von mehreren Jahren, gar Jahrzehnten
bewirkt, ist das kein Problem.@{PAR}

Was aber, wenn ein amoklaufendes Programm die Uhr verstellt und dann den
Rechner abstürzen läßt ? Tja, Pech ! Oder doch nicht ? Die Uhr ist dann ja
schon um einige Jahre verstellt - da könnte man doch vorher die Zeit irgendwo
abspeichern und nach dem Neustart wieder zurückschreiben. Natürlich kann
RealTimeWatch auch dies (siehe Option @{" LOGFILE " link optlog 0}).
RealTimeWatch speichert dabei bei seinem Programmstart die Hardware-Zeit
ab, und vergleicht sie vorher mit der alten abgespeicherten Zeit, falls
vorhanden.@{PAR}

Daraus ergibt sich ein Nachteil für User, die Ihren Amiga nie ausschalten,
z.B. Mailboxbetreiber. Hier wird RealTimeWatch nur einmal gestartet, also
kann die Zeit nie verglichen werden. Die "Online"-Überwachung funktioniert
natürlich trotzdem.@{PAR}

@ENDNODE

@NODE harddeutsch "RealTimeWatch/Anforderungen/deutsch"


Anforderungen, die RealTimeWatch an Ihren Amiga stellt:@{PAR}
@{LINDENT 4}

·@{LINDENT 6} mindestens Kickstart/Workbench 2.04 (Version 37). Version 36
(frühe A3000) geht NICHT !
@{LINDENT 4}

·@{LINDENT 6} Mindestens einen MC68020 Prozessor. Behindern Sie nicht die
Entwicklung des Amiga, indem Sie an veralteten Prozessoren (MC68000, MC68010)
festhalten. Der MC68000 wurde 1979 entwickelt, er ist jetzt also geschlagene
18 (in Worten: achtzehn) Jahre alt !
@{LINDENT 4}

·@{LINDENT 6} eine Hardware-Uhr, die vom System mit den entsprechenden Funktionen
unterstützt wird (battclock.resource). "Nackte" Amiga 500+, 600, 1200 funktionieren
also NICHT ! Viele Speichererweiterungen und Turbokarten bieten aber eine Hardware-Uhr.
@{LINDENT 4}

·@{LINDENT 6} es sollten noch ca. 10 kByte an Speicher (RAM) frei sein, um RealTimeWatch
zu starten.
@{LINDENT 4}

@ENDNODE

@NODE instdeutsch "RealTimeWatch/Installation/deutsch"


@{B}Ein Hinweis zur Installation:@{UB}


Benennen Sie die Datei "RealTimeWatch_deutsch" in "RealTimeWatch" um,
und kopieren Sie sie nach "C:". Benutzen Sie z.B. die folgende Zeile:@{PAR}
@{CODE}
@{JCENTER}@{B}copy RealTimeWatch_deutsch C:RealTimeWatch@{UB}
@{JLEFT}@{PARD}

Diese Zeile funktioniert nur aus der Shell, wenn Sie sich im Verzeichnis
befinden, in das Sie die Datei "RealTimeWatch_deutsch" entpackt haben.@{PAR}

Von der Workbench wählen Sie "Fenster/Inhalt anzeigen/Alle Dateien" für
die RTWatch-Schublade aus dem Menü. Klicken Sie doppelt auf die Datei
"RealTimeWatch_deutsch". Ein Requester sollte sich öffnen, in dem der
Dateiname steht. Ändern Sie den Inhalt des String-Gadgets auf die obige
Shell-Zeile. Klicken Sie auf OK.@{PAR}

Zum Schluß müssen Sie noch Ihre Startup-Sequence ändern. Laden Sie sie in
Ihren Lieblings-Texteditor und fügen Sie die folgende Zeile direkt unter
der Zeile ein, die mit "C:SetPatch..." beginnt:@{PAR}
@{CODE}
@{JCENTER}@{B}Run <>NIL: C:RealTimeWatch@{UB}
@{JLEFT}@{PARD}

Informieren Sie sich auch unbedingt über die möglichen
 @{" OPTIONEN " link optdeutsch 0} !@{PAR}

Speichern Sie die Startup-Sequence, und nach dem nächsten Neustart haben Sie
einen besseren Schutz für Ihre Hardware-Uhr.@{PAR}

@{JCENTER}@{CODE}@{B}
! WICHTIG ! WICHTIG ! WICHTIG ! WICHTIG !

+---------------------------------------+
| ICH RATE IHNEN DRINGEND, DAS PROGRAMM |
| VOR VERWENDUNG AUF VIREN ZU PRÜFEN !  |
+---------------------------------------+

! WICHTIG ! WICHTIG ! WICHTIG ! WICHTIG !

@ENDNODE

@NODE optdeutsch "RealTimeWatch/Optionen/deutsch"


@{B}LESEN SIE ZUERST DAS KAPITEL ÜBER DIE
 @{" INSTALLATION " link instdeutsch 0} !@{UB}@{PAR}

RealTimeWatch ist einfach zu benutzen:@{PAR}

SCHABLONE: RealTimeWatch
 @{" ENDE/S " link optend 0},
 @{" SEKUNDEN/N " link optsek 0},
 @{" LOGFILE/K " link optlog 0},
 @{" TAGE/N " link opttag 0}

@ENDNODE

@NODE optend "RealTimeWatch/Optionen/ENDE/deutsch"


ENDE: @{LINDENT 6}
Diese Option beendet RealTimeWatch; natürlich nur, wenn es schon läuft.
Wenn nicht, wird eine Fehlermeldung ausgegeben.@{PAR}

Default: nicht angegeben

@ENDNODE

@NODE optsek "RealTimeWatch/Optionen/SEKUNDEN/deutsch"


SEKUNDEN: @{LINDENT 10}
Gibt die Sekunden zwischen zwei Prüfungen der Hardware-Uhr an. Minimum
ist eine Sekunde, Maximum sind 60 Sekunden. Vernünftige Werte liegen
zwischen einer und fünf Sekunden.@{PAR}

Je mehr Sekunden Sie angeben, desto später wird Sie RealTimeWatch über
eine Änderung der Hardware-Uhr informieren können.@{PAR}

Default ist 1 (eine) Sekunde. Ich benutze allerdings 3 Sekunden.

@ENDNODE

@NODE optlog "RealTimeWatch/Optionen/LOGFILE/deutsch"


LOGFILE: @{LINDENT 9}
Ein gültiger Pfad zu einer Datei, in der RealTimeWatch seine Startzeit
ablegen kann. Wenn die Datei nicht existiert, wird sie angelegt.@{PAR}

@{B}WIE LEICHT EINZUSEHEN IST, SOLLTEN SIE HÖLLISCH AUFPASSEN, DASS DIE
DATEI NICHT SCHON EINEM ANDEREN PROGRAMM GEHÖRT. DIESES KÖNNTE NICHTS MEHR
MIT DER DATEI ANFANGEN, NACHDEM RealTimeWatch DARÜBERGEBÜGELT IST !@{UB}@{PAR}

Kein Default. Ich empfehle einen Pfad in der folgenden Art:
"SYS:T/RTW_LogFile"

@ENDNODE

@NODE opttag "RealTimeWatch/Optionen/TAGE/deutsch"


TAGE: @{LINDENT 6}
Gibt die Tage an, die zwischen zwei Reboots liegen dürfen, damit die Zeit
noch als gültig angesehen wird. Minimum ist ein Tag, Maximum sind 90 Tage.
Je nachdem, wie oft Sie Ihren Amiga einschalten, liegen vernünftige Werte
bei 1 (jeden Tag) bis 7 Tage (schämen Sie sich).@{PAR}

Damit es funktioniert, sollten Sie auch ein @{" LOGFILE " link optlog 0}
 angeben.@{PAR}

Default sind 7 Tage (eine Woche).

@ENDNODE

@NODE usedeutsch "RealTimeWatch/Bedienung/deutsch"


Die Bedienung wurde so einfach wie möglich gehalten. Sollte die Hardware-Uhr
verstellt werden, öffnet sich ein Systemrequester, der Sie auf die verstellte
Uhr hinweist und drei Möglichkeiten zur Reaktion bietet (der Requester, wenn
Sie ihn denn je sehen werden, erklärt das Ganze noch einmal genauer als ich
hier in dieser Anleitung):@{PAR}

1. "Alte Zeit" oder "Altes Datum": Setzen der Uhrzeit, die vor dem Verstellen
der Uhr aktuell war.@{PAR}

2. "Reset": Setzen der Uhrzeit auf den 1. Januar 1978. Nur vorhanden, weil es
einfach zu programmieren ist und damit man im Notfall einen definierten
Ausgangszustand hat.@{PAR}

3. "Neue Zeit" oder "Neues Datum": Beläßt die Uhrzeit, wie sie augenblicklich
ist. Nützlich, wenn Sie drei Wochen im Urlaub waren, aber z.B. nur drei Tage
maximalen Unterschied zwischen zwei Neustarts zulassen.@{PAR}

Wenn Sie denken, RealTimeWatch funktioniert bei Ihnen gar nicht, öffnen Sie
eine Shell und tippen Sie folgendes ein:@{PAR}
@{CODE}@{LINDENT 4}
date 1-jan-78
setclock save
@{PARD}

Sodann sollte sich ein Requester auftun...@{PAR}

Sie können auch den "Time"-Voreinsteller aus Prefs benutzen und die Uhrzeit um
einige Tage verstellen. Beenden Sie "Time" dann aber unbedingt mit "Speichern",
denn sonst ändern Sie nur die Systemzeit, nicht die Hardware-Uhr !@{PAR}

ACHTUNG: Ein häufiger Fehler ist es, nach einem Spiel den Rechner auszuschalten
und zu Bett zu gehen, oder ähnliches ... Sie sollten unbedingt noch einmal den
Rechner neu starten, um sicherzugehen, daß Ihnen nicht etwa das Spiel die Uhr
verstellt hat ! Sie werden dran denken, wenn es Ihnen ein paar mal passiert ist.
@{PAR}

@ENDNODE

@NODE histdeutsch "RealTimeWatch/Geschichte/deutsch"

@{CODE}
Datum * Version.Revision * Kommentar

13.02.1997 * 1.6 * Verspätetes Upload wegen Festplattencrash vom Server der Uni Paderborn !
08.02.1997 * 1.6 * Sourcecode aufgeräumt, speichert jetzt die Zeit jedesmal im Logfile,
                   wenn sich die Uhr geändert hat, vorher nur beim Programmstart.
03.02.1997 * 1.5 * Fehler mit nichtbenutzem Request bei WaitIO() behoben. Äußert sich
                   in einem harmlosen Enforcer-Hit. Der Fehler scheint mir eher in den
                   Köpfen der Commodore-Entwickler zu liegen, die den Schwachsinn
                   verzapft haben.
02.02.1997 * 1.4 * Fehler mit nichtallokiertem timerequest bei Option LOGFILE behoben
27.01.1997 * 1.3 * Erste Veröffentlichung im AmiNet
26.01.1997 * 1.3 * Erstellen der Dokumentation (der Kampf mit AmigaGuide)
24.01.1997 * 1.3 * Fertigstellung der endgültigen (?) Version
09.01.1997 * 1.0 * Idee & Programmierbeginn
@ENDNODE

@NODE previewdeutsch "RealTimeWatch/Zukunft/deutsch"


Ich finde es umständlich, ein AmigaGuide-Dokument zu schreiben. Natürlich könnte
ich "Heddley" benutzen - aber das ist Shareware und auch nicht komfortabler. Der
Aufwand des Dokumentierens hat sich nur auf eine andere Ebene verlagert.@{PAR}

Deshalb schreibe ich gerade an einem Programm, das ein interaktives Arbeiten erlaubt,
wie in einem Texteditor, nur mit auf AmigaGuide abgestimmter Benutzerführung. Das
wird ein größeres Projekt und daher längere Zeit in Anspruch nehmen. Ich hoffe, eine
einigermaßen lauffähige Version noch in diesem Jahr (1997 ;^) fertigzustellen.@{PAR}

@ENDNODE

@REMARK "ENGLISH SECTION STARTS HERE"


@NODE english "RealTimeWatch/english"


@{B}ATTENTION:@{UB}


This AmigaGuide®-document uses some features, that are only
implemented starting with V40 (Kickstart 3.1). There may be problems with
the formatting of the text with older versions of the Amiga operating system,
and maybe some AmigaGuide®-keywords are displayed as plain text. Don't let
yourself get confused by this, or even better, upgrade to Kickstart 3.1.@{PAR}

@{CODE}@{LINDENT 4}
@{" Copyright    " link copyenglish 0} - what you must know
@{" Overview     " link overenglish 0} - what you get
@{" Requirements " link hardenglish 0} - what you need
@{" Installation " link instenglish 0} - what you must do
@{" Options      " link optenglish 0} - what you could do
@{" Usage        " link useenglish 0} - what to do on emergency
@{" History      " link histenglish 0} - what was once
@{" Future       " link previewenglish 0} - what will be
@{PARD}


You can reach me via EMail: T.Heinrich\@t-online.de@{PAR}
@{CODE}
Or by Snail Mail:@{LINDENT 4}
Thomas Heinrich
Brunnenstrasse 1
74405 Gaildorf
Germany
@{PARD}

Please, no phone calls or faxes !

@ENDNODE

@NODE copyenglish "RealTimeWatch/Copyright/english"


The program "RealTimeWatch" version 1.6 underlies the limitations of the software
category "FD" (Freely Distributable). This means that the software may be copied
freely , as long as all related files remain intact and unmodified. The recommended
method is to copy the archive file.@{PAR}

All rights of this program are reserved, the source code is not publically available.
Any changes applied to the program or the documentation is a violation of these
rights.@{PAR}

Part of this program is a bilingual documentation (german and english) in AmigaGuide
format, as well as a german and an english version of the program. The versions only
differ in language, not in function.@{PAR}

I am not giving any warranty about a particular function of the program, and can not
be held responsible for any damage resulting of the use of the program. You are
using the program at your own risk.@{PAR}

If you paid money for this program, you have been taken ! I suggest, you should sue
the one, who sold it to you.@{PAR}

February, 8th 1997@{PAR}
Thomas Heinrich

@ENDNODE

@NODE overenglish "RealTimeWatch/Überblick/english"
@{JCENTER}

@{B}RealTimeWatch V1.6@{UB}@{PAR}
@{JLEFT}

What is RealTimeWatch ?@{PAR}

I am sure, you at least once encountered the situation, that some program
messed up your Amiga's hardware clock. Besides, that it is a nuisance to
adjust the clock again, there is also some software, which does not work
anymore, if your system time is not what it should be.@{PAR}

The most obvious example is the "V43 picture.datatype", which only works
for four months, and then has to be replaced by the new version (very sick
concept, if you ask me). But even good old ToolManager2.1 refuses to work,
if your hardware clock gets messed up.@{PAR}

So, what to do ? First, I was thinking about some MMU protection of the
address range of the hardware clock - but who has an actually working MMU ?
For an Amiga user, this is still an exception. The next way to go was a
kind of watchdog for the hardware clock, that keeps track of the real time
-> RealTimeWatch was born !@{PAR}

The symptoms of messing up the hardware clock are two: first some program
goes mad, writing to random addresses, preferably the hardware clock's.
After that a reboot occurs (by accident or purpose), and the wrong time is
set as the system time. Now it's clear: you have to check the hardware clock
every now and then, to recognize any abnormal changes, then you can reset
the clock to it's normal state.@{PAR}

The only thing to look out for, is, that during summer, the clock can
"legally" be changed by a quantum of 60 minutes by the user. But as the
overwriting of the hardware clock changes the date by an amount of years,
that's not a real problem.@{PAR}

What, if a gone-mad program changes your hardware clock and then provokes
a reboot ? Bad luck - or isn't it ? You could have saved the correct time
before, and write it back after reboot. Of course, RealTimeWatch is capable
to do that (see option @{" LOGFILE " link optloge 0}). It saves the time
at program startup and compares it to the previous saved time, if there is
any.@{PAR}

Now there is a caveat for users, who never reboot or turn off their Amiga,
e.g. mailbox hosts. RealTimeWatch would only be started once, so there is
no chance of comparing an older date. Nevertheless, you still have the
"online" check, after all.@{PAR}

@ENDNODE

@NODE hardenglish "RealTimeWatch/Anforderungen/english"


Requirements of RealTimeWatch to your Amiga:@{PAR}
@{LINDENT 4}

·@{LINDENT 6} at least Kickstart/Workbench 2.04 (Version 37). Version 36 (early
A3000) does NOT work !
@{LINDENT 4}

·@{LINDENT 6} at least an MC68020 processor. Don't slow down the development of
the Amiga by sticking to obsolete processor types as the MC68000 or MC68010. Keep
in mind, that the MC68000 has been developed in 1979, which was 18 years before
today !
@{LINDENT 4}

·@{LINDENT 6} a hardware clock, which is supported by the system functions
(battclock.resource). "Naked" Amiga 500+, 600, 1200 will NOT work ! But many
memory and accelerator boards supply a hardware clock.
@{LINDENT 4}

·@{LINDENT 6} there should be approximately 10 kByte of memory (RAM) available,
to start RealTimeWatch.
@{LINDENT 4}

@ENDNODE

@NODE instenglish "RealTimeWatch/Installation/english"


@{B}A note about installation:@{UB}


You only need the english or german executable, depending, which language
you are more capable of.@{PAR}

There are "RealTimeWatch_deutsch" and "RealTimeWatch_english". Rename
the appropriate one to "RealTimeWatch" and copy it into "C:", try to use
something like this:@{PAR}
@{CODE}
@{JCENTER}@{B}copy RealTimeWatch_english C:RealTimeWatch@{UB}
@{JLEFT}@{PARD}

This assumes, you are working in a shell environment and have cd-ed to
where you extracted RTWatch.@{PAR}

From Workbench, select "Window/Show Contents/Show All Files" from the
menu and double click on either "RealTimeWatch_english" or
"RealTimeWatch_deutsch". A requester should open with the selected file
name in it. Now just type the above line into the string gadget.
Finally select the OK button.That's just the same as if it had been
typed from shell.@{PAR}

The last step is to modify your startup-sequence. Load it into you
favorite text editor and insert the following line after the line saying
"SetPatch QUIET ...":@{PAR}
@{CODE}
@{JCENTER}@{B}Run <>NIL: C:RealTimeWatch@{UB}
@{JLEFT}@{PARD}

Also take a look at the @{" Options " link optenglish 0} !@{PAR}

Save this to disk and next time you reboot, you have a better protection
of your hardware clock.@{PAR}

@{JCENTER}@{CODE}@{B}
! IMPORTANT ! IMPORTANT ! IMPORTANT !

+---------------------------------------+
| I STRONGLY ADVICE YOU TO CHECK THE    |
| PROGRAM FOR VIRUSES BEFORE USING IT ! |
+---------------------------------------+

! IMPORTANT ! IMPORTANT ! IMPORTANT !

@ENDNODE

@NODE optenglish "RealTimeWatch/Optionen/english"


@{B}FIRST, READ THE @{" INSTALLATION " link instenglish 0} CHAPTER !@{UB}@{PAR}

Using RealTimeWatch is easy:@{PAR}

TEMPLATE: RealTimeWatch
 @{" QUIT/S " link optquit 0},
 @{" SECONDS/N " link optsec 0},
 @{" LOGFILE/K " link optloge 0},
 @{" DAYS/N " link optday 0}

@ENDNODE

@NODE optquit "RealTimeWatch/Optionen/ENDE/english"


QUIT: @{LINDENT 6}
Tries to quit RealTimeWatch, if specified. Of course, RealTimeWatch can
only be quit, if it runs. You will get an error message, if it's not.

No default. Also, needs no additional values.

@ENDNODE

@NODE optsec "RealTimeWatch/Optionen/SEKUNDEN/english"


SECONDS: @{LINDENT 9}
Sets the number of seconds to wait between successive hardware clock checks.
Minimum is one second, maximum is 60 seconds. Reasonable values could be
between one and five seconds.@{PAR}

The more seconds you specify, the longer it may take, until RealTimeWatch
alerts you.@{PAR}

Default is 1 (one) second. Well, I'm using 3 seconds.

@ENDNODE

@NODE optloge "RealTimeWatch/Optionen/LOGFILE/english"


LOGFILE: @{LINDENT 9}
Needs a valid path to a file, where RealTimeWatch can store the date, when
it was started. If the file does not exists, it will be created.@{PAR}

@{B}OBVIOUSLY, YOU SHOULD TAKE GREAT CARE, THAT THE FILE YOU SPECIFY IS
NOT A FILE USED BY OTHER PROGRAMS. IT WILL BE DESTROYED AFTER RealTimeWatch
HAS ACCESSED IT !@{UB}@{PAR}

No default. I am recommending something like "SYS:T/RTW_LogFile".

@ENDNODE

@NODE optday "RealTimeWatch/Optionen/DAYS/english"


DAYS: @{LINDENT 6}
Sets the number of days between successive boot-ups, the system time may vary.
Minimum is one day, maximum are 90 days. Depending on how frequently you are
using your Amiga, reasonable values are ranging from one (each day) to seven
days (shame upon you).@{PAR}

For functionality, you should specify a @{" LOGFILE " link optloge 0}, too.@{PAR}

Default is seven days (one week).

@ENDNODE

@NODE useenglish "RealTimeWatch/Bedienung/english"


The usage is kept very simple and easy. When your hardware clock is changed,
a system requester pops up, and informs you of that fact. It offers three
methods of handling the situation (the requester explains more accurate what
to do, than I do in this document):@{PAR}

1. "Older Time" or "Older Date": set the clock to what it was before it has
changed.@{PAR}

2. "Reset": set the clock to January, 1st 1978. Only there, because it's easy
to program and that you have a constant starting point, if something went
@{I}very@{UI} wrong.@{PAR}

3. "New Time" or "New Date": keeps the current date as the valid date. Useful,
if you went on holiday for three weeks, and you only allow a difference of
three days between reboots.@{PAR}

If you think, that RealTimeWatch does not work with your computer, open a shell
and type in the following:@{PAR}
@{CODE}@{LINDENT 4}
date 1-jan-78
setclock save
@{PARD}

A requester should be popping up, then...@{PAR}

You could even use "Time" preferences from Prefs, to change the date to some
days earlier or later. However, you must quit "Time" by pressing the "Save"
button. If not, the changes will only affect system time, not the hardware
clock !@{PAR}

ATTENTION: A common mistake is to switch off your computer after playing some
game. Make sure to reboot your Amiga, to verify the time has not been changed
by the game. You will think about it, if it has happened to you several times.
@{PAR}

@ENDNODE

@NODE histenglish "RealTimeWatch/Geschichte/english"

@{CODE}
Date * Version.Revision * Comment

13.02.1997 * 1.6 * Delayed upload due to harddisk crash at university Paderborn !
08.02.1997 * 1.6 * Cleaned up sourcecode. Now the time is saved to logfile every
                   time the clock has changed, was only at program startup before.
03.02.1997 * 1.5 * Fixed using an unused Request with WaitIO(). Caused a harmless
                   Enforcer hit. There seems to be a bug in the Commodore developer
                   brains, that invented this (***censored word***).
02.02.1997 * 1.4 * Fixed an unallocated timerequest with option LOGFILE
27.01.1997 * 1.3 * Public AmiNet release
26.01.1997 * 1.3 * Writing the documentation (fighting the AmigaGuide)
24.01.1997 * 1.3 * final (?) version
09.01.1997 * 1.0 * Idea & start of programming
@ENDNODE

@NODE previewenglish "RealTimeWatch/Zukunft/english"


It's no fun writing AmigaGuide. Of course I could use "Heddley" - but that's
Shareware and no fun either. It's just a higher level of effort.@{PAR}

That is why I am doing a program now , that allowes interactive Guide-writing,
just like a text editor, but with a user interface that complies to the needs
of AmigaGuide. This is going to be a larger project and will therefore take a
bit more time. I am looking forward to present a working version within this
year (1997 ;^).@{PAR}

@ENDNODE