             THE_DOT Log-File-Filter v0.98 08.08.1993

              Copyright (C) 1993 Uwe Aigensberger

Dieses Programm darf frei kopiert und in Mailboxen abgelegt werden.
Eine Verbreitung ber PD-Disketten bedarf meiner schriftlichen
Genehmigung. Auerdem darf das Programmpaket nur vollstndig
weitergegeben werden, d.h. alle Dateien mssen kopiert werden.

Achtung: Ich bernehme keinerlei Verantwortung fr Schden, direkter
oder indirekter Art, die aus dem Gebrauch oder Mibrauch dieses
Programms entstehen.

Fr Fehlerberichte und Verbesserungsvorschlge bin ich jederzeit offen
und ber die folgenden Adressen zu erreichen.

Uwe Aigensberger
Brunnenstr. 31
66780 Rehlingen/Siersburg

E-Mail: LightNet: U. Aigensberger@LUBERTS
        Z-Net   : U._Augensberger%LUBERTS@LIGHT.ZER

Sie sollten nun folgende Dateien haben:

             LOG_FILT.APP           /* Das Programm  */
             LOG_FILT.RSC           /* Die Recourcen */
             README.TXT             /* Diesen Text   */

Dieses Programm wurde mit Turbo C V1.1 unter Verwendung der POWERGEM
Librarys der TOS (6/93) bersetzt.

Warum LOG_FILT?
---------------

THE_DOT legt zur Dokumentation seiner Aktivitten eine Datei THE_DOT.LOG an.
Hier werden Anwahlversuche, Dateigren, Aufrumarbeiten auf Brettern uvm.
niedergelegt. Mit der Zeit wchst die LOG-Datei beachtlich an, insbesonders
wenn die Mailbox oft besetzt ist, und das Modem etliche Anwahlversuche unter-
nimmt. Meine LOG-Datei ist in ca. zwei Monaten auf ber 50K gewachsen.

THE_DOT selbst bietet leider nur die Mglichkeit entweder alle Vorkommnisse
in die LOG-Datei aufzunehmen, oder nur den letzten Pollvorgang zu dokumen-
tieren. Letzteres hat den Nachteil da der Gebhrenzhler des DOT's nicht
mehr funktioniert :-( . Jochen empfiehlt von Zeit zu Zeit die LOG-DATEI mit
einem Editor zu bearbeiten. Aber warum haben wir einen Computer, wenn wir
doch alles von Hand erledigen sollen. Dies ist der Punkt, an dem LOG_FILT
ansetzt.

Die Filterroutinen waren schnell geschrieben, aber es sollte eine GEM Ober-
flche hinzu kommen. Wie auf Bestellung fand sich auf der TOS 6/93 Diskette
auer 1ST_WORD auch noch die POWEGEM Library, die eine komfortable GEM-
Fensterverwaltung und Nichtmodale Dialoge versprach. Also habe ich krftig
getestet und mich durch die fast nicht vorhandene Dokumentation gewhlt.

Mein Eindruck: POWERGEM ist fr den Anfnger wegen der mangelnden
               Dokumentation schwierig anzuwenden und lt mich als fort-
               geschrittenen Programmierer das ein oder andere Mal im
               Regen stehen.


Installation und Funktion.
==========================

LOG_FILT.APP und LOG_FILT.RSC in einen beliebigen Ordner kopieren, fertig.
Ich empfehle den THE_DOT\MODULE\ Ordner. Von hier aus schaut der
Filter im INTERN - Ordner nach *.LOG - Datein nach. Das THE_DOT.LOG -
File ist voreingestellt und braucht nur RETURN oder Klick auf OK
besttigt zu werden. Es erscheint beim Start des Filters ohne Parameter
auf jeden Fall eine File-Selector-Box mit der Sie die gewnschte *.LOG
Datei anwhlen knnen. Wird dem Filter beim Start eine *.LOG- Datei
bergeben, so entfllt die File-Selector-Box.

LOG_FILT lsst sich komplett mit Maus und Tastatur steuern. Es sollte auf
allen ST, STE, TT, FALCON laufen. Durch die Verwendung Nichtmodaler
Dialoge drfte auch dem Einsatz unter Multi TOS nichts im Wege stehen.
Vieles wurde nicht getestet, da mir _nur_ ein ST mit SM 124 zur Verfgung
steht. Da es aber mit Big Screen und mit Farbemulation klaglos luft sollte
es mit dem Bildschirm keine Probleme geben.



Die grundlegenden Funktionen
============================

ffnen ^O
---------
Der Umgang mit der File-Selector-Box sollte hinreichend bekannt sein ;-)
brigens schluckt das Programm nur *.LOG Dateien. Sind keine vor-
handen hilft nur ABBRUCH weiter. Kann eine *.LOG Datei geladen werden,
so wird dieser Menpunkt gesperrt, da er seinen Zweck hinreichend erfllt
hat. Nach dem Filtern wird die bearbeitete Datei abgespeichert. Danach
wird der 'FFNEN' Menpunkt zur Bearbeitung einer weiteren Datei
feigegeben.

VORSICHT! Seit Version v0.96 ld der Filter _alle_ *.LOG Dateien.
--------  Sollte eine XYZ.LOG Datei angegeben werden, die nicht von THE_DOT
          erzeugt wurde kann diese irreparabelen Schaden erleiden!



Statistik ^I
------------
Dieser Menpunkt ist nur anwhlbar, wenn eine *.LOG Datei geladen
wurde. Im Namensfeld des Fensters ist nun der komplette Zugriffspfad
auf die *.LOG-Datei vermerkt.

