Index of /atarilibrary/atari_cd04/DEBUGGER/TMON202/SYMBOL/WATCHDOG

 Name                    Last modified       Size  Description

 Parent Directory        11-May-2007 21:03      -  
 BEISPIEL.C              22-Jul-1992 11:42     1k  
 BEISPIEL.TOS            22-Jul-1992 11:42     1k  
 CHANGES                 27-Oct-1992 10:16     1k  
 WATCHDOG.ACC            27-Oct-1992 10:05     2k  
 WATCHDOG.RSC            04-Oct-1992 06:33     6k  
 WDOG_TSR.PRG            27-Oct-1992 10:05     7k

                       ***************************************
                       * The Watchdog V1.11 (Stand 22.06.92) *
                       ***************************************


Hinweis:
========

Dieses  Programm  ist  nicht Public Domain!! Wer dieses Programm ”fter benutzt,
muá  an  den  Autor  eine  Gebhr in H”he von DM 10,- zahlen. Jeder darf dieses
Shareware-Programm weitergeben, solange die Dateien

      README          (diese Datei)
      CHANGES         (Žnderungen an The Watchdog)
      SYMBOL.PRG      (Resident Symbol Driver)
      WATCHDOG.ACC    (Steueraccessory)
      WATCHDOG.RSC    (Resourcedatei)
      WDOG_TSR.PRG    (speicherresidenter Teil von WATCHDOG)
      BEISPIEL.TOS    (Beispielprogramm; n„heres siehe README)
      BEISPIEL.C      (Source-Code zum Beispielprogramm)

ohne  Ver„nderung  weitergeben werden und wenn fr die Verbreitung keine Gebhr
verlangt  wird.  Somit ist der Vertrieb ber sogenannte Public-Domain-Vertriebe
ausdrcklich  untersagt.  Zuwiderhandlungen  werde ich strafrechtlich verfolgen
lassen!


Was macht The Watchdog ?
========================

The Watchdog  erm”glicht es in Verbindung mit dem  Resident Symbol Driver,  ein
Profiling  auf  Timerbasis  durchzufhren,  d.h. ber einen bestimmten Zeitraum
wird  die  CPU  regelm„áig  unterbrochen  und  anhand  der zuletzt ausgefhrten
Anweisung  wird  fr die entsprechende Funktion des zu messenden Programmes ein
Treffer  vermerkt.  Die  Funktion,  die  nach  Ablauf  der Meáreihe die meisten
Treffer  erhalten hat, ben”tigte auch verglichen zu den anderen Funktionen mehr
Rechenzeit.  Dadurch  hat man einen guten šberblick, ob und wie oft die eigenen
Routinen  benutzt  werden.  Auch  kann man auf diese Art und Weise feststellen,
welche Routine noch optimiert werden sollte.


Wie bedient man The Watchdog ?
==============================

Folgende  Programme  mssen  in  der  angegebenen  Reihenfolge beim Systemstart
ausgefhrt werden:

          SYMBOL.PRG   (Resident Symbol Driver)
          WDOG_TSR.PRG (residenter Teil von The Watchdog)
          WATCHDOG.ACC (Steueraccessory von The Watchdog)

Die  Programm  SYMBOL.PRG und WDOG_TSR.PRG sollten am besten in den AUTO-Ordner
kopiert  werden.  Die  Dateien WATCHDOG.ACC und WATCHDOG.RSC kopiert man in das
Wurzelverzeichnis des Boot-Laufwerks (z.B. "C" bei Festplatten).

Wenn diese Reihenfolge eingehalten und das Resource-File eingelesen wurde, kann
man im Accessory-Dialog folgende Parameter einstellen:


Genauigkeit (Sehr hoch, Hoch, Mittel, Gering):
----------------------------------------------
Dieser  Parameter bestimmt die Genauigkeit, mit der bei einer Unterbrechung die
Zuordnung  zu  einer  Funktion  des  Programmes erfolgt. Bei der Wahl von "Sehr
hoch"  kann  jede  Adresse  eindeutig  zugeordnet werden. Die anderen Parameter
bewirken  zwar,  daá  weniger  Speicher  ben”tigt  wird,  jedoch  kann dann die
Zuordnung nicht mehr eindeutig erfolgen, da man ja jetzt nicht mehr sagen kann,
ob  die  Unterbrechung  am  Ende  der  vorherigen  Funktion  oder innerhalb der
aktuellen Funktion erfolgte.

    "Sehr hoch": jede Adresse belegt einen Eintrag (eindeutige Zuordnung)
    "Hoch":      jeweils 8 Bytes belegen einen Eintrag
    "Mittel":    jeweils 32 Bytes belegen einen Eintrag
    "Gering":    jeweils 128 Bytes belegen einen Eintrag


