@DATABASE "HKTAreafix.guide" @master "HKTAreafix.guide" @NODE MAIN "HKTAreafix" HKTAreafix V1.556ß © by Juergen Ehnes 22.11.93-14.04.95 written by Juergen Ehnes 1993-1995 HT-Dokumentation V0.6 @{"Rechtliche Dinge " LINK "recht"} @{"Registrierung " LINK "register"} @{"Systemvoraussetzungen " LINK "system"} @{"Installation " LINK "install"} @{"Benutzung " LINK "use"} @{"Wer DLGMail 2.5+ benutzt !!" LINK "killf"} @{"Optionen " LINK "options"} @{"Format von dlgmail.are " LINK "format"} @{"Geschichte " LINK "history"} @{"Zukunft " LINK "future"} @{"Bugreports " LINK "bugs"} @{"Autor " LINK "author"} @{"Danksagung " LINK "thanx"} @ENDNODE @NODE recht "Rechtliche Dinge" Gueltigkeit: ------------ Diese Dokumentation bezieht sich auf die obige Version von HKTAreafix, falls die Programmversion beim Programmstart hoeher sein sollte, dann bitte nach Readme-Files ausschau halten, da einige Features die in dieser Dokumentation enthalten sind vielleicht veraltet, oder nicht mehr vorhanden, oder ge- aendert sind. Lizenz: ------- Dieses Programm ist Shareware. Das heisst, der Benutzer erwirbt ein kosten- loses benutzungsrecht fuer 30 Tage, in diesen 30 Tagen kann er das Programm im Praxiseinsatz ausprobieren. Falls vom Benutzer erwogen wird, das Pro- gramm laenger einzusetzen, muss eine Share an den Autor von 25DM oder 20US$ gezahlt werden. ^^^^ ^^^^^ Die unregistrierte Version darf beliebig kopiert und weitergegeben werden, es duerfen aber max. 5DM kopiergebuehr dafuer verlangt werden Andere Rechtliche Dinge: ------------------------ Das Programm wird auf eigene Gefahr benutzt, der Autor uebernimmt keinerlei Haftung, fuer irgendwelche Schaeden, die von diesem Programmpaket verursacht werden. Desweiteren darf dieses Programm ganz oder in teilen nicht in kommerziellen Programmen ohne Schriftliche Genehmigung des Autor benutzt werden. Dieses Programm darf in der unregistrierten Version in Mailboxen und FTP Servern zum download bereitgestellt werden, sowie in PD-Sammlungen auf- genommen werden, aber nur in der urspruenglichen Form, also ohne .displayme und sonstige Files ! @ENDNODE @NODE register "Registrierung" Registrierung: -------------- Als registrierter Anwender erhaelt man regelmaessig die Updates zu diesem Programm, wenn man uebers Fido oder Usenet erreichbar ist, bekommt der registrierte Anwender die Neue Version oder den Patch kostenlos via EMail zugeschickt, wenn der Anwender an keins der beiden Datennetze angeschlossen ist, und neue Neue Version per Post geschickt werden soll, dann muss der Anwender die Disk, Porto und Verpackung selber bezahlen, ansonsten ist die Neue Version kostenlos. Als registrierter Anwender kann man auch jederzeit Hilfe zum Programm selber bekommen, einfach dem Autor eine PM schreiben, es wird dann so schnell wie es geht geantwortet. Wie kann man sich registrieren lassen ?? Einfach das Geld (nur bar oder per Euroscheck) an die untenstehende Adresse schicken, die registrierte Vollversion kommt dann binnen ein paar Tagen. In Europa wenn moeglich bitte in DM oder per Euroscheck mit DM ausgefuellt schicken. Bitte folgende Informationen angeben: -Name und Vorname -Adresse -Benutzter Operatorname fuer die Personalisierung -Versionsnummer des Programms -Mailadresse Adresse fuer die Registrierung: Juergen Ehnes Geschw.-Scholl-Str.6 71540 Murrhardt @ENDNODE @NODE system "Systemvoraussetzungen" Systemvoraussetzungen: ---------------------- Hardware: Amiga 500/600/1000/1200/2000/2500/3000/4000(030/040) OS 2.04/3.0+ mind. 256KB RAM Festplatte Software: Dieser Areafix wurde fuer das Programm DLGMail geschrieben. Es ist also nur fuer DLG-Boxen geeignet. Falls genuegend Interesse besteht, kann das Programm auch fuer andere Box- programm erweitert werden, dann halt einfach PM an den Autor. Das Programm liegt in 2 Verschieden Versionen vor, entweder als normale 68000er Version, oder als Version fuer 68020 und hoeher, die 020+ Version ist etwas optimiert, und damit auch manchmal etwas schneller und vor allem ist sie etwas kuerzer. @ENDNODE @NODE install "Installation" Installation: ------------- 1.Archiv entpacken, und directory an die Stelle der Platte kopieren an der man es haben moechte. 2.In die User-Startup folgendes eintragen: ASSIGN AREAFIX: wobei der Pfad ist, in dem der Areafix liegt, also z.B. hd0:areafix 3.Die Passwoerter in der Datei Areafix.cfg eintragen, und zwar so: PASSWD also sollte es etwa so aussehen: PASSWD 1 test PASSWD 2 hallo ... 4. In der @{"Areafix.cfg" LINK "options"} die einzelnen erforderlichen Punkte eintragen, Erklaerung dazu folgt unten. 5.Die Dateien areafix, @{"Areafix.cfg" LINK "options"} und sollten entweder im Verzeichnis Areafix: oder evt. im aktuellen Pfad. 6.In der Mailbox den User Areafix mit der Pointnummer 0 einrichten (siehe Handbuch) 7.Im areafix.cfg File die Nummer der ersten Mail eintragen die bearbeitet werden soll, bei einem neu eingerichteten User waere das 1 8.Das Programm Areafix einfach in die entsprechende Batchdatei eintragen, also z.B. in den Aftersessionbatch, oder in den Mitternachtsbatch, oder sonstige... 9.Ab jetzt sieht der Areafix regelmaessig wenn er aufgerufen wird, nach ob eine Mail fuer ihn gekommen ist, und wenn das der Fall ist wird sie bearbeitet @ENDNODE @NODE use "Benutzung" Benutzung: ---------- Einfach das Programm HKTAreafix aufrufen, wenn eine neue Message fuer den Area- fix gekommen ist, erkennt der Areafix es daraufhin selber und traegt die neuen Areas ein oder aus. Der Areafix kann durch ein Batchfile entweder nach jedem Pollen eines Points gestartet werden, oder eben immer kurz vor dem Pollen vom HUB. Da die Aenderungen auch dann erst wichtig werden, im ersten Fall kann der Point eben gleich nochmal pollen, und somit gleich die Erfolgsmeldung erhalten, ansonsten bekommt er sie eben erst am naechsten Tag. Die Areas die nur Sysops beziehen duerfen koennen durch: ; SECURITY 5000 von den Pointareas abgetrennt werden. Bis jetzt werden sie einfach nicht angezeigt, falls genuegend Interesse fuer eine Einteilung in Stufen, bitte EMail an mich, dann werde ich es verwirklichen. Nutzung durch den Point: ------------------------ Der Point muss eine Mail an den User Areafix mit der Pointnummer 0 schreiben, als Subject dient das Passwort. Dieses sollte vorher mit dem Sysop ausgemacht werden. Der Header sollte in etwa so aussehen: From : Juergen Ehnes 2:246/1416.6 26-Dez-93 To : Areafix 2:246/1416.0 Subject : passwort -------------------------------------------------------------------------- +areaname - bestellt eine Area -areaname - entfernt eine Area %HELP - sendet ein Helpfile an den Point %LIST - gibt die Liste aller Verfuegbaren Areas des Nodes aus %QUERY - gibt eine Liste aller vom Point bezogenen Areas aus %PAUSE - mit diesem Befehl kann man wenn man z.B. in den Urlaub geht, alle Areas abbestellen, und danach mit %RESUME wieder bestellen ACHTUNG !! In einer Mail, in der %PAUSE steht, darf keine andere Anweisung stehen !!!! Wenn vor %PAUSE ein +area oder -area steht, wird das %PAUSE nicht beachtet !!!!! Selbiges gilt fuer %RESUME, alles danach wird ignoriert. %RESUME - macht %PAUSE wieder rueckgaengig. %PASSIVE - bewirkt das gleiche wie %PAUSE %ACTIVE - bewirkt das gleiche wie %RESUME In der Areafixmail darf sonst kein Text und keine unterschrift stehen !! Der Node kann den Areafix nicht nutzen, da er Pointnummer 0 hat, und in den Kludges das FMPT Feld fehlt, ausserdem kann aus einer Mailbox selber auch keine Areafixmail geschrieben werden, weil die Mail wieder Pointnummer 0 hat, bzw. FMPT fehlt ! ACHTUNG: Die Message an den Areafix MUSS eine Private Message sein !!!!! @ENDNODE @NODE options "Optionen" Optionen in Areafix.cfg: ------------------------ MAILNUMMER - dahinter muss die Nummer der ersten Mail stehen, die gescannt werden soll. Beim ausfuehren wird die Nummer von selbst er- hoeht, die Mailnummer muss also nur fuer die allererste Mail eingetragen werden MAILDIR - dahinter steht das Verzeichnis, indem die Mails an den Areafix abgelegt werden MAILADRESS - Hier wird die Nummer des Nodes (ohne .0 am schluss eingetragen) AREAFILE - dahinter steht der Pfad und der Name des areafiles, also z.B.: HD0:dlg/dlgmail.are LOGFILE - hier steht der Name und Pfad des Logfiles OUTBOUND - hier steht der Pfad des outbound-directorys CONFIGFILE - hier steht Pfad und Names des dlgmail.cfg files @ENDNODE @NODE format "Format von dlgmail.are" Format der Echoliste: ----------------------- So muss eine Zeile der Echoliste(also DLGMAIL.are) aussehen: TAG [Hubnummer|1.Pointnummer*] [ weiter Points] *Beim ersten Mal mit Netz/Node[.Point] jedes weitermal entweder nur noch Pointnummer, oder Node/Point, oder nur Nodenummer. Parameter in eckigen Klammern sind optional. @ENDNODE @NODE history "Geschichte" Geschichte: ----------- Version 1.557 25.06.95: Resumebug fixed Version 1.556 14.04.95: A few bugs fixed Version 1.551 09.04.95: Es wird jetzt die Verwaltung mehrere Netze unter stuetzt !! Version 1.012 10.07.94: Problem mit UMS beseitigt, es wird nicht mehr immer die gleiche MSGID verwandt, sondern der pktname. Version 1.000 17.02.94: KILLF programm dazugeschrieben, damit Areafix auch mit DLGMail 2.50+ laeuft Version 0.999 13.01.94: Bug in Pausefunktion entfernt ! Optimiert ! Version 0.998 12.01.94: Passwoerter jetzt ins configfile verlegt. Fehler ausgebaut, der auftrat, wenn zwischen TAG und Areaname mehr als ein Leerzeichen war, dann wurden bei Query nur Leerzeilen angezeigt. Version 0.995 08.01.94: Sicherheitsabfrage bei der 020er Version noch integriert, ob wirklich ein 68020 da ist. Version 0.994 07.01.94: 68000er Version korrigiert, ist abgestuerzt, da Langwortzugriffe auf ungerade Adressen stattfanden Version 0.991 06.01.94: Kludges MSGID und INTL eingebaut, fuehrte manchmal dazu, dass die Successmails im BAD landeten wenn die Kludges nicht da waren. %PASSIVE, %ACTIVE eingebaut. Version 0.986 31.12.93: Bugfixed. Version 0.984 28.12.93: Official Release. Version 0.983 26.12.93: Jetzt kann nur noch ein Task auf einmal laufen, d.h. der Areafix kann jetz auch im Aftersessionbatch auf- gerufen werden, da er andere Areafixtasks blockiert, bis er fertig ist Jetzt sind auch die Befehle %PAUSE und %RESUME installiert. Bugfixed. Version 0.964 22.12.93: Bugfixed. Nun koennen SysopAreas durch den Kommentar: SECURITY 5000 von den Pointareas abgetrennt werden Version 0.960 22.12.93: Bugfixed. Verbesserte Keyfileabfrage. Abfrage des Passwortes im SubjectFeld nun eingebaut Version 0.947 18.12.93: Areafix.cfg kann auch im s: Directory oder im Areafix: directory liegen. Keyfileabfrage integriert Version 0.944 17.12.93: Die Befehle %HELP, %LIST und %QUERY sind integriert Version 0.929 17.12.93: Successmails sind integriert. Logfiles sind nun auch in der unregistrierten Version vorhanden. Version 0.899 15.12.93: Bugfixed. Bisher wurden Points nicht eingetragen, wenn ihre nummer in irgendeiner Form schon mal in der Zeile auftaucht, also .1 wurde nicht eingetragen wenn schon .12 da war. Version 0.889 10.12.93: Rename wird nur noch beim ersten mal augefuehrt Bugfixed. Areanamen, die gleich begonnen haben, wurden evt. vertauscht Version 0.873 09.12.93: Bugfixed. Der Pfad des Mailverzeichnises wurde nicht uebernommen Logfiles werden jetzt erstellt. Aber nur in der registrierten Version. Ab jetzt ist Kick2.04 absolutes Minimum. Die unregistrierte Version muesste auch noch mit Kick1.2/1.3 funktionieren Version 0.846 08.12.93: Zweites Beta Release. ConfigFile geaendert. Benutzbar mit Kick 1.2 bis 3.0+ Version 0.727 06.12.93: Erstes Beta Release. Version 0.001 22.11.93: Erste Testversion @ENDNODE @NODE future "Zukunft" Zukunft: -------- Zusaetze die in geplant sind: - Befehl zum Aendern von Passwoertern wird noch integriert - Lokalisierung fuer verschiedene Sprache - Optimierung - Notify-Funktion zur Ueberwachung des Areafixusers, zum Starten des Areafix nur wenn tatsaechlich eine Mail gekommen ist. - Differenzierbare SecurityLevel, nicht nur einen - Auch anderen Nodes zugriff auf den Areafix ermoeglichen. @ENDNODE @NODE bugs "Bugreports Bugreports: ----------- Falls jemandem Fehler in dem Programm auffallen, soll er sich doch bitte an den Autor wenden, Post- oder Emailadressen stehen unten. Ich bin fuer jeden Hinweis auf Fehler und fuer jede Verbesserungsidee im und zum Programm dankbar, denn wenn Resonanz von den Usern kommt, kann man so ein Programm auch weiterentwickeln und verbessern. @ENDNODE @NODE author "Autor" Autor: ------ Juergen Ehnes Geschw.-Scholl-Str.6 71540 Murrhardt Email-Adressen: Fido : 2:246/1416.6 Usenet/ : juergen@ehnami.tynet.sub.org Z-Netz : juergen@amiuni.tynet.sub.org Internet: ehnesjn@minnie.informatik.uni-stuttgart.de Internet: zdsb1121@studbox.rus.uni-stuttgart.de @ENDNODE @NODE thanx "Danksagung" An dieser Stelle moechte ich allen Personen Danken, die mir bei der Entwicklung des Areafix geholfen haben, insbesondere: - Meiner Frau, die waehrend der Zeit in der ich programmiert habe viel Geduld aufbringen musste mit mir - Jan "Mr. GW" Schmidwenzl, fuer die Idee zum Programm, seine vielen ausdauernden Tests, der immer absturzgefaerdeten Versionen und auch die vielen interessanten Chats und Telefongespraeche, manchmal hab ich ihn bestimmt schon genervt :-)) - Allen Points der Amiga Universe, die in der Testzeit jeden Tag viele Mails an den Areafix geschrieben haben und mich ausserdem bei GW immer aus- geloescht haben :-)) - Christian "Hechel" Hechelmann, fuer die vielen Tips, und sonstige Dienste die er mir erwiesen hat. - Peter "Ich hasse Hyper Typer" Meyer, ebenfalls fuer die guten Tips - Peter Findeisen - Karsten Weiss - Ralph Babel, fuer seine Guru-Buecher - Commodore, fuer den Amiga - Den Autoren der RKRMs, fuer die beste Amiga-Dokumentation - Peter Wollschlaeger, fuer sein Assembler Buch, mit dem ich die Assembler programmierung angefangen hab - Christian Anders, fuer die vielen interessanten Gespraeche - Carsten Mueller, fuer den Hinweis, dass die 68000er Version nicht laeuft - und allen, die ich sonst noch vergessen hab. @ENDNODE @NODE killf "Benutzer von DLGMail 2.5+" Wer DLGMail 2.5+ (Version ab Oktober 93) benutzt muss das Programm KILLF einsetzen, denn DLGMail haelt einen Exclusiv Lock auf die Datei DLGMail.ARE. Das heisst, ohne das Program KillF kann der Areafix die Datei DLGMail.ARE nicht veraendern. Also das Programm KillF wie in der Anleitung beschrieben vor dem Areafix starten und nach dem Areafix ein zweites mal starten, um DLGMail zu reaktivieren. Durch das Programm wird DLGMail nur gestoppt und der Filelock freigegeben, nach Beendigung von KILLF macht DLGMail normal an dem Punkt weiter, an dem es vorher aufgehoert hat. Der HKTAreafix wartet uebrigends, bis KILLF tatsaechlich den Lock befreit hat, denn falls DLGMail noch tossed, unterbricht der Areafix DLGMail nicht, sondern wartet, bis dieses fertig ist. ACHTUNG: Der Areafix und KILLF muessen aus der selben SHELL gestartet werden. @ENDNODE