Hier sollte keine weitere Erklrung mehr ntig sein. Einfach mal rein-
schauen.






Filtern ^F
----------
Dieser Menpunkt ist nur anwhlbar, wenn eine *.LOG Datei geladen
wurde.
Vor dem Filtern, sind nach Wunsch noch drei Optionen einzustellen.

- Backup der alten LOG-Datei. Fr Sicherheitsfanatiker wird eine
  *.BAK Datei angelegt, in der die alte LOG-Datei Platz findet.

- Alles Lschen bis... lscht die LOG-Datei bis zum angegebenen Datum, um
  dann im normalen Filter Modus weiterzuarbeiten. Angeboten wird der erste
  Tag des aktuellen Monats. Das Datum kann nach belieben gendert werden.
  Unsinnige Datumsangaben haben keinerlei Effekt!

- Datum bernehmen: In der Statistik, die am Ende der komprimierten LOG-Datei
  angehngt wird wurden bisher die Daten seit des _allerersten_ Poll vermerkt.
  Dies soll einen berblick verschaffen, was alles seit bestehen
  des Points an Daten durch die Telefonleitung geflossen ist.

  NUn kann man optional das Startdatum der Statistik auf das Datum
  des ersten Polleintrags setzen. Die Statistik wird dann ab diesem Datum
  berechnet. Sollte diese Funktion auf ein 'frisch' gefiltertes
  *.LOG-File angewendet werden, dann fehlen natrlich die Berechnungs-
  grundlagen und es wird nur der Datumseintrag verndert.

Ohne Optionen geht's auch. Einfach den OK Button anwhlen.... fertig.
Das Resultat ist dann eine bis auf das ntigste zusammengeschrumpfte
*.LOG Datei. Natrlich funktioniert der Gebhrenzhler des DOT
weiterhin.
Um die gesamte Statistik beim Crunchen nicht zu verlieren hngt LOG_FILT
ein paar Infos an die LOG-Datei an. Die Statistik umfat *_alle_*
Messages, Bytes usw. die seit bestehen des *.LOG-Files eingegangen
sind und nicht(!) nur die Daten, die seit dem letzten Filtern
eingegangen sind. Durch die Option DATUM BERNEHMEN wird das
Startdatum fr die Statistik auf das erste im *.LOG-File vermerkte
Polldatum gesetzt.

So, das wars! Viel Spa weiterhin,

| |
|_|we.


***************************************************************************
                                 HISTORY
***************************************************************************

v0.9  gabs nur in LUBERTS PLACE (0681-399637) *_Die Box im LightNet_*

v0.91 Ein paar Unschnheiten in der Benutzerfhrung wurden eliminiert. Auch
      die lstige Meldung von THE_DOT da ein Fehler im aufgerufenen 
      Programm aufgetreten ist, wurde beseitigt. Dieser Fehler trat nur dann 
      auf, wenn LOG_FILT.APP aus dem DOT gestartet wurde. 

v0.92 bis v.0.95 sind alle meiner Zerstreutheit oder Programmen, die
      ohne  Rckfragen namensgleiche Dateien berschreiben zum Opfer
      gefallen. Groe Teile des Quelltextes sind neu geschrieben
      worden, ohne da sich etwas an der Funktion gendert hat :-((
      Ich sollte es doch mal mit Backups versuchen.

v0.96 Der Filter v0.91 ist mit dem neuen Dot v2.11 in Umlauf gekommen.
      - Der Filter kann nun mit Parametern gestartet werden. Benutzer von
        GEMINI oder neuen TOS Versionen, die Iconen auf dem Desktop ablegen
        knnen knnen beliebige *.LOG -  Dateien auf das Datei-Icon des
        Filters ziehen, oder den Filter als Anwendung mit *.LOG
        Dateien anmelden.
      - Damit die Leute, die an verschiedenen Boxen pollen alle ihre *.LOG
        Dateien komprimieren knnen wurde das starre System, das auf die
        THE_DOT.LOG-Datei grndete gelockert. Es erscheint nun bei einem
        Start ohne Parameter jedesmal eine File-Selector-Box.
      - Es knnen beliebig viele *.LOG-Dateien in einer Sitzung bearbeitet
        werden und nicht wie vorher nur eine THE_DOT.LOG Datei.
      - Gesperrte Meneintrge lassen sich von nun ab auch nicht mehr
        per Tastatur anwhlen.
      - Eine weitere Option ermglicht es das Datum, das die Statistik
        anzeigt auf das Datum des in der LOG-Datei real vorhandenen
        ersten Polldatum zu setzen. Ansonsten wird das Datum des
        allerersten Polls mitgeschleppt.

v0.97 Der Filter hat bei mehrmaligem Bearbeiten einer Datei
      hintereinander seine Arbeit zu ernst genommen und alle Eintrge
      des *.LOG-Files gelscht. Der Filter nimmt nun wieder ohne
      Parameter seine Arbeit auf. Das Funktionierte in v0.96 nicht
      mehr.

v0.98 V0.97 eliminierte immer noch die *.LOG-Datei Dies sollte nun
      endgltig behoben sein. Nicht nur das Datum, sondern die
      gesamte Statistik wird bei DATUM BERNEHMEN aktualisiert.

***************************************************************************
                              Thanx to
***************************************************************************

- Pink Floyd, die mich dann und wann aus der Realitt hieven.

- Elmi, der mit seiner Radioshow 1000 Mal bessere Unterhaltung bietet
  als es das Fernsehn je kann.

- All die, die  mit guten Tips und Ratschlgen konstruktive Kritik an
  meinem Programm gebt haben. Besonders Michael Lupp, der ein
  besonderes Gespr fr versteckte Fehler hat.

