home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / ecu_200 / llegada.doc < prev    next >
Text File  |  1993-02-07  |  29KB  |  641 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.              **       ***                                **
  11.              **       ***                                **
  12.              **        **                                **
  13.              **        **     ****    *****   ****    *****   ****
  14.              **        **    ******  ******   *****  ******   *****
  15.              **        **    **  **  **  **      **  **  **      **
  16.              **        **    **  **  **  **   *****  **  **   *****
  17.              **        **    ******  **  **  ******  **  **  ******
  18.              **        **    **      **  **  **  **  **  **  **  **
  19.              **        **    **      ******  **  **  **  **  **  **
  20.              ******   ****   ******   *****  ******  ******  ******
  21.              ******   ****    *****      **   *****   *****   *****
  22.                                      ******
  23.                                      *****
  24.  
  25.  
  26.  
  27.                                   Version 2.00
  28.                    (basierend auf Llegada 1.04 von Heinz Ozwirk)
  29.                    
  30.                                        by
  31.  
  32.                                 Patrick Seemann
  33.  
  34.                               2:301/701.29@fidonet
  35.   
  36.                                 7. Februar 1993
  37.  
  38.  
  39.  
  40.         Grundsätzliches
  41.  
  42.         Llegada ist Freeware. Jeder darf es für den privaten Gebrauch be-
  43.         nutzen und kostenlos weitergeben. Die Verbreitung durch Mailboxen
  44.         ist zulässige, wenn dafür keine zusätzliche Gebühr verlangt wird.
  45.         Der Vertrieb durch  PD-Versender bedarf meiner  schriftlichen Zu-
  46.         stimmung.
  47.  
  48.         Jeder Anwender ist  für den Schaden,  der ihm durch  Llegada ent-
  49.         steht, oder den er mit Llegada anrichtet, selbst  verantwortlich.
  50.         Fehlermeldungen und/oder  Verbesserungsvorschläge nehme  ich aber
  51.         gerne entgegen. Ich verspreche aber  nicht, daβ ich sie auch  be-
  52.         rücksichtigen werde.
  53.  
  54.  
  55.  
  56.         Allgemeines
  57.  
  58.         Llegada ist als  Ersatz von Import  für ST-Points gedacht.  Dabei
  59.         arbeitet Llegada bevorzugt mit LED und Ecu zusammen. Einen  ande-
  60.         ren Editor kann man vermutlich verwenden, wenn er das gleiche Da-
  61.         teiformat wie LED verwendet,  und der Exporter spielt  vermutlich
  62.         auch keine Rolle. Die Verwandschaft zu Ecu zeigt sich  allerdings
  63.         darin, daβ Llegada die Konfigurationsdatei ECU.CFG und nicht etwa
  64.         LLEGADA.CFG verwendet.  Auβerdem ist  Llegada meines  Wissens der
  65.         einzige Importer, der zwischen lokalen und offiziellen Area-Namen
  66.         unterscheiden kann.
  67.  
  68.  
  69.  
  70.         Voraussetzungen
  71.  
  72.         Llegada benötigt zum Betrieb einen Atari-ST (1MB bevorzugt), eine
  73.         Harddisk (es soll immer noch  Leute geben, die mit einem  Floppy-
  74.         Laufwerk versuchen einen  Point zum Laufen  zu bringen), LED  als
  75.         Message-Editor (notfalls geht es  auch mit Pandora), LHARC  (oder
  76.         ein beliebiges anderes Kompressionsprogramm) und BinkleyTerm  als
  77.         Mailer.
  78.  
  79.  
  80.  
  81.         Installation
  82.  
  83.         Bei  der  Installation  setzen  wir einmal einen funktionierenden
  84.         Point voraus. Dann ist die gröβte Hürde bei der Installation  von
  85.         Llegada bereits überwunden. Alles,  was dann noch zu  tun bleibt,
  86.         ist:
  87.  
  88.         -  Kopieren Sie LLEGADA.PRG auf die Festplatte zu den ganzen  an-
  89.            deren Point-Programmen.
  90.  
  91.         -  Erstellen Sie die Datei ECU.CFG. Sie muβ sich im gleichen Ver-
  92.            zeichnis wie LLEGADA.PRG befinden.
  93.  
  94.  
  95.  
  96.         Vorteile von Llegada
  97.  
  98.         -  Llegada ist  zuverlässig. Im  Gegensatz zu  Import bricht  es
  99.            nicht mitten in einem Mail-Paket ab oder erzeugt sinnlose  Ne-
  100.            tmail-Einträge, nur weil es einen fehlerhaften Header gefunden
  101.            hat.
  102.  
  103.         -  Llegada ist ein reiner  Point-Importer. Da Llegada nicht  ver-
  104.            sucht Mails, die (scheinbar)  nicht für diesen Point  bestimmt
  105.            sind, weiterzuleiten, produziert es auch keine Dupes.
  106.  
  107.  
  108.  
  109.         Nachteile von Llegada
  110.  
  111.         -  Llegada ist nur für Points geeignet.
  112.  
  113.  
  114.         Die Konfigurationsdatei
  115.  
  116.         In der  Konfigurationsdatei werden  die Hosts  und die  Areas be-
  117.         schrieben. Aus dieser Datei erfährt Llegada welche Mails für wel-
  118.         che Area bestimmt sind, und in welche Dateien die Mails geschrie-
  119.         ben werden sollen. Die Beschreibung dieser Datei befand sich bis-
  120.         her an dieser Stelle. Da die gleiche Datei aber auch von  anderen
  121.         Programmen verwendet  wird, und  ich keine  Lust habe  den Aufbau
  122.         dieser Datei immer wieder zu beschreiben, (vor allem bei Änderun-
  123.         gen wird das lästig, wenn  man in vielen Dateien immer  die glei-
  124.         chen Änderungen vornehmen muβ) habe ich beschlossen, für die Kon-
  125.         figurationsdatei eine  eigene Beschreibung  zu machen.  Diese Be-
  126.         schreibung befindet sich in der Datei CFG.TFM. Sie gehört zur Do-
  127.         kumentation aller Programme,  die diese Konfigurationsdatei  ver-
  128.         wenden.
  129.  
  130.  
  131.         Parameter in der Kommandozeile
  132.  
  133.         Einige Parameter können auch in der Kommandozeile angegeben  wer-
  134.         den. Diese Parameter haben in der Regel höhere Priorität als  die
  135.         entsprechenden Anweisungen in der Konfigurationsdatei.
  136.  
  137.         Statt mit / können Optionen auch mit - eingeleitet werden.
  138.  
  139.         flags können die  Werte yes (1),  no (0) und  toggle annehmen. Es
  140.         ist nur das jeweils erste Zeichen relevant.
  141.  
  142.  
  143.  
  144.         name
  145.            Ein Filename  ohne weitere  Zusätze bezeichnet  die zu lesende
  146.            Konfigurationsdatei. Wenn  keine Datei  beim Aufruf  angegeben
  147.            wird, liest Llegada die Datei ECU.CFG.
  148.  
  149.         /?
  150.            Das Programm gibt einen Kurzen Hilfstext aus. Danach wird  das
  151.            Programm  sofort  abgebrochen.  Die  übrigen Parameter und die
  152.            Konfigurationsdatei werden  nicht mehr  verarbeitet. Statt  -?
  153.            kann auch nur ? verwendet werden.
  154.  
  155.         /Dflag
  156.            Mit dieser Option kann der Dupe-Checker ein- und ausgeschaltet
  157.            werden. mit /Dyes wird er eingeschaltet, mit /Dno wird er aus-
  158.            geschaltet. /Dtoggle kehrt  den aktuellen Zustand  um. Default
  159.            ist /Dyes. Der Dupe-Checker  ist in dieser Version  noch nicht
  160.            implementiert.
  161.  
  162.         /Lfilename
  163.            Der Name des Log-Files wird festgelegt. Alle Meldungen  werden
  164.            in die Datei 'filename' geschrieben. Default ist BT.LOG.
  165.  
  166.         /Mloglevel
  167.            Damit wird die  Ausführlichkeit der Fehlermeldungen  bestimmt.
  168.            Zur Zeit sind nur die Werte  0 - keine Ausgabe ins Log-File  -
  169.            und 1 - alles ins Log-File sinnvoll.
  170.  
  171.         /Wflag
  172.            Mit dieser  Option as  Verhalten von  Llegada bei  Fehlern be-
  173.            stimmt. Mit /Wyes hält Llegada bei einem Fehler an und  wartet
  174.            auf eine Eingabe des Benutzers. Mit /Wno werden Fehler nur  in
  175.            das Log-File eingetragen,  und das Programm  - wenn möglich  -
  176.            fortgesetzt. /Wtoggle  kehrt die  Wirkung von  NoPause um. De-
  177.            fault ist /Wyes.
  178.  
  179.  
  180.         AREAS.BBS
  181.  
  182.         Die Datei AREAS.BBS wird benötigt, um die Reihenfolge der  Areas,
  183.         in der  sie in  LASTREAD.CED stehen,  zu bestimmen.  Llegada kann
  184.         auch die übrigen Angaben dieser Datei auswerten. Das genaue  For-
  185.         mat dieser  Datei scheint  nirgendwo dokumentiert  zu sein. Daher
  186.         soll hier eine kurze Beschreibung folgen, welches Format  Llegada
  187.         von dieser Datei erwartet.
  188.  
  189.         -  Leereilen und Zeilen, die mit einem Semikolon beginnen  werden
  190.            ignoriert. Vor dem Semikolon darf jedoch kein anderes Zeichen,
  191.            auch kein Leerzeichen, stehen.
  192.  
  193.         -  Die erste Zeile, die nicht  leer ist, und die nicht  mit einem
  194.            Semikolon (;) oder Divis (-) beginnt, ist der Systemname. Die-
  195.            sen Namen verwendet Ecu immer  dann als Origin, wenn für  eine
  196.            Area weder in ECU.CFG  noch in AREAS.BBS ein  Origin definiert
  197.            wurde. Llegada ignoriert den Systemnamen.
  198.  
  199.         -  Zeilen, die mit einem  Divis beginnen werden ignoriert.  Diese
  200.            Zeilen enthalten in der  Regel den Bossnode, Origins  oder die
  201.            Anzahl der Tage,  die eine Nachricht  im System bleiben  soll.
  202.            Dies ist für Llegada aber ohne Bedeutung.
  203.  
  204.         -  In allen anderen Zeilen erwartet Llegada mindestens drei durch
  205.            Leerzeichen und/oder Tabs  getrennte Bestandteile -  den Namen
  206.            der Areadatei, den  offiziellen Namen und  den Host für  diese
  207.            Area.
  208.  
  209.  
  210.         Funktionen von Llegada
  211.  
  212.         Nach  dem  Lesen  der  Konfigurationsdateien entpackt Llegada zu-
  213.         nächst sämtlich ArcMail Pakete im Inbound-Directory. Alle Dateien
  214.         mit einer der Endungen MO?, TU?, WE?, TH?, FR?, SA? und SU?  wer-
  215.         den ausgepackt. Llegada untersucht die Dateien, um festzustellen,
  216.         welches Komprimierungsprogramm verwendet wurde. Wenn ein  bekann-
  217.         tes Programm verwendet wurde, ruft Llegada das entsprechende Pro-
  218.         gramm auf. Archive, die mit LHARC, ZOO, PKZIP, PKARC und ARJ kom-
  219.         primiert wurden,  werden erkannt.  LHARC und  ARC werden  als LHA
  220.         bzw. PKARC erkannt. Da LHA und PKARC aber LHARC und ARC auspacken
  221.         können, sollte das kein Problem darstellen.
  222.  
  223.         Die zum Entpacken notwendigen Befehle werden in ECU.CFG nach  den
  224.         Schlüsselworten  ArcUnpack,  ArjUnpack,  LhaUnpack, ZipUnpack und
  225.         ZooUnpack  angegeben  werden.  An  den  Stellen,  wo der Name des
  226.         Inbound-Directorys oder  des Mailpakets  in den  Befehl eingebaut
  227.         werden muβ, kann eine der folgenden Steuersequenzen stehen.
  228.  
  229.         %d Der Name des Inbound-Directories wird eingefügt. Der Name  en-
  230.            det mit einem Backslash (\).
  231.  
  232.         %n Der Name des Mailpakets einschlieslich Inbound-Directory  wird
  233.            eingefügt.
  234.  
  235.         %p Der Name des Mailpakets ohne Directory wird eingefügt.
  236.  
  237.         Wenn die Kommandozeile mit einem Prozentzeichen beginnt, wechselt
  238.         Llegada  vor  der  Ausführung  des  Kommandos  in  das   Inbound-
  239.         Directory. Das muβ  natürlich bei den  Parametern und beim  Namen
  240.         der Programmdatei berücksichtigt werden.
  241.  
  242.         Wenn für ein Verfahren kein Befehl angegeben wird, verwendet Lle-
  243.         gada die folgenden Default-Werte:
  244.  
  245.            ARC    arc.ttp x %n %d*.*
  246.            ARJ    %..\unarj.ttp %p
  247.            LHARC  lharc.ttp x -m %n %d
  248.            PKZIP  zip.ttp x %d %n
  249.            ZOO    %..\zoo.ttp x %p
  250.  
  251.         Danach werden die  Mails in allen  Paketen in die  einzelnen Mes-
  252.         sage-Areas verteilt. Die Pakete  werden in der Reihenfolge  bear-
  253.         beitet, in der sie beim Absender erzeugt wurden. Dadurch  sollten
  254.         Mails eigentlich immer in der Reihenfolge in den Areas stehen, in
  255.         denen sie geschrieben wurden.
  256.  
  257.         Alle Mails kommen in irgendeine Message-Area. Dabei kümmert  sich
  258.         Llegada nicht darum,  ob im Header  eines Pakets oder  einer Mail
  259.         die Adresse des Points steht oder nicht.
  260.  
  261.         Normalerweise kommen  Mails in  die in  der Area-Zeile angegebene
  262.         Area. Wenn eine Mail keine Area-Zeile enthält, nimmt Llegada  an,
  263.         daβ es sich um eine Netmail handelt, und schickt sie  dementspre-
  264.         chend in die Netmail-Area. Wenn die Mail eine Area-Zeile mit  un-
  265.         bekannter Area  enthält, kommt  die Mail  in die Bad-Message-Area
  266.         (BadMsgArea) oder - wenn keine Bad-Message-Area angegeben wurde -
  267.         in die Netmail-Area.  Ab Version 1.02  kann auch ein  Verzeichnis
  268.         angegeben werden,  in dem  die entsprechende  Area angelegt  wird
  269.         (NewAreaDirectory). Dabei wird auch ein Eintrag in AREAS.BBS vor-
  270.         genommen.  Wenn  kein  `NewAreaDirectory'  angegeben wird, werden
  271.         auch keine neuen Areas angelegt.
  272.  
  273.         Wenn eine  Mail keinen  Absender-, Empfänger-,  Subject- oder Da-
  274.         tums-Eintrag findet,  trägt das  Programm **UNKNOWN**  ein - eine
  275.         Konzession an die älteren Versionen von LED, die meinten das Ende
  276.         der Area erreicht zu haben,  wenn als Absender ein leerer  String
  277.         im Header-File stand. Llegada hat auch keine Probleme mit  Mails,
  278.         die ein zu kurzes Datum enthalten.
  279.  
  280.         Wenn Llegada  eine fehlerhafte  Message findet,  versucht es, das
  281.         Paket zu restaurieren. Dazu sucht Llegada vom Beginn der  letzten
  282.         verarbeiteten Mail  an nach  Daten, die  wie eine  Mail aussehen.
  283.         Manchmal werden dadurch Daten,  die eine Mail sein  könnten, tat-
  284.         sächlich aber nur Müll sind importiert. Es gehen aber auf  keinen
  285.         Fall Mails verloren. Schlimmstenfalls kann es passieren, daβ zwei
  286.         Mails als eine einzige Mail importiert werden.
  287.  
  288.  
  289.  
  290.         Mail-Überwachung
  291.  
  292.  
  293.  
  294.              Vorsicht! Die  Verwendung dieser  Funktion erfolgt  auf
  295.              eigenes Risiko. Die Funktion ist noch nicht vollständig
  296.              getestet. Programmfehler oder Fehler in der  Regeldatei
  297.              können leicht zum Verlust von Mails oder gar Files füh-
  298.              ren. Ich stelle diese Funktion interessierten Anwendern
  299.              zum Testen zur Verfügung. Aber ich übernehme keine  Ge-
  300.              währ für richtiges Funktionieren.
  301.  
  302.         Ab Version 1.03 kann  Llegada die ankommenden Mails  analysieren,
  303.         und je nach Message-Inhalt verschiedene Aktionen auslösen. Welche
  304.         Mails welche Reaktion auslösen, wird in einer separaten Datei be-
  305.         schrieben. Lediglich  der Name  dieser Datei  erscheint nach  dem
  306.         Schlüsselwort Rules in ECU.CFG.
  307.  
  308.         Die Regeldatei  besteht aus  Leerzeilen, Kommentaren  und Regeln.
  309.         Leerzeilen enthalten dur die folgenden Trennzeichen: Leerzeichen,
  310.         Tabs  und  Doppelpunkte.  Kommentarzeilen  können beliebigen Text
  311.         enthalten, vorausgesetzt das erste Zeichen, das kein Trennzeichen
  312.         ist, ist  ein Semikolon.  Leerzeilen und  Kommentare werden igno-
  313.         riert.
  314.  
  315.         Regeln bestehen aus Bedingungen und Aktionen. Jede Bedingung  und
  316.         jede Aktion wird  in eine Zeile  geschrieben. Zuerst werden  alle
  317.         Bedingungen aufgestellt, danach die Aktionen. Die Aktionen werden
  318.         ausgeführt, wenn alle Bedingungen der Regel erfüllt sind. Die De-
  319.         finition einer  Regel ist  beendet, wenn  das Dateiende  erreicht
  320.         wird, oder wenn nach einer Aktion wieder eine Bedingung folgt.
  321.  
  322.  
  323.  
  324.         Bedingungen
  325.  
  326.         AREA areaname
  327.            Die Bedingung ist erfüllt, wenn die Mail in die Area  areaname
  328.            gehört. areaname  muβ der  Name einer  Fido-Area oder  Netmail
  329.            sein. Groβ- und Kleinschreibung werden nicht unterschieden.
  330.  
  331.         BITS bitlist
  332.            Die Bedingung  ist erfüllt,  wenn alle  in bitlist angegebenen
  333.            Bits gesetzt bzw. gelöscht sind. Die Bits werden mit den Namen
  334.            Private,  Crash,  Received,  Sent,  WithFile, Forward, Orphan,
  335.            KillIfSent, Local, Hold  und Deleted gekennzeichnet.  Wenn nur
  336.            der Name des Bits angegeben wird, muβ das Bit in der Mail  ge-
  337.            löscht sein. Wenn unmittelbar vor dem Namen ein Ausrufezeichen
  338.            angegeben wird (!), dann muβ das Bit in der Mail gesetzt sein.
  339.  
  340.         FROM expression
  341.            Diese Bedingung  ist erfüllt,  wenn der  Inhalt des From-Felds
  342.            dem angegebenen expression entspricht.
  343.  
  344.         FROM #adr
  345.            Die  Bedingung  ist  erfüllt,  wenn  die Mail als Absender die
  346.            Adresse adr enthält. adr wird in der Form
  347.  
  348.                   [Zone:][Netz/][Node][.Point]
  349.  
  350.            angegeben. Wenn keine Zone  angegeben wird, wird die  Default-
  351.            Zone angenommen.  Wenn Netz,  Node oder  Point nicht angegeben
  352.            werden,  dann  stimmt  adr  in  dieser  Komponenten  mit allen
  353.            Adressen überein.6
  354.  
  355.         MESSAGE expression
  356.            Diese Bedingung ist erfüllt,  wenn der Inhalt des  Message dem
  357.            angegebenen expression entspricht.
  358.  
  359.         SUBJECT expression
  360.            Diese Bedingung ist erfüllt, wenn der Inhalt des Stichwortzei-
  361.            le dem angegebenen expression entspricht.
  362.  
  363.         TO expression
  364.            Diese Bedingung ist erfüllt, wenn der Inhalt des To-Felds  dem
  365.            angegebenen expression entspricht.
  366.  
  367.         TO #adr
  368.            Die Bedingung ist erfüllt, wenn die Mails für die Adresse  adr
  369.            bestimmt ist. adr wird in der Form
  370.  
  371.                   [Zone:][Netz/][Node][.Point]
  372.  
  373.            angegeben. Wenn keine Zone  angegeben wird, wird die  Default-
  374.            Zone angenommen.  Wenn Netz,  Node oder  Point nicht angegeben
  375.            werden,  dann  stimmt  adr  in  dieser  Komponenten  mit allen
  376.            Adressen überein.
  377.  
  378.         'expression' gibt an,  welche Teilstrings das  entsprechende Feld
  379.         enthalten muβ, bzw. nicht  enthalten darf. Dabei besteht  ein Ex-
  380.         pression aus einem oder mehreren Termen, die durch das Zeichen  |
  381.         (ODER) voneinander getrennt  werden. Der Expression  ist erfüllt,
  382.         wenn mindestens einer der Terme erfüllt ist.
  383.  
  384.         Jeder Term besteht aus einem oder mehreren Faktoren. Die Faktoren
  385.         werden mit dem Zeichen & (UND) voneinander getrennt. Der Term ist
  386.         erfüllt, wenn alle Faktoren erfüllt sind.
  387.  
  388.         Ein Faktor kann ein Pattern, ein Expression in Klammern - ( und )
  389.         - oder  ein Faktor  mit einem  vorangestellten Ausrufezeichen (!)
  390.         sein. Der Faktor  ist erfüllt, wenn  das Pattern im  untersuchten
  391.         Feld auftritt, wenn der geklammerte Expression erfüllt, oder  der
  392.         Faktor nach dem Ausrufezeichen nicht erfüllt ist
  393.  
  394.         Ein Pattern ist  eine Folge von  Zeichen, die von  doppelten oder
  395.         einfachen Anführungszeichen begrenzt werden. Anfang und Ende müs-
  396.         sen vom gleichen Zeichen begrenzt werden. Doppelte Anführungszei-
  397.         chen sollten verwendet werden, wenn Groβ- und Kleinschreibung un-
  398.         terschieden werden sollen, einfache Anführungszeichen, wenn  kein
  399.         Unterschied gemacht werden soll.
  400.  
  401.         In einem Pattern haben  die folgenden Zeichen eine  besondere Be-
  402.         deutung:
  403.  
  404.            <      Der gesuchte Text  muβ am Anfang  des Feldes stehen.  <
  405.                   hat nur am Anfang des Suchtextes diese Bedeutung.
  406.            >      Der gesuchte Text muβ am Ende des Feldes stehen. >  hat
  407.                   nur am Ende des Suchtextes diese Bedeutung.
  408.            ?      An dieser  Stelle kann  im Feld  ein beliebiges Zeichen
  409.                   stehen.
  410.            *      An dieser Stelle kann  im Feld eine beliebige  Zeichen-
  411.                   folge stehen. Die Zeichenfolge kann auch leer sein.
  412.  
  413.         Für alle, die es etwas theoretische mögen, noch einmal die Syntax
  414.         eines Expression in Kurzform:
  415.  
  416.            expression:
  417.                   term,
  418.                   expression | term.
  419.  
  420.            term:  factor,
  421.                   term & factor.
  422.  
  423.            factor:
  424.                   ! factor,
  425.                   ( expression ),
  426.                   String-Konstante.
  427.  
  428.  
  429.  
  430.         Aktionen
  431.  
  432.         #AREA areaname
  433.            Eine Kopie dieser Mail wird in die Area areaname geschrieben.
  434.  
  435.         #BITS bitlist
  436.            Die in bitlist angegebenen Bits werden gesetzt bzw.  gelöscht.
  437.            Die Bits werden  mit den gleichen  Namen wie im  BITS-Kommando
  438.            (s. oben) definiert.  Wenn nur der  Name angegeben wird,  dann
  439.            wird das Bit gesetzt. Wenn unmittelbar vor dem Namen ein  Aus-
  440.            rufezeichen angegeben  wird, dann  wird das  entsprechende Bit
  441.            gelöscht.
  442.  
  443.         #DELETE
  444.            Die Mail wird gelöscht. Dies ist z.B. dann notwendig, wenn die
  445.            Mail in eine  andere Area kopiert  werden soll, aber  nicht in
  446.            die Original-Area geschrieben werden soll.
  447.  
  448.         #FROM name
  449.            In das From-Feld der Mail wird der Text name eingetragen.
  450.  
  451.         #LIST file format
  452.            An die Datei file wird ein Eintrag (normalerweise eine  Zeile)
  453.            im Format format  angehängt. In den  Eintrag können Teile  der
  454.            Mail eingefügt werden (s. Templates).
  455.  
  456.         #REPLY template
  457.            Llegada erzeugt automatisch eine  Antwort auf diese Mail.  Die
  458.            Antwort wird  per Netmail  verschickt. Auf  diese Weise lassen
  459.            sich einfach Empfangsbestätigungen erzeugen. template ist  der
  460.            Name einer Datei, die als Netmail an den Absender der Mail ge-
  461.            schickt werden soll. In diese Datei können Teile der Mail ein-
  462.            gefügt werden (s. Templates).
  463.  
  464.         #TO name
  465.            In das To-Feld der Mail wird der Text name eingetragen.
  466.  
  467.         #WRITE path
  468.            Die Mail wird als  ASCII-Text in eine Datei  geschrieben. path
  469.            bestimmt das Verzeichnis und den Dateinamen. Im Namen  sollten
  470.            einige Fragezeichen stehen. An diesen Stellen kann Llegada be-
  471.            liebige  Zeichen  eintragen,  falls  mehrere Mails geschrieben
  472.            werden müssen. So erzeugt die Aktion
  473.  
  474.                   #WRITE TEXTE\MSG?????.TXT
  475.  
  476.            im Verzeichnis TEXTE\ nacheinander die Dateien
  477.  
  478.                   MSG00000.TXT
  479.                   MSG00001.TXT
  480.                   MSG00002.TXT
  481.                   ...
  482.                   MSG00009.TXT
  483.                   MSG0000A.TXT
  484.                   ...
  485.  
  486.            Die so erzeugten Dateien können beispielsweise mit einem  Pro-
  487.            gramm ausgewertet werden.
  488.  
  489.         Die Reihenfolge, in der  die Aktionen angegeben werden,  ist ohne
  490.         Bedeutung. Llegada  führt zuerst  alle Ersetzungen  durch. Danach
  491.         werden Kopien und ASCII-Dateien geschrieben. Erst ganz zum Schluβ
  492.         wird die Mail gelöscht.
  493.  
  494.  
  495.  
  496.         Templates
  497.  
  498.         Ein Template ist  ein Text, in  den Teile einer  empfangenen Mail
  499.         eingefügt werden können. Templates  können ganze Dateien (wie  im
  500.         Falle von #REPLY)  oder Parameter einer  Aktion (#LIST) sein.  In
  501.         einem Template werden die folgenden Zeichen erkannt und durch die
  502.         entsprechenden Teile der Mail ersetzt:
  503.  
  504.         %A der Name der Area, in  der die Mail geposted wurde  - Netmails
  505.            enthalten keinen Areanamen,
  506.         %D das Datum und die Uhrzeit, an dem die Mail geschrieben wurde,
  507.         %F der Name des Absenders,
  508.         %I der Inhalt der INTL-Zeile,
  509.         %M die Message-Id,
  510.         %O die Origin-Zeile,
  511.         %P die Programm-Id,
  512.         %R die Reply-Id,
  513.         %S der Inhalt der Stichwortzeile,
  514.         %T der Name des Empfängers,
  515.         %d das Datum und die Uhrzeit, an dem die Mail empfangen wurde,
  516.         %f die  Node-  bzw.  Pointnummer  des  Absenders aus dem Message-
  517.            Header (bei Echomails ist das immer die Adresse des Nodes, von
  518.            dem man das entsprechende Echo bezieht.)
  519.         %l die Länge der Mail in Bytes,
  520.         %o die Adresse des Absenders aus der Origin-Zeile,
  521.         %s die Node- oder Pointnummer der Absenders. In Netmails ist dies
  522.            die Adresse  im Message-Header,  in Echomails  die Adresse  am
  523.            Ende der Origin-Zeile,
  524.         %t die Adresse des Empfängers aus dem Message-Header.
  525.  
  526.         Diese Steuerzeichen können in ein Template eingebaut werden. Zwi-
  527.         chen dem Prozentzeichen und dem Buchstaben kann eine Zahl angege-
  528.         ben werden, die angibt,  wie viele Zeichen eingefpgt  werden sol-
  529.         len. Wenn  der einzufügende  Text kürzer  ist als  der Betrag der
  530.         Zahl angibt, wird mit Leerzeichen aufgefüllt. Bei positiven  Zah-
  531.         len wird der Text von links aufgefüllt, bei negativen von rechts.
  532.  
  533.         Mit der Regel
  534.            Message:    "<@PID: ECU"8
  535.            #LIST       "ECUUSER" "%-32F %24s %P"
  536.         wird  für jede Mail eines Ecu-Users eine Zeile an die Datei ECUU-
  537.         SER angehängt. Diese Zeile enthält den Namen das Users  linksbün-
  538.         dig in  einem 32  Zeichen breiten  Feld, seine  Adresse (je  nach
  539.         Message-Typ  aus  dem  Header  oder  der  Origin-Zeile)  und  die
  540.         Programm-Id, aus der  im Wesentlichen die  Versionsnummer hervor-
  541.         geht.
  542.  
  543.  
  544.         Anhang A - Return-Codes
  545.  
  546.         Dieser Abschnitt ist für  diejenigen interessant, die Llegada  in
  547.         einer Batchdatei verwenden. Llegada liefert beim Programmende ei-
  548.         nen Fehlercode, der Aufschluβ  über das Vorliegen und  evtl. über
  549.         die Art  eines Fehlers  gibt. Die  folgenden Return-Codes  können
  550.         derzeit auftreten:
  551.  
  552.         0  kein Fehler
  553.            Llegada hat keine Fehler erkannt und ist bis zum Ende durchge-
  554.            laufen.
  555.  
  556.         1  Fehler beim Laden des Resource-Files
  557.            Dieser Fehler  sollte eigentlich  nicht auftreten,  da das Re-
  558.            source-File ein Teil des Programms ist.
  559.  
  560.         2  Llegada wurde mit /? aufgerufen
  561.            Es liegt zwar kein Fehler vor, aber trotzdem hat Llegada seine
  562.            Arbeit nicht getan, nämlich die Areas nach zu sendenden  Mails
  563.            zu durchsuchen.
  564.  
  565.         3  Abbruch durch Benutzer
  566.            Nach ein Fehler, nach dem Llegada noch hätter weiter  arbeiten
  567.            können, hat der Anwender das Programm mit `Abbruch' verlassen,
  568.  
  569.         4  Konfigurationsdatei nicht gefunden
  570.            Llegada hat die angegebene Konfigurationsdatei (oder  ECU.CFG)
  571.            nicht gefunden.
  572.  
  573.         5  Zu wenig Speicher
  574.            Llegada hat nicht  genug Speicher um  alle Area- und  Host-Be-
  575.            schreibungen oder eine Mail  zu laden. Dieser Fehler  ist eher
  576.            unwahrscheinlich und  deutet auf  ein internes  Problem in der
  577.            Speicherverwaltung hin. Wenn es nach einem Reset funktioniert,
  578.            war es wohl tatsächlich ein Fehler in der  Speicherverwaltung.
  579.            Wenn auch Reset nichts hilft, dann liegt es wohl doch an einer
  580.            sehr langen Mail.
  581.  
  582.         6  Fehler in Konfigurationsdatei
  583.            Das kann  fast alles  bedeuten. Vielleicht  wurden 3d-Adressen
  584.            gewählt, aber keine Fakenet-Adresse angegeben. Die  Fehlermel-
  585.            dung im Logfile sollte mehr aussagen.
  586.  
  587.         7  Systemfehler
  588.            Ein  Fehler  bei  einer  Systemfunktion ist aufgetreten. Viel-
  589.            leicht hat Llegada eine Datei nicht gefunden, oder die  Platte
  590.            ist voll, oder  was auch immer.  Auch hier sollte  das Logfile
  591.            näheres sagen.
  592.  
  593.  
  594.         Anhang B - Änderungen
  595.  
  596.         1.00 ---> 1.01
  597.  
  598.         -  Llegada wechselt beim entpacken der Archive nicht mehr in  das
  599.            Inbound-Verzeichnis, wenn beim Aufrufmuster Datei- und  Paket-
  600.            namen angegeben werden (s. ArcUnpack).
  601.         -  Pakete, die  gröβer als  der verfügbare  Speicher sind, können
  602.            jetzt importiert werden.
  603.         -  Llegada läβt  die AREA-Zeile  auf Wunsch  in den  importierten
  604.            Echo-Mails (s. KeepArea).
  605.         -  Beim Entpacken kann angegeben werden bis zu welchem  Fehlerle-
  606.            vel die ArcMail Pakete trotzdem gelöscht werden (s.  DeleteAr-
  607.            chive).
  608.  
  609.  
  610.  
  611.         1.01 ---> 1.02
  612.  
  613.         -  Llegada setzt in LED.NEW das Bit, an dem LED 1.1 erkennt,  daβ
  614.            in der entsprechenden Area neue Mails stehen. (noch nicht  ge-
  615.            testet)
  616.         -  Meldungen an SYSOP werden nicht mehr als Meldungen an den  Sy-
  617.            sop gezählt. Es werden nur  noch die Mails gezählt, die  wirk-
  618.            lich an den angegebenen Sysop gerichtet sind.
  619.         -  Llegada ermittelt automatisch das verwendeten  Komprimierungs-
  620.            verfahren.  Die  entsprechenden  Kommandozeilen  müssen in der
  621.            Konfigurationsdatei angegeben werden.
  622.         -  Fehlende Areas können automatisch angelegt werden.
  623.  
  624.  
  625.  
  626.         1.02 ---> 1.03
  627.  
  628.         -  Lha und LhArc werden unterschieden (s. LhaUnpack und  LharcUn-
  629.            pack). Die  erste Datei  entscheidet welches  Programm gewählt
  630.            wird. Wenn  diese Datei  vom Typ  -lh0- oder  -lh1- ist,  wird
  631.            LhArc verwendet, sonst Lha. Wenn es dabei Probleme geben soll-
  632.            te, dann sollte für  beide Versionen Lha als  Packer angegeben
  633.            werden.
  634.         -  Ein Default-Packer für unbekannte Archiv-Formate kann  angege-
  635.            ben werden (s. DefaultUnpack)
  636.         -  Eine  Mail-Überwachungsfunktion  kann  aktiviert werden, womit
  637.            Mails  automatisch  in  andere  Areas umgeleitet oder gelöscht
  638.            werden können. (s. Rules und das Kapitel über Mail-Überwachung
  639.            in dieser Beschreibung)
  640.  
  641.