home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR3 / IMUTIL13.ZIP / IMUTIL.DOC < prev    next >
Text File  |  1993-04-19  |  12KB  |  293 lines
  1.         ──────────────────────────────────────────────────────────────────
  2.         IMUTIL 1.01             Ein IMAIL tool                   19.04.93
  3.         ──────────────────────────────────────────────────────────────────
  4.  
  5.                          (C)1993 by PraeCon DATA
  6.                            All rights reserved.
  7.                 written by Ulrich Schlechte, 2:241/3431
  8.  
  9.  
  10.         IMUtil ist eine Sammlung von verschiedenen Tools für IMAIL.
  11.         Es vereinigt einige Funktionen, für die man sonst grosse
  12.         Tools installieren muss; bei deren Konfiguration man schnell
  13.         graue Haare bekommt.
  14.         IMUtil ist KEIN Ersatz für IMAIL/ITRack oder ähnliche Programme !
  15.  
  16.         Bis einshl. Version 1.10 ist IMUtil PUBLIC-DOMAIN ! Danach wird
  17.         es nach dem Sharewareprinzip vertreiben werden.
  18.  
  19.         Die Benutzung vom IMUtil erfolgt auf eigene Gefahr. Es wird
  20.         keinerlei Haftung für evtl. auftrendene Schäden übernommen.
  21.         Das Tool ist nach besten Wissen programmiert, aber niemand
  22.         ist gegen Fehler immun !
  23.  
  24.         ──────────────────────────────────────────────────────────────────
  25.                               Leistungsumfang
  26.         ──────────────────────────────────────────────────────────────────
  27.  
  28.         IMUtil verfügt zur Zeit über folgende Funktionen :
  29.  
  30.           AREAS     Automatisches Update der Area-beschreibungen
  31.                     anhand der Rules.
  32.  
  33.           REMAP     Ein einfaches Point-Remapping, um Netmails die nicht
  34.                     direkt an den Pint eines User gehen umzuadressieren.
  35.  
  36.           INFO      Posten der automatisch eingereichteten Areas in
  37.                     ein Echo.
  38.  
  39.  
  40.         ──────────────────────────────────────────────────────────────────
  41.                        Die Konfigurations-Datei (IMUTIL.CFG)
  42.         ──────────────────────────────────────────────────────────────────
  43.  
  44.  
  45.         Bei der Konfigurationsdatei handelt es sich um eine normale
  46.         ASCII-Datei. Die Zeileweise bearbeitet wird.
  47.         Kommentarzeilen beginnen mit einem ";".
  48.         Jeder Eitrag besteht aus einem Schlüsselwort, gefolgt von einem
  49.         "=" und der Einstellung.
  50.  
  51.         Der Abschnitt [IMUtil-Main] :
  52.  
  53.         Hier werde die Hauptkonfiguration-Optionen von IMUTIL gesetzt :
  54.  
  55.         Logfile       Dieser Eintrag legt fest wie das
  56.                       Logfile von IMUTIL heissen soll.
  57.                       Pfadangabe optional.
  58.                       Bsp.:
  59.                       Loggfile=F:\FD\IMAIL\IMUTIL.LOG
  60.  
  61.         IMail         Hier wird der Pfad angegeben, in dem
  62.                       IMUTIL die Dateien IMAIL.CF und IMAIL.AR suchen soll.
  63.                       Fehlt dieser Eintrag versucht IMUTIL eine Umgebungs-
  64.                       Variable "IMAIL" zu benutzen.Fehlt auch diese wird
  65.                       im aktuellen Verzeichnis gesucht.
  66.                       Bsp.:
  67.                       IMail=F:\FD\IMAIL
  68.  
  69.         Netmail       In diesem Unterverzeichnis sucht IMUTIL die
  70.                       MSG-Dateien für das Point-Remapping.
  71.                       Fehlt dieser Eintrag versucht IMUTIL eine Umgebungs-
  72.                       Variable "FD" zu benutzen.Fehlt auch diese wird
  73.                       im aktuellen Verzeichnis gesucht.
  74.                       Bsp.:
  75.                       Netmail=F:\FD\MSG
  76.  
  77.         Rules         Gibt den DOS-Pfad zu den *.RUL-Files an.
  78.                       Default: Aktuelles Verzeichnis
  79.                       Bsp.:
  80.                       Rules=Z:\FILESYS\FIDOECHO\RULES24
  81.  
  82.        ReaplaceAutoComment
  83.                       Dieser Eintrag gibt an, ob IMUTIL beim updaten
  84.                       der Area-beschreibungen die Beschreibung,
  85.                       einer automatisch angelegten Area, die nicht aus
  86.                       einem Rule-File generiert werden kann ersetzen
  87.                       soll.
  88.                       Fehlt der Eintrag wird die Beschreibung nicht verändert.
  89.                       Mögliche Einstellungen :
  90.                        <none>  Beschreibung wird komplett gelöscht.
  91.                        text    Beschreibung wird durch "text" ersetzt.
  92.                       Bsp.:
  93.                       ReplaceAutoComment=<none>
  94.                       ReplaceAutoCOmment=keine Beschreibung vorhanden
  95.  
  96.  
  97.        RemapDataFile  Wo befindet sich und wie heisst das File, in
  98.                       dem die Point-remapping stehen.
  99.                       (Aufbau der Datei s. Abschnitt REMAP)
  100.                       Bsp.:
  101.                       RemapdataFile=F:\FD\IMAIL\REMAP.CFG
  102.  
  103.        EraseSent      Sollen beim remappen Netmails, bei denen das SENT-
  104.                       Flag gesetzt ist gelöscht werden ?
  105.                       Mögliche Einstellungen: YES / NO
  106.                       Bsp.:
  107.                       EraseSent=NO
  108.  
  109.        MSGBackupDir   Ist dieser Eintrag vorhanden, werden die
  110.                       Orginal-Netmails in dieses Verzeichnis gemoved,
  111.                       bevor sie durch die remappten Netmails ersetzt werden.
  112.                       WICHTIG !
  113.                       Dieses Verzeichnis MUSS auf dem selben Laufwerk sein
  114.                       wie das unter "Netmail" angegebene !
  115.                       Bsp.:
  116.                       MSGBackUpDir=F:\FD\BACKMSG
  117.  
  118.        AreaLogBoard   In welche Area sollen die "New-Area-Announcements"
  119.                       gepostet werden. Hier ist NUR die Angabe einer
  120.                       Area möglich !
  121.                       WICHTIG !
  122.                       Bei dem hier angegebenen Board MUSS im IMSetup
  123.                       bei "Security" "N" (NEIN) angegeben werden, da die
  124.                       Mails sonst aussortiert werden !
  125.                       Bsp.:
  126.                       AreaLogBoard=ANNOUNCE.3431
  127.  
  128.        Inbound        Der Name ist zwar etwas verwirrend, aber er bezeichnet das
  129.                       Verzeichnis, in dem IMUTil das AUSGEHENDE Paket mit
  130.                       dem Announcement ablegen soll. Die ist normalerweise
  131.                       das INBOUND-Verzeichnis von IMAIL.
  132.                       Bsp.:
  133.                       Inbound=F:\FD\FILES
  134.  
  135.         ──────────────────────────────────────────────────────────────────
  136.                                 Aufruf-Parameter
  137.         ──────────────────────────────────────────────────────────────────
  138.  
  139.  
  140.         Der Aufruf von IMUtil ist denkbar einfach :
  141.  
  142.               IMUTIL <command>
  143.  
  144.        wobei <command> einer der folgenden Befehle ist :
  145.  
  146.              AREAS
  147.              REMAP
  148.              INFO
  149.  
  150.  
  151.         ──────────────────────────────────────────────────────────────────
  152.                                Der Befehl AREAS
  153.         ──────────────────────────────────────────────────────────────────
  154.  
  155.         Es ist für einen Sysop eine undankbare Aufgabe bei neuen Areas
  156.         die Beschreibungen immer up to date zu halten.
  157.  
  158.         Dies erledigt der AREAS-Befehl voll automatisch.
  159.  
  160.         Der AREAS-Befehl veranlasst IMUTIL dazu, im [Rules]-Verzeichnis
  161.         nach Dateien mit der Endung ".RUL" zu suchen. Findet IMUTIL dann
  162.         in der Areas des Systems die entsprechende Area, wird die Beschreibung
  163.         den Rules entnommen.
  164.  
  165.         Zusätzlich biete der AREAS-Befehl die Mögklichkeit bei Areas die
  166.         in der Beschreibung das wenig schöne "Area received on ..." haben
  167.         und für die keine Rule vorliegt, die Beschreibung zu löschen bzw.
  168.         zu ersetzen.
  169.         Geben Sie zB. als [ReplaceAutoComment] "Keine Beschreibung" an,
  170.         bekommen diese Areas alle als Beschreibung den obigen Text.
  171.  
  172.         Damit IMUTIL die Rules eindeutig zuordnen kann, akzeptiert
  173.         es NUR RUles im "neuen" Format.
  174.         D.H., es werden von jeder Rule die ersten beiden Zeilen
  175.         gelesen, wobei in der ersten Zeile "Area:<areaname>" stehen muss
  176.         und in der zweiten "Topic:<beschreibung>". Leerzeichen vor und nach
  177.         dem Doppelpunkt werden ignoriert.
  178.  
  179.         ──────────────────────────────────────────────────────────────────
  180.                                Der Befehl REMAP
  181.         ──────────────────────────────────────────────────────────────────
  182.  
  183.         Wenn ein User sich einen Point einrichten läßt, dann möchte er
  184.         natürlich seine gesamte Netmail an sienen Point weitergeleitet haben.
  185.  
  186.         Dies kann man normalerweise nur realisieren, indem man einen
  187.         Tracker installiert der Point-Remapping beherrscht (zb. ITRack).
  188.         Da aber die Installation solcher Programme, nur um remapping zu
  189.         können, etwas zu aufwendig ist (und meist viel zu kompliziert),
  190.         beherrscht IMUTIL dieses Remapping.
  191.  
  192.         Was passiert da genau ?
  193.  
  194.         Angenommen Sie haben einen User Namens "Ulrich Schlechte", der den
  195.         Point Nr. 2:241/3431.100 betreibt.
  196.  
  197.         Nun kommt eine Netmail an, die an "Ulrich Schlechte , 2:241/3431"
  198.         adressiert ist.
  199.         Jetzt tritt IMUTIL in Action. Es schaut nach ob der User
  200.         "Ulrich Schlechte" bekannt ist, adressiert die Netmail
  201.         dann um auf 2:241/3431.100 und legt natürlich vorher
  202.         eine Kopie des Orginals an, wenn das gewünscht ist.
  203.  
  204.         Optional löscht IMUTIL gleichzeitig alle Netmails, bei denen
  205.         das SENT-Flag gesetzt ist, um das Netmail-Verzeichnis etwas
  206.         aufzuräumen.
  207.  
  208.  
  209.         ──────────────────────────────────────────────────────────────────
  210.                  Der Aufbau der REMAP-Steuerdatei [RemapDataFile]
  211.         ──────────────────────────────────────────────────────────────────
  212.  
  213.         Die Datei ist Zeilenweise aufgebaut. Jeweils zwei Zeilen
  214.         ergeben einen Remap-Eintrag. Die Zeilen müssen durch ein CRLF
  215.         abgeschlossen sein.
  216.  
  217.         In der Ersten Zeile steht jeweils der Username und in
  218.         der Zweiten Zeile die Pointnummer, auf die die Mails umgeleitet werden
  219.         sollen.
  220.  
  221.         -------START OF REMAP.CFG------------
  222.         <Username>
  223.         <PointNummer>
  224.         <Username>
  225.         <PointNummer>
  226.         -------END Of REMAP.CFG---------------
  227.  
  228.         Bsp:
  229.  
  230.         -------START OF REMAP.CFG------------
  231.         Ulrich Schlechte
  232.         100
  233.         Sysop
  234.         100
  235.         Peter Tester
  236.         1
  237.         Klaus Meier
  238.         56
  239.         -------END Of REMAP.CFG---------------
  240.  
  241.  
  242.         ──────────────────────────────────────────────────────────────────
  243.                                 Der Befehl INFO
  244.         ──────────────────────────────────────────────────────────────────
  245.  
  246.         Mit dem Befehl INFO können Sie IMUTIL dazu veranlassen
  247.         ein Announcement aller neu eingerichteten Areas in eine
  248.         bestimmte Area zu posten.
  249.  
  250.         Hierzu wird das "New-Areas-Logfile" von IMAIL ausgewertet.
  251.         Jede bereits bearbeitete Zeile wird am Anfang mit einem
  252.         "*" versehen, damit nicht dauernd die gleichen Areas als
  253.         "NEU" angepriesen werden.
  254.  
  255.         Als Origin wird der Default-Origin aus IMAIL benutzt.
  256.  
  257.         WICHTIG :
  258.  
  259.         Bei der Area, in die das Announcement geschickt werden soll,
  260.         muß unbedingt der Eintrag "Security" im IMSetup auf NO gestellt
  261.         werden, da die Announcements sonst wegen "Securirty Violation"
  262.         aussortiert werden.
  263.  
  264.  
  265.         ──────────────────────────────────────────────────────────────────
  266.                        Fehler/Bugs/Features/Ideen
  267.         ──────────────────────────────────────────────────────────────────
  268.  
  269.         Sollten Sie ein undokumentiertes Feature (gehässige Leute sagen
  270.         dazu Bug) in IMUTIL finden, melden Sie sich einfach bei mir.
  271.  
  272.         Sollte das Programm abstürzen, so erzeugt es eine Datei
  273.         FATAL.LOG, die Sie mir dann am besten zusammen mit dem Logfile zu
  274.         senden, damit ich mich auf fehler suche begeben kann.
  275.  
  276.         Anregungen und neue Ideen sind immer gerne gesehen.
  277.  
  278.         Sie können mich wie folgt erreichen :
  279.  
  280.          Netmail  :  Ulrich Schlechte , 2:241:3431
  281.          SnailMail:  Bergstraße 45 , 3392 Clausthal-Zellerfeld
  282.          oder in dringenden Fällen per Voice unter
  283.                      05323-83179 Q
  284.  
  285.  
  286.  
  287.         ──────────────────────────────────────────────────────────────────
  288.                                 Hinweise
  289.         ──────────────────────────────────────────────────────────────────
  290.  
  291.         IMail , I'Track  sind (c) by IMAIL inc.
  292.  
  293.