H„ufigkeit (Sehr oft, Oft, Mittel, Selten):
-------------------------------------------
Diese  Einstellung  legt  fest,  wie  h„ufig The Watchdog das laufende Programm
unterbrechen  soll,  um  seine  Messung  durchzufhren. Je mehr Unterbrechungen
erfolgen,  desto  langsamer  l„uft  das  Programm  ab,  dafr  werden aber mehr
Meádaten gesammelt und die gesamte Messung ist exakter. Auf normalen STs (mit 8
MHz)  kann  "Sehr oft" zu Problemen fhren, da einfach zu viele Unterbrechungen
das  System  lahmlegen.  Als  einzige  Abhilfe dazu kann man eigentlich nur auf
einen kleineren (= weniger systembelastenden) Wert ausweichen.

    "Sehr oft": 25600 Unterbrechungen / Sekunde
    "Oft":      12800 Unterbrechungen / Sekunde
    "Mittel":    6400 Unterbrechungen / Sekunde
    "Selten":    3200 Unterbrechungen / Sekunde


Nur bei Symbolen starten:
-------------------------
Wenn  dieses  Flag  gesetzt  ist, so wird The Watchdog nur dann aktiv, wenn ein
Programm mit einer Symboltabelle gestartet wird. Dies kann hilfreich sein, wenn
es  sich  um  ein TTP-Programm handelt, daá man aus einer Kommandoshell starten
m”chte.  Da  die  Shell keine Symboltabelle hat (bzw. keine haben sollte), wird
The  Watchdog  erst  beim  Programmstart  aktiv  (was  man  schlieálich auch so
wollte).

Andernfalls werden auch Messungen fr Programme durchgefhrt, die keine Symbol-
tabelle  besitzen.  Um  diese  Daten  analysieren  zu  k”nnen,  braucht man das
Programm ANALYSER, daá nur an registrierte Benutzer ausgegeben wird.


Ausgabedatei:
-------------
Wenn man das Auswahlfeld mit der Vorbelegung "WATCHDOG.TXT" anklickt, erscheint
eine  Fileselektorbox,  ber die man den Pfad und den Dateinamen der Protokoll-
datei  ausw„hlen kann. Wenn kein Dateiname angegeben wird, so wird der Default-
name "WATCHDOG.TXT" gew„hlt.


Knopf Info:
-----------
Die Anwahl von "Info" fhrt zur Anzeige der Infobox.


Knopf Start:
------------
Nach  der Wahl von "Start" bekommt man noch einen Hinweis. Nun muá man noch das
Programm,  von  dem  die  Meádaten  ermittelt  werden sollen, gestartet werden.
Vorher  muá  man  jedoch  beachten,  daá  das  Programm auch eine Symboltabelle
enth„lt, da ansonsten keine Zuordnung der Adressen zu Funktionen erfolgen kann.


Knopf OK:
---------
Wenn dieser Knopf gew„hlt wird, so wird der Dialog mit The Watchdog beendet.


Normale Vorgehensweise zur Messung eines Programmes:
====================================================
 - Steueraccessory aufrufen
 - Genauigkeit einstellen
 - H„ufigkeit einstellen
 - Schalter "Nur bei Symbolen starten" einstellen
 - Protokolldatei bestimmen
 - Knopf "Start" w„hlen
 - anschlieáend Knopf "Weiter" w„hlen
 - zu messendes Programm starten
 - zu messende Funktionen des Programms ausfhren
 - Programm beenden (dies fhrt zur Erstellung der Protokolldatei)
 - nochmal  The Watchdog  aufrufen, um ber einen eventuellen Fehler informiert
   zu  werden,  da bei der Erstellung einer  Datei schlieálich Fehler auftreten
   k”nnen.
 - Wenn  das gestartete Programm  eine Symboltabelle enthalten hat,  so enth„lt
   die  Protokolldatei  nur  Textzeilen.  Andernfalls  handelt es  sich um  ein
   Format, das nur von dem Programm ANALYSER ausgewertet werden kann.

Anhand  der  Datei  BEISPIEL.TOS,  die  nur 3 Schleifen enth„lt, kann man diese
Vorgehensweise  testen.  Als  Ergebnis  máte  man erkennen, daž  sub3 ungef„hr
doppelt so lange braucht wie sub2. Man kann dabei auch sehen, daá das Betriebs-
system auch relativ viel Zeit bis zum eigentlichen Start des Programms braucht.


Wer braucht The Watchdog ?
==========================

The  Watchdog  ist ein hilfreiches Utility fr alle Programmierer, die immer an
einer  Optimierung oder an einem Laufzeitverhalten ihrer Programme interessiert
sind.


Autor:
======

Robert Federle
Rungestr. 3
8900 Augsburg 22

Bankverbindung:
Raiffeisenbank Augsburg eG, BLZ: 720 601 84, Konto 2547090