Watcher V1.1

1. Allgemeines
==============

©1992 bei Peter Jack, Karlsruhe

Diese Programm ist PD, dh. es darf von jedem benutzt und kopiert werden.

Es wird keine Garantie gegeben, daß das Programm 100%ig zuverlässig ist.
Sie benutzen dieses Programm auf eigene Gefahr. Der Autor kann auf keinen
Fall für irgendwelche Schäden verantwortlich gemacht werden, die durch
die Anwendung dieses Programmes entstehen.


Dieses Programm entstand mit Hilfe folgender Programme :

 - Aztec C 5.2a Developer System
 - GadToolsBox v1.4 (37.121)


Da das Programm einige Funktionen der KICKSTART 2.0 verwendet,läuft es
folglich nur auf Amigas mit KICKSTART >= 2.0.


2. Was macht das Programm ?
===========================

Watcher kann den zeitlichen Verlauf folgender Daten graphisch darstellen :

 - Systemauslastung
 - Freier Speicher
    - Any
    - Chip
    - Fast

Die Darstellung erfolgt in einem Fenster, welches vom Benutzer in der
Größe verändert und beliebig positioniert werden kann.

Die Information über Fensterposition, Fenstergröße und was dargestellt wird
kann in einer Konfigurationsdatei gespeichert werden.
(welche beim Start automatisch geladen wird)

3. Wie startet man das Programm
===============================

Wenn Sie das Programm nach dem Booten automatisch starten lassen wollen:

entweder

 Einfach das Programm im WBStartup-Ordner ablegen

oder

 In die User-Startup folgende Zeile einfügen :

 run >nil: Watcher

 ( Dateiname gegebenenfalls mit Pfad )


Wenn Sie das Programm später starten wollen:

entweder

 Einfach das Programm-Icon zweimal kurz anklicken

oder

 Im CLI folgende Zeile eingeben :

 run >nil: Watcher

 ( Dateiname gegebenenfalls mit Pfad )


4. Die Bedienung des Programms
==============================

Nach dem Starten des Programmes erscheint das Hauptfenster in dem die
Daten graphisch angezeigt werden.

Diese Fenster können Sie mit den Systemgadgets verschieben, in den
Hintergrund legen und in der Größe verändern.
Mit dem Closegadget links oben kann das Programm beendet werden.

Desweiteren besitzt das Hauptfenster eine Menuezeile mit folgenden
Funktionen :

- Einstellungen ...

  Wenn Sie diesen Menuepunkt anwählen erscheint ein weiteres Fenster
  mit folgenden Gadgets :

  - Anzeige
    Hier kann eingestellt werden, was im Hauptfenster angezeigt werden soll :
    - Auslastung
    - Speicher - Any
    - Speicher - Chip
    - Speicher - Fast

  - Z-Basis
    Mit diesem Schieberegler kann man einstellen in welchen Zeitintervallen
    die Ausgabe erfolgen soll (1s - 60s), der Wert in Sekunden wird rechts
    neben dem Gadget angezeigt.

  - CLD
    Löscht alle gespeicherten Daten.
  

  Das Einstellfenster kann (muß aber nicht) mit seinem Closegadget wieder
  geschlossen werden.


- Einstellungen laden

  Es werden die Voreinstellungen aus S:Watcher.config geladen


- Einstellungen speichern

  Es werden die aktuellen Einstellungen in S:Watcher.config gespeichert


- Information

  Es erscheint ein Fenster mit dem Copyrighthinweis.


- Beenden

  Programm beenden


5. Wie ermittelt das Programm die Daten und wie erfolgt deren Anzeige
=====================================================================

Auslastung
----------

Ermittlung :

Watcher Installiert einen Interrupthandler für den Vertical Blank
Interrupt, und jedesmal bei aufruf diese Interruptes wird ein Zähler
incrementiert und es wird überprüft in welchem Zustand der aktuelle
Task ist, ist dieser im RUN-Status dann wird ein zweiter Zähler 
incrementiert, wenn er im WAIT-Status ist dann ist momentan kein Task
aktiv und der zweite Zähler wird nicht erhöht.
Das Verhältnis von Zähler2 zu Zähler1 gibt dann die Auslastung an.
(Die Zähler werden nach jeder Anzeige dann wieder auf 0 gesetzt)

Dieser Wert gibt also an, wieviel Prozent der Zeit, welche für Tasks zur
verfügung steht,von diesen 'verbraucht' wird.

Anzeige :

Auslastung in Prozent.

Es wird immer ein Bereich von 0 - 100% angezeigt.


Speicher
--------

Ermittlung :

Nach jedem Zeitintervall wird jeweils über AvailMem() abgefragt wieviel
Speicher zur Verfügung steht. D.h. im Gegensatz zur Auslastung wird also
pro Zeitintervall nur ein Wert herausgepickt.


Anzeige :

Angezeigt wird wieviel Speicher prozentual noch frei ist.

Autorange, so daß auf der ganzen Fensterbreite alle werte sichtbar sind.
(dmin : 1%, dmax : 100%)

Am linken Fensterrand stehen die Anzeigegrenzen in Prozent.


6.Bug reports,Kommentare und Verbesserungsvorschläge
====================================================

Der Autor ist über FIDO unter folgender Adresse erreichbar :

Peter Jack   2:241/7503.77





So und nun viel Spaß mit Watcher


                                Peter Jack