Dokumentation zum Tool "Box-Register Version 1.0": ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Inhalt: ( 1)....Sinn und Zweck des Programmes ~~~~~~~ ( 2)....Inhalt des Archives ( 3)....Disclaimer, Haftung, Copyrights ( 4)....Installation ( 5)....Automatische Registration ( 6)....Das Registrations-Menue ( 7)....Das Hauptmenue ( 8)....Das Box-Lister-Menue ( 9)....Der Editor / Das Check-Menue: (10)....Der Mail-Server (11)....bekannte Bugs, Fehler, Komplikationen (12)....Danksagung (13)....Weitere Tools des Programmierers (14)....Kontaktadressen (1) Sinn und Zweck des Programmes: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Das Programm "Box-Register" ist ein Online-Tool fuer User von AmBoS- Mailboxsystemen. Der User hat zum einen die Moeglichkeit, anhand einer von ihm eingegebenen Vorwahl-Nummer, einen Staedte-Namen zu ermitteln. Jenes kann recht sinnvoll sein, wenn man beispielsweise Mailbox-Werbungen in Netzen sieht, dort aber nur eine Vorwahlnummer bekanntgegeben wird, nicht aber der entsprechende Staedtenamen. Weiterhin kann der User dann eine Liste aufrufen, in der verschiedene Mailboxen mit ihren Daten aufgelistet sind, die in diesem Vorwahl- Bereich zu finden sind. Die Mailboxdaten setzen sich zusammen aus: Mailboxname, Vorwahlnummer, Rufnummer(n) (maximal 10 Ports), Bemerk- ungen (maximal 280 Zeichen), Username des Sysops, EMail-Adresse der Mailbox (Domain) und der Username der Person, die die Box bekanntgab. Jeder User hat weiterhin die Moeglichkeit, eine beliebige Box mit ihren Daten in das "Box-Register"-Tool selbst einzutragen. Der neue Datensatz wird jedoch nicht sofort freigegeben, sondern wird dem Sysop bei seinem naechsten Aufruf des Programmes angezeigt. Nun kann dieser die Box "freigeben" oder "nacheditieren" oder auch loeschen. Jene Sicherheitsmassname wurde getroffen, um Missbrauch auszuschliessen. (2) Inhalt des Archives: ~~~~~~~~~~~~~~~~~~~~~~~~~ Das LHA-Archiv enthaelt folgende Programme, bzw. Unterverzeichnisse: Box-Register/Box-Register ( 33996 Bytes ) Box-Register/Box-Daten.info ( 628 Bytes ) Box-Register/Box-Register.ansi ( 2237 Bytes ) Box-Register/Box-Register.doc ( 21048 Bytes ) Box-Register/Box-Register.doc.info ( 291 Bytes ) Box-Register/Box-Register.VWO ( 77472 Bytes ) Box-Register/Box-Register.VWO.info ( 284 Bytes ) Box-Register/Box-Daten.info ( 628 Bytes ) Box-Register/Box-Daten/04221 ( 584 Bytes ) Box-Register/Box-Daten/04431 ( 584 Bytes ) Box-Register/SMail ( 11048 Bytes ) Box-Register/SPuffer ( 8064 Bytes ) Box-Register/Register.txt ( 1868 Bytes ) Box-Register/Register.txt.info ( 284 Bytes ) FILE_ID.DIZ ( 251 Bytes ) Um Manipulationen Dritter auszuschliessen, benutzen Sie nur Programme, die die richtige Byte-Laenge besitzen. Um sicher zu gehen, ein garantiert unveraendertes Archiv zu besitzen, koennen Sie das "Box-Register"-Tool von der Support-Mailbox des Autors downloaden (siehe: Kontaktadressen). (3) Disclaimer, Haftung, Copyrights: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Das Programm "Box-Register Version 1.0", sowie alle dazugehoerigen Progammteile sind FREEWARE! Es darf frei kopiert und weitergegeben werden, solange fuer die Duplizierung kein Geld genommen wird und das Programm, sowie Programmteile, Beschreibungen und diese Dokumentation unveraendert bleiben. Eine Distribution in Mailboxen ist ausdruecklich erwuenscht! Saemtliche Rechte liegen bei dem Autor des Programmes. Der Autor schliesst jegliche Haftungen bei die Benutzung des Programmes aus und kann fuer moegliche Schaeden an Soft- und/oder Hardware oder fuer moeglichen Datenverlust, die direkt oder indirekt durch das Programm verursacht wurden, nicht verantwortlich gemacht werden. Die Benutzung des Programmes geschieht auf eigene Gefahr. Der Autor versichert, dass ihm vor der Veroeffentlichung keine Fehler bekannt sind, die oben genannte Schaedigungen herbeifuehren koennten. Sämtliche genannten Firmen-, Marken- und Artikel-Namen, sowie Copyrights in dieser Dokumentation, im Programm oder in Programmteilen liegen bei den entsprechenden Herstellern, Autoren oder Programmier- ern. Alle Rechte vorbehalten. Die in dem Archiv enthaltenen Zusatzprogramme "SMail Version 1.0" und "SPuffer Version 1.2" stammen von: (c) Kai Szymanski & Jörg Eßmann 1993/1994/1995 Ueber Bugreports (Hinweise auf Fehler), Verbesserungsvorschlaege und Meinungen der Benutzer ueber das Programm ist der Autor immer dankbar (siehe: Kontaktadressen)! Moegliche gramatikalische Fehler oder Rechtschreibfehler sind zu entschuldigen. (4) Installation: ~~~~~~~~~~~~~~~~~ A.: Installation unter AmBoS bis Version 2.054: Zuerst muessen alle Dateien aus dem Archiv in ein beliebiges Verzeich- nis kopiert werden. Es empfiehlt sich: BBS:Externe/Box-Register/ Anschliessend muss das Tool als "externer" Befehl unter AmBoS einge- bunden werden. Dazu aktiviert man den Button "AmBoS-SETUP" im Haupt- Screen von AmBoS und oeffnet das Fenster namens "Befehle". Durch "Neuer" kann ein neuer Befehl definiert werden. Nun muss dem Befehl ein "Kommandoname" vergeben werden. Empfehlenswert ist bei- spielsweise "Box-Register" oder aehnliches. Im folgenden muss eingetragen werden, dass es sich bei dem Tool um einen externen Befehl handelt. Dazu drueckt man mit der Maus auf den Button "Befehl Type" und stellt dort "Extern" ein. Anschliessend gibt man das "Kommando" an, welches aufgerufen werden soll. Es oeffnet sich ein Requester, in dem man das Programm auswaehlen kann. Hier muss das Hauptprogramm mit dem Filenamen: "Box-Register" angegeben werden. Nun wird der neue Befehl durch anhaken des Gadgets "Eingeschaltet" aktiviert und steht zur Benutzung frei. Bei Bedarf kann man den Befehl auch nur speziellen Gruppen zugaenglich machen, in dem man die entsprechende Gruppe unter "Nur Gruppe" zu- weist. B.: Installation unter AmBoS ab Version 2.063: Richten Sie das Programm wie oben beschrieben als einen externen Befehl ein. Waehlen Sie anschliessend unter: "AmBoS-SETUP/ OnlineMenu" ein entsprechendes Menue aus, in dem das Tool eingerichtet werden soll. In der Regel kann das Tool in JEDEM Menue eingestellt werden. Suchen Sie ein geeignetes Untermenue aus (z.B: "Externe Programme" oder "Tools") und richten Sie mit "Neu" einen neuen Menue- Punkt ein: Name................: Box-Register (oder beliebiger Name!) Art.................: Extern Nur Gruppe..........: (kein Eintrag noetig!) Externe Menuepunkte.: Box-Register Der "Name" des neuen Menuepunktes kann selbstverstaendlich frei gewaehlt werden. Ausserdem kann ein sogenannter "Shortkey" definiert werden. Ziehen Sie bitte das AmBoS-Guide zur Hilfe, um weitere Informationen darueber zu erhalten. Mit "RAUF" und "RUNTER" kann der Menuepunkt nun an die gewuenschte Position gerueckt und dann mittels dem Anhaken eingeschaltet werden. Abschliessend muessen die Aenderungen mit Hilfe von "SPEICHERN" gesichert werden. (5) Automatische Registration: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Nach der Installation sollte das Programm vom Sysop das erste Mal aufgerufen werden. Man gelangt sofort in das "Registrations-Menue". An dieser Stelle sollte ausdruecklich darauf hingewiesen werden, dass das "Box-Register" Tool FREEWARE ist! Die "Registration" bezieht sich nicht auf den Antrag zur Benutzungserlaubnis oder aehnlichem, sondern hat folgende Bedeutung: Saemtliche Mailboxdaten, die dieses Programm verwaltet, werden in einem "Datenfile" gespeichert. Da jedoch jede Mailbox, in der das "Box-Register"-Tool im Einsatz ist, ihr eigenes Datenfile hat, wird ein offizielles Datenfile vom Autor des Programmes gefuehrt. Jeder Sysop hat die Moeglichkeit, seine eigene Box dort KOSTENLOS "registrieren" (eintragen) zu lassen. Das offizielle Datenfile wird regelmaessig im "AmBoS-NET" veroeffentlicht, oder liegt in den entsprechenden Support-Mailboxen zum Download bereit. Es gibt folgende zwei Wege, zu einer "Registration" zu gelangen: a) Die automatische Registration ueber das Programm selbst (siehe "das Registrations-Menue") b) eine eigene Registrations-Mail an den "MailServer" schicken (siehe "Der Mail-Server") In beiden Faellen werden die Daten vollkommen automatisch ausgewertet und zu dem offiziellen Datenfile hinzugefuegt. Als Bestaetigung erhaelt der Sysop der entsprechenden Mailbox eine Benachrichtigung, das seine Mailboxdaten richtig verarbeitet wurden und in der naechsten Version des Datenfiles veroeffentlicht werden. Da sich jedoch Mailboxdaten staendig aendern koennen (z.B. neue Domain, neue Rufnummern, anderer Sysopname, usw) werden die Mailbox- Daten fuer einen begrenzten Zeitraum von 90 Tagen gespeichert. Anschliessend muessen die Daten von den jeweiligen Sysops aktualisiert werden. Das Programm "Box-Register" fordert den Sysop automatisch nach der besagten Zeit erneut auf, seine Mailbox-Daten bekanntzugeben und sich wieder "registrieren" zu lassen. Jenes stellt sicher, dass sich das offizielle Datenfile stets auf dem aktuellsten Stand befindet. (6) Das Registrations-Menue: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Im Registrations-Menue erhaelt der Sysop zuerst ein paar kleine Informationen ueber die Registration. Anschliessend hat man folgende Auswahlmoeglichkeiten: => Aktiviert den Registrations-Editor (siehe unten!) => Startet zuerst das Tool "Box-Register" und ermoeglicht eine Registrierung zu einem spaeteren Zeitpunkt => Beendet das Registrations-Menue und ruft das Hauptmenue auf. Erst nach 90 Tagen wird der Sysop erneut gefragt, ob er seine Mailboxdaten in dem offiziellen Datenfile eintragen moechte. => Gibt nocheinmal Informationen ueber die Registrierung des "Box-Register"-Tools aus. Im "Registrations-Editor" werden folgende Mailbox-Daten abgefragt: - Vorwahlnummer - Mailboxname - Rufnummer(n) - Bemerkungen - Username des Sysops - Domain des Sysops (7) Das Hauptmenue: ~~~~~~~~~~~~~~~~~~~~ Folgende Punkte stehen im "Hauptmenue" zur Verfuegung: => [Nur fuer den SYSOP!] Ueber diesen Punkt gelangt man in den Editor, sofern noch nicht freigegebene Eintraege vorhanden sind. => Hier kann man eine beliebige Vorwahlnummer eingeben. Sollten in diesem Vorwahl-Bereich Mailboxen bekannt sein, gibt das Programm dieses bekannt. => Gibt Informationen zum Tool "Box-Register" aus. => Sofern Mailboxen in dem vorher eingegebenen Vorwahl- Bereich bekannt sind, kann man ueber diesen Punkt die entsprechenden Daten abrufen. => Beendet das Tool "Box-Register" => [Nur fuer den SYSOP!] Hier ist es moeglich, seine Mailbox registrieren, bzw. in dem offiziellen Datenfile eintragen zu lassen, wenn man nach dem Start im Registrierungs- Menue ausgewaehlt hatte. (8) Das Box-Lister-Menue: ~~~~~~~~~~~~~~~~~~~~~~~~~~ Hat man beispielsweise im Hauptmenue den Punkt angewaehlt, so befindet man sich im "Box-Lister-Menue". Hier hat man nun die Moeglichkeit, sich alle Mailboxen mit ihren Daten anzeigen zu lassen, sofern mindestens eine Mailbox in dem entsprechenden Vorwahlbereich bekannt (in dem Datenfile eingetragen) ist. Folgende Punkte stehen im "Box-Lister-Menue" zur Verfuegung: => Sofern mehr als eine Mailbox in dem Datenfile existiert, wird hier die entsprechend naechste ausgegeben. Die Num- mer der jeweils aktuellen und die Anzahl der insgesamt vorhandenen Boxen in dem entsprechenden Vorwahlbereich wird oben rechts im Bildschirm angezeigt. => Verzweigt in den Editor, wo der aktuelle Eintrag editiert werden kann [nur fuer den SYSOP!], oder ein neuer, eigen- er Datensatz erstellt werden kann. => Hiermit gelangt man zurueck in das "Hauptmenue". (9) Der Editor / Das Check-Menue: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In den Editor gelangt man ueber zwei Moeglichkeiten. Zum einen als User, indem eine neue Mailbox eingetragen werden soll (siehe "Box- Lister-Menue") oder als Sysop, wenn es gilt, eine neu eingetragene Mailbox zu "checken" (zu kontrollieren) und anschliessend zu entscheiden, jene "freizugeben" oder wieder zu "entfernen" (loeschen). Folgende Punkte stehen im "Editor" zur Verfuegung: => Sofern mehr als eine Mailboxen zu editieren ist, wird hier die jeweils naechste ausgegeben. => [Nur fuer den SYSOP!] Sysops koennen hiermit die naechste Mailbox-Liste mit noch nicht freigegeben Eintraegen abrufen. => Ermoeglicht das Editieren von vorhandenen Eintraegen. => Loescht den gerade angezeiten Eintrag (OHNE SICHER- HEITSABFRAGE!). => Hier koennen Sysops, sowie auch User neue Mailboxen eintragen. Mit Hilfe dieses Punktes wird der zuvor eingegebene Freigeben> Eintrag abgespeichert, oder ein noch nicht freigege- bener Datensatz freigegeben. => Verlaesst den Editor. Anhaengig von der Ausgangsposi- tion, von wo aus der Editor aufgerufen wurde, gelangt man wieder zurueck: - vom Box-Liste-Menue: zurueck ins "Hauptmenue" - vom Hauptmenü/Check: Programm beenden (10) Der Mail-Server: ~~~~~~~~~~~~~~~~~~~~~~ Jeder Sysop hat, wie schon erwaehnt, die Moeglichkeit, seine eigene Mailbox mit den entsprechenden Daten "registrieren" zu lassen. Wie unter Punkt (5) erlaeutert, enthaelt das Tool "Box-Register" eine automatische Registration, die der Sysop beim ersten Aufruf des Programmes und nach jeweils 90 Tagen ausfuellen und "abschicken" kann. Allerdings gibt es auch noch einen weiteren Weg, seine (oder eine andere) Mailbox in dem offiziellen Datenfile eintragen zu lassen: Ein sogenannter "automatischer MailServer" ist in der Mailbox des Programmierers von "Box-Register" installiert. Dieser "MailServer" kann ueber folgende EMail- Adresse angeschrieben werden: register@adonai.dontpanic.sub.org Als Betreff der Mail kann eine beliebige Angabe erfolgen. Der eigentliche Text innerhalb der Mail ist allerdings sehr wichtig und darf nicht veraendert, bzw. gekuerzt werden. Das File "Register.TXT" stellt eine Registrations-Nachricht ("Registrierungs-Formular") da: Registrierungs-Formular: ~~~~~~~~~~~~~~~~~~~~~~~~ Bitte vollstaendig ausfuellen. Keine Zeilen oder Zeichen entfernen oder selbst hinzufuegen! Alle Angaben sind ab Spalte 20 (genau nach dem ">") zu machen. Mehrere Rufnummern jeweils durch "," trennen und keine Leerzeichen verwenden (beispielsweise: 121030,121031,121032). Es sind maximal 10 Rufnummern moeglich. Bei der Domain ist nur der Netzname und die eigentliche Domain erforderlich (z.B.: "@nasus.north.de"), kein Username davor! Bei weniger als 7 Zeilen bei den Bemerkungen, sind die "leeren" Zeilen einfach ohne Angabe zu lassen (jedoch keine Zeilen entfernen!). ----------------------------------------------------------[ START ]--- Mailboxname.......> Vorwahl-Nummer....> Rufnummer(n)......> Sysop-Username....> Domain............>@ Bemerk, Zeile 1...> Bemerk, Zeile 2...> Bemerk, Zeile 3...> Bemerk, Zeile 4...> Bemerk, Zeile 5...> Bemerk, Zeile 6...> Bemerk, Zeile 7...> -----------------------------------------------------------[ ENDE ]--- Der Mailboxname und jede Zeile der Bemerkungen koennen eine maximale Laenge von 40 Zeichen besitzen. Die Vorwahl-Nummer darf 6 Zeichen, die einzelnen Rufnummern (durch Kommatar getrennt) 10 Zeichen nicht ueberschreiten. Der Sysopname kann maximal 29 Zeichen lang sein und Die EMail-Adresse der Box maximal 57 Zeichen ohne das "@". Da die Registrierungs-Mail vollkommen automatisch ausgewertet wird, achten Sie unbedingt darauf, das ihre Registrierungs-Mail alle 14 oben aufgefuehrte Zeilen (inklusive der Zeilen "START" und "ENDE") unter- einander enthaelt und sich keine eigenen Angaben zwischen den Zeilen befinden. Alle Angaben, Anmerkungen, Hinweise, Signaturen oder sonstige Texte, oberhalb der "START" Markierung oder unterhalb der "ENDE" Markierung werden ignoriert. Eine richtig ausgefuellte Registrations-Mail kann beispielsweise wie folgt aussehen: ----------------------------------------------------------[ START ]--- Mailboxname.......>Another Door Vorwahl-Nummer....>04221 Rufnummer(n)......>64654,64655 Sysop-Username....>Grisu Domain............>@adonai.dontpanic.sub.org Bemerk, Zeile 1...>Support-Mailbox 'Box-Register' Bemerk, Zeile 2...>AmBoS Mailbox-System (AMIGA) Bemerk, Zeile 3...> Bemerk, Zeile 4...> Bemerk, Zeile 5...> Bemerk, Zeile 6...> Bemerk, Zeile 7...> -----------------------------------------------------------[ ENDE ]--- Die vollstaendig ausgefuellte Nachricht ist an den MailServer zu schicken (EMail-Adresse siehe oben!). Sofern der MailServer die Nachricht richtig verarbeiten konnte, erhaelt der Sysop der entsprechenden Mailbox eine Bestaetigungs-Mail, das seine Mailboxdaten richtig verarbeitet wurden und in der naechsten Version des Datenfiles veroeffentlicht werden. Sollten fehlerhafte, unzulaessige oder unmoegliche Angaben oder Werte erkannt worden sein, wird der Sysop mit einer Fehlerbeschreibung benachrichtigt, das seine Registrations-Mail nicht verarbeitet werden konnte. (11) bekannte Bugs, Fehler, Komplikationen: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Jede Verion des Programmes "Box-Register" fuer AmBoS Mailbox-Systeme mussten sich vor der Veroeffentlichung harten Tests unterziehen und wurden von strengen Betatestern geprueft. Saemtliche gefundenen Fehler konnten in den Betatestphasen beseitigt werden und dem Programmierer des Tools "Box-Register" sind daher KEINE Fehler bekannt! Ueber Bugreports (Hinweise auf Fehler), Verbesserungsvorschlaege und Meinungen der Benutzer ueber das Programm ist der Autor immer dankbar (siehe: Kontaktadressen)! Moegliche gramatikalische Fehler oder Rechtschreibfehler sind zu entschuldigen. (12) Danksagung: ~~~~~~~~~~~~~~~~~ Ein großes Dankeschön den beiden Betatestern, bAStARd (ehem. Sysop der hEllGAtE) sowie Nitro (Sysop der TrueLies BBS ). Dann wären da noch zu erwähnen, Klaro - der immer wieder ein paar Tips hatte, McMarco - der für die Tips des nicht zu aufdringlichen Desings Verantwortlich zeichnet. und einige weitere User der ANOTHER DOOR IN PARADISE die es sich nich nehmen liesen , hier und da mal ein paar wilde Einträge zu machen. Nicht zu vergessen , der Freundliche Markus Dages (postmaster@subnet), der mich auf einen sehr schlimmen Fehler hinwies.(!!Schäm!!) bAStARd , dem Schreiber der Dokumentation und Anleitung , soll hier nochmal gesondert Gedankt werden , der keine Kosten und Mühen gescheut hat mir das Leben mit Verbesserungen und Bug-Reports schwer zu machen! Aber ich denke es hat sich gelohnt. (13) Weitere Tools des Programmierers: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Weitere Tools fuer AmBoS-Mailboxsysteme von diesem Programmierer: - VOrt - PowerTopTen (momentan in der Beta-Testphase) - (14) Kontaktadressen: ~~~~~~~~~~~~~~~~~~~~~~ Programmierer des Tools "Box-Register": Grisu (Sysop der Mailbox: "Another Door In Paradise") EMail: GRISU@adonai.dontpanic.sub.org Idee und Betatester: Nitro (Sysop der "TrueLies BBS") EMail: NITRO@truelies.dontpanic.sub.org Dokumentation, Betatester und Programmierer des MailServers: bAStARd (ehem. Sysop der "hEllGAtE BBS") EMail: bAStARd@d-area.ohz.north.de Support-Mailbox des Tools "Box-Register": Mailbox "Another Door In Paradise" Rufnummer: 04221-64654 EMail: GRISU@adonai.dontpanic.sub.org END OF FILE