                         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
knnen so Bretter bestellt oder abbestellt werden, die eigenen Pointdaten
verndert werden oder Files angefordert werden, alles Sachen, die sich ohne
MAPS nur in Absprache mit dem Sysop oder nur durch einen zustzlichen
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 unmglich werden. Drngen 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, abhngig 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 : lschen 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 lschen. Dies knnen 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 zugnglichen Files
   HELP	     sendet den Hilfstext


 Im Unterschied zu REQUEST knnen hierrber nur Binrnachrichten angefordert
 werden, die in der "FileRequest-Liste" stehen, d.h. der Befehl kann nur auf
 bestimmte, vom Sysop markierte Bretter zugreifen, unabhngig von Ihren son-
 stigen Zugriffsrechten.

 Dieser Befehl ist lediglich aus Kompatibilitt 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 mg-
           lich gendert.


 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 Kompatibilitt 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" ausgelst
 werden.


 Befehl  : LIST
 Aufgabe : generiert eine Liste aller fr Sie zugnglichen Bretter

 Der Befehl LIST erstellt eine Liste derjenigen Bretter, die in der Mailbox
 fr Sie zugnglich 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 Lnge 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 enthlt 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 gendert.


 Befehl  : REQUEST
 Aufgabe : Bestellen einer Nachricht

 REQUEST bietet die flexibelste Mglichkeit, Nachrichten aus Brettern in der
 Box zu bestellen. Im Nachrichten-Text stehen folgende Angaben ber die
 bestellten Files :

  <brettname> <File1> <File2> usw.

 Es knnen also in einer Zeile mehrere Files aus dem gleichen Brett bestellt
 werden.

  <brettname> ist der Brettname, beginnend mit einem '/'.
  <Filex>     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 vernderten 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=<proto>	; 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 nchsten NetCall an Sie verschickt.

 Die Werte von fehlenden Schlsselworten werden nicht verndert.

 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 verndert. Dies
 	   kann so Problemen im Pollbetrieb fhren (keine bertragung 
 	   mglich) !


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 gendert werden (einmal tglich 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.

