**** Maustausch mit UMS **** Im Folgenden eine Beschreibung der Programme UMS2M und M2UMS. Es sind Zusatz- programme von UMS, die es ermöglichen mit UMS Maustausch zu machen. Wem weder UMS noch Maustausch etwas sagt, sollte sich erst damit beschäftigen. Diese Dokumentation setzt dieses Grundwissen als gegeben voraus. Achtung! Die Programmme "UMS2M" und "M2UMS" sind in ihrer Funktion aufeinander abgestimmt. Sie sollten als Paar betrachtet werden, d.h nur die miteinander herausgegebenen Versionen dieser beiden Programme sollten verwendet werden und keine neue Version des einen mit einer alten Version des anderen Programmes. ------------------------------------------------------------------------------ Versionen Versionen Aktuelle Versionsnummern: M2UMS V1.66 (Sep 7 1993) UMS2M V2.1 (Oct 27 1993) Die wesentlichen Eigenschaften der beiden Programme sind hier beschrieben. In Einzelfällen kann diese Anleitung hinter der Wirklichkeit hinterherhinken. Daher bitte auch die letzen Ein- träge in m2ums- und ums2m.history beachten! ------------------------------------------------------------------------------ M2UMS M2UMS Beschreibung: Das Programm importiert (Single User) Maustauschfiles in ein UMS-System. Syntax: M2UMS Boxkurzel/A,Username/A,Outfile/A: Boxkürzel ist die Abkürzung der Maus mit der sie Maustauschen. Im Normalfall ist es das Autokennzeichen ihres Wohnortes, im Falle mehrerer Mäuse mit einer angehängten Zahl versehen. (M2, MS, AC2, K, WAF ...) Username ist der Name oder noch besser dessen Alias (siehe ums.config. doc) des Users, der das Programm aufruft und dessen Outfile eingelesen wird. Outfile ist der Name des zu importierenden Outfiles. Dies ist das File, welches die Maus im Verlauf des Maustausches an sie sendet. Ist das File nicht im gleichen Directory wie M2UMS, muß der Pfad mit angegeben werden. Bildschirmausgabe: 1.) Name des Programms, Versionsnummer und Copyright, 2.) "Status:" und je ein Punkt pro geändertem Status, 3.) "Mitteilungen:" und je ein Punkt pro eingetragener Mitteilung. Jede 10`te Mitteilung wird zur Übersicht die Anzahl bislang eingetragener Mitteilungen numerisch angezeigt. Fehler: Anstatt eines Punktes erscheint im Falle eines Fehlers oder einer wichtigen Meldung ein Buchstabe. D - Dupe, d.h. Mitteilung schon vorhanden. O - Orphan, d.h persönliche Mitteilung an einen unbekannten User. L - Lost, d.h Mitteilung aus verschiedenen Gründen nicht in ein UMS- System eintragbar. Geschieht nur bei verstümmelten Outfiles. ? - unknown / unsolveable error, d.h. völliger Verlust einer Mail. Ähnlich wie "L" aber noch gravierender T - Es wird nur eine bestimmte Menge Speicher für den Text reserviert. Bei Mitteilungen mit Überlänge muß Speicher neu reserviert werden. Angezeigt wird dies mit einem "T". K - Wie "T" aber für den Kommentarspeicher. Bei den Fehlermeldungen "O" oder "L" wird alles was von der eingelesen Mitteilung noch verwertbar ist, an den SYSOP weitergeleitet. 4.) Die Anzahl der eingelesen Mitteilungen pro Sekunde wird angezeigt. 5.) "Logfile" Das Logfile wird ergänzt. Besonderes: Das Logfile ergibt sich aus den oben erwähnten Globalen UMS-Variablen. Es ist selbsterklärend. Unbekannte Adressen bekommen in M2UMS ein ".unmaus" angehängt. Solchen Adressen wird dieses Kürzel in UMS2M wieder abgeschnitten, um eine Maus- tauschtaugliche Reply-Adresse zu erhalten. Jeder Gruppe der Maus wird ein "maus.." vorangestellt, um die Gruppennamen gegenüber den Gruppennamen anderer Mäuse oder Netze ein- deutig zu machen. ------------------------------------------------------------------------------ UMS2M UMS2M Beschreibung: Das Programm erstellt ein sog. Infile.txt, das Übertragungs und Steuerungsfile für Maustausch. Die Mitteilungen werden aus einem UMS-System ausgelesen und in das Maus- tauschformat gewandelt. Nebenher bietet UMS2M noch einige Sonderfunktionen. Syntax: UMS2M BoxKurzel/A,Username/A,FAST/S: Boxbezeichner wie bei M2UMS. Username ist der Name oder ein Alias des Users, wessen Nachrichten exportiert werden sollen. Die Option FAST/S bewirkt, daß weder ein Infofiles angefordert, noch Userstatus exportiert werden. Ist sinnvoll bei einem schnellen Tausch, da die Onlinezeit u.U. deutlich reduziert wird. Bildschirmausgabe: 1.) Name des Programms, Versionsnummer und Copyright, 2.1) Allgemeine Infofiles, wenn solche per ums.Config angefordert sind. 2.2) Private Infofiles, wenn solche per ums.Config angefordert sind. 3.) Export: und je ein Punkt für jede exportierte Mitteilung, 4.) "Statusschreiben" Die Status ihrer Mitteilungen werden an die Maus automatisch rückgemeldet. 5.) "log schreiben: x(y)/z in i Sec." x= Anzahl exportierter Mitteilungen, y= Anzahl von Fehlern beim Ex- portieren, z= Anzahl exportierter Status und i= Laufzeit in Sekunden. Das gleicht Format findet sich auch im Eintrag im ums.log. Besonderes: Wird erkannt, das ein Kommentar nicht aus der gleichen Gruppe stammt, oder eine öffentliche Mitteilung persönlich beantwortet wird, steht in der ersten Textzeile ein Verweis auf die RefID und gegebenenfalls die Gruppe. Bsp.: Kommentar zu "" in der Gruppe "" Maustausch bietet die Möglichkeit an, Gruppen an- und abzubestellen oder auch Mitglieder einer Gruppe ein- oder auszutragen. Wird eine Nachricht an den UMS-User maus. (z.B. maus.ms, wie im ums.config eingetragen) mit dem Subject "///mauscontrol" gesendet, werden alle Textzeilen dieser Mitteilung bis zur ersten Leerzeile als Maustausch-Steuerkommando exportiert. Beispiel: Nachricht an user "maus.ms" mit dem Betreff "///mauscontrol" und dem Nachrichtentext "G+hardware" bewirkt, daß die Gruppe "Hardware" von nun an mit Maustausch importiert wird. Erlaubte ///mauscontrol- Kommandos beginnen mit "G+", G-" oder "GU". Anhand einer globalen Variable kann festgelegt werden, wo und unter welchem Namen das Infile erstellt werden soll. Ist nichts angegeben, wird es wie immer im aktuellen Dirctory erstellt. Die globale Variable ist "INFILE--". Wird Boxbezeichner oder Userbeim Aufruf von UMS2M klein geschrieben, ist es auch hier klein- zuschreiben! Beispiel: "INFILE-heini-ms = ram:Heini_infile-ms.txt". Zwei weitere globale Variablen legen fest, welche Infofiles von der Maus angefordert werden. Mit "maus..info" und "maus..Privatinfo"können sie Info- files, anfordern. Ein Verzeichnis aller in einer Maus verfügbaren Infofiles bietet das Infofile "ITI". Die dreibuchstabigen Kürzel müßen dabei durch ein Komma getrennt sein. Leer- zeichen oder Tabulatoren die der Übersichtlichkeit halber eingefügt sind, werden, überlesen. Wichtig ist, daß die Kürzel in jedem Fall aus drei Buch- staben bestehen und durch ein Komma getrennt sind. Weder vor dem ersten noch nach dem letzten Kürzel darf noch ein Komma stehen! Einige Infofiles will man nicht immer bekommen. Dazu gibt UMS2M die Möglich- keit diese Infofiles in Intervallen anzufordern. Wird das Kürzel von einem Trennstrich "-" und einer Zahl gefolgt, so gibt diese Zahl an, wieviel Tage verstreichen müssen, damit dieses Infofile erneut angefordert wird. Beispiel: Für die Maus Münster (MS) "maus.ms.info = ITI, IGK-4, INL-7" Das Infofile ITI wird immer, IGK nach vier Tagen und INL wöchentlich aktualisiert. Diese beiden Variblen gehören im ums.config in den Eintrag des *Users*, der auch beim Aufruf von UMS2M angegeben wird. -"maus..info": Infofiles die für alle angefordert werden. Sinnvollerweise im Eintrag des Users, der die Maus am meisten frequentiert. -"maus..Privatinfo": Infofiles die nur der an- fordernde User lesen soll, z.B. Gruppen und Sysopinfofiles. -Siehe Beispielseintrag im "ums.config"! Der Eintrag für readacess sollte natürlich so gewählt sein, das der User alle seine gewünschten Gruppen und die Gruppe "maus.. infofiles" und seine private Gruppe "maus..infofiles. " lesen kann, d.h nicht die privaten Infogruppen der anderen User! Von der Maus werden nur die bei ihnen zu ändernden Infos gesendet. Diese sind im Outfile enthalten und werden von M2UMS automatisch in den Gruppen: "maus..infofiles" und "maus..infofiles. " abgelegt. Im Gegensatz zu früheren Versionen von UMS2M ist es nicht mehr nötig, das Infile nach dem Einlesen des dazugehörigen Outfiles zu löschen. Infiles werden nicht mehr gespoolt, sondern bei jedem Aufruf von UMS2M neu erstellt. Unbekannte Adressen bekommen in M2UMS ein ".unmaus" angehängt. Solchen Adressen wird dieses Kürzel in UMS2M wieder abgeschnitten, um eine Maus- tauschtaugliche Reply-Adresse zu erhalten. Nachrichten mit einer Länge von mehr als 16000 Bytes werden gesplittet. ------------------------------------------------------------------------------ ums.config ums.config Maustauschspezifisches: Für die generelle Einrichtung des ums.config bitte die entsprechende Dokumentation hinzuziehen. Beschreiben werde ich im Folgenden nur die Maustausch (und damit UMS2M und M2UMS) betreffenden Einträge. Globale: Mit diesen Globalen könne sie bestimmen, wo UMS2M und M2UMS Files anlegen. .log und .errlog müßen mit einem ':' oder einem '/' enden! - "maus.log" das M2UMS Logfile (wird bei UMS2M nicht unterstützt!) - "maus.errlog" das Logfile zur Debuggingausgabe - "maus.errloglevel" Der Debugginglevel ( 0-10) - "maus.sysopinfo". Wenn 'Y' werden die Fehlermeldungen eines Tauschvorgangs an des Sysop als Daemonmail gesendet. Die Logfiles finden sie in dem Pfad, den sie bei den UMS- Variablen ange- ben mit folgenden Namen: Logfile: M2UMS: FromMaus..log Debuglog: UMS2M: ToMaus..debug M2UMS: FromMaus..debug Weitere UMS- Variablen siehe bei UMS2M. Beispielseintrag: (! Das ist durch den Boxbezeichner ihrer Maus zu ersetzen!) ----------------------------------------------------------------- ; fields in ".header", all other go to ".text" HEADERFIELDS = 1,2,3,4,5,6,7,8,9,10,11,13,14,15,16,17 ; indexed fields INDEXFIELDS = 1,3,5,8,9,10,11,16,17 user name = Heini Dummuser password = xxxxx [...] maus.ms.info = "ITI, IIH, IIK-4, IIL, IIM, INK, INP, ISB" maus.ms.privatinfo = "IGS, IGT-5, IGK, ISG" enduser user name = maus.ms readaccess = maus.ms.#? writeaccess = #? priority = +20 import = #? export = "(#?@Fidonet|#?.maus|#?.zer|#?.de|~(#?.sub.org)|#?.bitnet|#?.com|#?.uucp|#?.unmaus)" netaccess = #?.maus distribution = "(%|#?,)(ms|maus.ms|l|m|mausnet|world)(,#?|%)" maus.log = ums:mbox/ maus.errlog = rad: maus.errloglevel = 10 maus.INFILE-chr-ms = rad:infile_ms.tt maus.sysopinfo = Y enduser ----------------------------------------------------------------- ------------------------------------------------------------------------------ Maustausch Maustausch Beschreibung: Folgendermaßen geschieht Maustausch in einer UMS- Umgebung: Zu Beginn installieren sie UMS. Anschließend erstellen sie mit UMS2M ein Datenaustausch und Steuerungs- file für Maustausch. Dieses File senden sie als Maustauschfile an ihre Maus. Sie bekommen ein anderes File zurück. Normalerweise heißt es "Outfile.txt". Um File senden und empfangen zu können, benötigen sie ein Terminalprogramm. Mit M2UMS lesen sie dieses "Outfile.txt" in UMS ein. Mit einem Leseprogramm (z.B. rums oder MM) lesen sie die empfangenen Mitteilungen, beantworten sie oder erstellen eigene. ------------------------------------------------------------------------------ Infofiles Infofiles Im Folgenden eine Aufzählung der gebräuchlichsten Infofiles. Wenn sie eine aktuelle Liste der Infofiles in ihrer Maus wollen, tragen sie das Kürzel "ITI" in der UMS.Config Variable zum Bestellen von Infofiles ein. (s.o.) Für Sysops einer Maus sind noch weitere Infofiles erhältlich, siehe ITI! IIE :Einführung in die MAUS IIB :Bedienungsanleitung IIA :Menü-Kurzanleitung IIG :Gruppen-Anleitung IIH :Hardware der MAUS III :Technische Informationen IIM :MAUS-Beitrag IIL :LogIn-Zeiten IIT :MausTausch-Anleitung IIK :Kommerzielles INA :MausNet-Anleitung INK :Kurze Boxen-Liste INL :Lange Boxen-Liste ING :Netzgruppen-Liste INP :Netzplan IGT :Box-Vorspann IGE :Box-Abspann IGS :Spruch des Tages IGK :Kurze Gruppenliste IGL :Lange Gruppenliste ITG :Maschinenlesbare Gruppenliste ITI :Maschinenlesbare Infoliste JMB :Benutzerstatistik JMA :Anrufstatistik JMT :Tabellarische Auslastungsstatistik JMG :Graphische Auslastungstatistik JMR :Rechnerstatistik JMH :HiScore-Liste JMM :Mitteilungsstatistik JML :Tagesauslastung JMF :Logfile-Statistik JMP :Gruppenstatistik ----------------------------------------------------------------------------- History: Siehe File: "Maustausch_history.txt" Autor: Christian Rütgers@MS Copyright: Gemäß den Copyrightvereinbarungen der ums.library. Fehlerbeschreibungen: An die unter "Autor" genannte Mailadresse im Mausnetz oder an "chr@quack.ms.open.de".