Anleitung fr MAPS V 1.0 ************************ (C) 1995; Oliver Graf - T.O.M. Software 1. Was macht MAPS ----------------- Die Aufgabe von MAPS ist es, einem Pointuser einen einfachen Mechanismus zur Bedienung der Box an die Hand zu geben. šber verschiedene Kommandos k”nnen so Bretter bestellt oder abbestellt werden, die eigenen Pointdaten ver„ndert werden oder Files angefordert werden, alles Sachen, die sich ohne MAPS nur in Absprache mit dem Sysop oder nur durch einen zus„tzlichen Userlogin erledigen lassen. MAPS lehnt sich dabei an den ZC-MAPS Standard, der auf dem Z-Netz Treffen Hamburg '94 entwickelt wurde, an. Dieser Standard ist auf ein maschinen- lesbares Format ausgelegt worden, daher kann die manuelle Auswertung einiger Antwort-Mails schwierig bis unm”glich werden. Dr„ngen Sie Ihren Pointprogrammierer, automatische Auswertungsroutinen fr diesen Stan- dard zu implementieren, es macht auch Ihnen die Arbeit einfacher. 2. Die Bedienung von MAPS ------------------------- 2.1 Anschreiben von MAPS ------------------------ Jede Nachricht, die fr ein Kommando erzeugt wird, muá an den User "maps@box.do.main" gesandt werden. Dabei steht "box.do.main" fr die in Ihrer Serverbox Netzadresse. Im Betreff der jeweiligen Nachricht steht das Kommando und nur das Kommando. Im Nachrichtentext stehen weitere Parameter, zeilenweise getrennt. Dies kann entfallen, abh„ngig vom jeweiligen Befehl. 2.2 Befehle von MAPS -------------------- Folgende Befehle sind zur Zeit in MAPS implementiert : Befehl : ADD Aufgabe : Bestellen eines oder mehrer Bretter Fr ADD werden die zu bestellenden Bretter zeilenweise in den Nachrichten- text geschrieben. Dabei muá der Brettname mit einem '/' beginnen. Wildcards sind erlaubt, fr komplette Brettgruppen kann man beispiels- weise "/Z-NETZ/RECHNER/AMIGA/*" schreiben. ADD liefert als Ergebnis eine normierte Liste der bestellten Bretter zurck (siehe LIST). Befehl : DEL Aufgabe : Abbestellen eines oder mehrer Bretter DEL erwartet im Nachrichtentext die Liste der Bretter, die Sie abbestellen wollen. Dabei muá ein Brettname mit einem '/' beginnen. Wildcards sind erlaubt, fr komplette Brettgruppen kann man beispiels- weise "/Z-NETZ/RECHNER/AMIGA/*" schreiben. DEL liefert ein als Ergebnis eine normierte Liste der abbestellten Bretter zurck (siehe LIST). Befehl : DELPM Aufgabe : l”schen der PMs im User-Postfach Bei Pointusern, die Ihren Vertreter auf "Kopie" stehen haben, sammeln sich mit der Zeit eine Menge PMs im Online-Postfach an. Um dem Sysop eine Freude zu machen, sollten Sie hin und wieder die PMs l”schen. Dies k”nnen Sie mit diesem Befehl machen, ohne sich extra als User in die Box einzuloggen. Befehl : FILES Aufgabe : Anforderung eines oder mehrer Files aus der Box Žhnlich REQUEST kann man mit FILES Nachrichten aus der Box anfordern, ohne sie online aus der Box saugen zu mssen. Dabei stehen im Nachrichtentext die Filenamen der gewnschten Files, zeilenweise untereinander. Anstatt eines Filenamen kann auch eines der folgenden Schlsselworte benutzt werden : ALLFILES sendet eine Liste aller ber FILES zug„nglichen Files HELP sendet den Hilfstext Im Unterschied zu REQUEST k”nnen hierrber nur Bin„rnachrichten angefordert werden, die in der "FileRequest-Liste" stehen, d.h. der Befehl kann nur auf bestimmte, vom Sysop markierte Bretter zugreifen, unabh„ngig von Ihren son- stigen Zugriffsrechten. Dieser Befehl ist lediglich aus Kompatibilit„t zum ZC-MAPS Standard imple- mentiert, es wird empfohlen, den Befehl REQUEST zu benutzen. Befehl : INDEX Aufgabe : auflisten des Inhalts eines Bretts INDEX generiert eine standarisierte Liste des Inhalts eines Bretts. Dabei wird fr jede Nachricht ein ZConnect Header erzeugt, der die wichtigsten Daten wiedergibt. Hinweis : Da ANUBIS momentan technisch noch nicht in der Lage ist, alle ZConnect(tm) Header zu verwalten, kann nicht der komplette Header wiedergegeben werden. Dies wird aber so bald wie m”g- lich ge„ndert. Befehl : INHALT Aufgabe : auflisten des Inhalts eines Bretts Der Befehl INHALT liefert den Inhalt eines Bretts zurck. Der Aufbau der Liste entspricht dem des alten ANUBIS-MAPS und ist nicht standarisiert. Der Befehl existiert nur aus Kompatibilit„t zum alten MAPS, fr eine standarisierte Liste benutzen Sie bitte den Befehl 'INDEX'. Befehl : HELP Aufgabe : Zurcksenden des Hilfstextes HELP macht nichts anderes, als diesen Text an den User zurckzusenden. Dies wird auch dann gemacht, wenn ein fr MAPS unbekanntes Kommando geschickt wurde. Dieser Befehl kann auch ber das Schlsselwort "HILFE" ausgel”st werden. Befehl : LIST Aufgabe : generiert eine Liste aller fr Sie zug„nglichen Bretter Der Befehl LIST erstellt eine Liste derjenigen Bretter, die in der Mailbox fr Sie zug„nglich sind. Dabei besitzt die Liste einen festgelegten Aufbau, der durch alle Pointprogramme, die nach ZC-MAPS Standard arbeiten, automatisch ausgewertet werden kann. Der Listenaufbau ist folgendermassen definiert (Auszug aus ZC-MAPS Be- schreibung) : Pos. 1: Steuerzeichen Pos. 2: ASCII 32 Pos. 3ff: Brettname bis zum CR/LF oder White Space. White Space dient als Trenner fr die optionale Brettbeschreibung. Die L„nge einer Zeile ist nicht begrenzt!. Steuerzeichen: '+' Brett ist derzeit bestellt. '-' Brett ist nicht bestellbar. ' ' Brett ist nicht bestellt, bestellbar. '!' Brett ist bestellt, kann aber nicht abbestellt werden (Zwangsanschluá). ';' Zeile enth„lt einen Kommentar. Anmerkung : Unter "White Space" versteht man eine beliebig lange Kom- bination von Leerzeichen (ASCII 32) und Tabulatorzeichen (ASCII 9). Befehl : PASSWORT Aufgabe : Žndern des Point-Passwortes Hin und wieder will man als Point-Betreiber sein Passwort in der Box „n- dern. Hierfr ist dieses Kommando gedacht. Es erwartet im Nachrichten-Text genau zwei Zeilen. In beiden Zeilen muá das neue Passwort stehen, es wird geprft, ob Zeile1 = Zeile2 ist. Nur im Gleichheitsfall wird das Passwort ge„ndert. Befehl : REQUEST Aufgabe : Bestellen einer Nachricht REQUEST bietet die flexibelste M”glichkeit, Nachrichten aus Brettern in der Box zu bestellen. Im Nachrichten-Text stehen folgende Angaben ber die bestellten Files : usw. Es k”nnen also in einer Zeile mehrere Files aus dem gleichen Brett bestellt werden. ist der Brettname, beginnend mit einem '/'. der Name, die Brettnummer oder die MsgID einer Nachricht, die bestellt werden sollen. Die sicherste Methode, die richtige Nachricht zu bekommen, ist die MsgID, gefolgt vom Betreff der Nachricht (Filename) und der Nummer. Alle Angaben werden durch ein Leerzeichen (ASCII 32) voneinander getrennt. Die bestellen Files werden mit der jeweiligen Brettzuordnung bereitge- stellt, ein Protokoll ber die angeforderten Files wird an den Pointuser verschickt. Befehl : SET Aufgabe : Žnderung der Parameter fr den eigenen Point Ihr Point setzt sich aus vielen Parametern zusammen, die fr den Betrieb wichtig sind. Hin und wieder mssen diese Parameter ver„nderten Situationen angepasst werden. Dies geht entweder nur in Rcksprache mit dem Sysop oder halt mit dem Kommando 'SET'. Im Nachrichtentext stehen zeilenweise Schlsselworte gefolgt von dem neuen Wert fr die jeweilige Einstellung. Folgende Schlsselworte sind definiert : protokoll= ; Žndert das šbertragungs-Protokoll Ihres Points auf das angegebene Protokoll. Dieses Protokoll muá in der Liste des Systems existieren. setuserdate=Ja|Nein ; Ja: Beim Anruf des Points wird das User-Datum auch gesetzt. sendstat=Ja|Nein ; Ja: Fr jeden einsortierten Puffer Ihres Points wird eine Sortierstatistik erzeugt und mit dem n„chsten NetCall an Sie verschickt. Die Werte von fehlenden Schlsselworten werden nicht ver„ndert. Beispiel-Nachricht : protokoll=zmodem sendstat=ja Als Antwort erhalten Sie ein Protokoll ber alle Žnderungen. Hinweis : Sollten das Protokoll nicht in den System-Listen existieren, so werden die jeweiligen Einstellungen nicht ver„ndert. Dies kann so Problemen im Pollbetrieb fhren (keine šbertragung m”glich) ! 3. Besondere Hinweise --------------------- a) Es kommt hin und wieder vor, daá ein Sysop aus technischen Grnden ein Brett in der Box anders benennen muá als im Netz. Sie als Point bekommen aber immer den wirklichen Brettnamen. MAPS kann aber beide Brettnamen auswerten. Wenn Sie den Originalnamen benutzen, setzt MAPS den Namen entsprechend um, mit dem Boxnamen geht das sofort ohne Probleme. b) Im Allgemeinen wird MAPS sofort nach dem Logoff Ihres NetCalls ausge- fhrt und bearbeitet Ihre Nachrichten und stellt die Ergebnisse in- nerhalb von ein paar Sekunden zur Verfgung. Dies kann aber durch den Sysop ge„ndert werden (einmal t„glich oder alle paar Stunden). Informieren Sie sich bitte bei Ihrem Sysop, wenn Sie keine Antwort von MAPS bekommen (Sie bekommen in jedem Fall, also auch bei Fehlern, eine Antwort.