@database MM_SuperCC
@master MM_SuperCC.guide
@$VER: MM_SuperCC.guide 1.40 (02.04.96)
@author "Michael A. Bode (root@morphic.art-line.de)"
@(c) "(C) Michael A. Bode 1995-96"
@wordwrap
@node "Main" "MM_SuperCC.guide"
@next "Introduction"
   //    //  //    //                                                     nEPH
  ///  ///  ///  ///
 //  / //  //  / //   S U P E R _ C C   (2. Mai 1996)
//    //  //    //

==============================================================================

MM_SuperCC.rexx, Version 0.35           Copyright (C) 1995-96, Michael A. Bode

==============================================================================

@{" Einführung           " link "Introduction" 0}     Wofür MM_SuperCC ?
@{" Archiv-Inhalt        " link "Distribution" 0}     Dateien im Archiv
@{" Installation         " link "Installation" 0}     Wie man das Skript installiert
@{" Konfiguration        " link "Configuration" 0}     Wie passe ich die Konfiguration an ?
@{" Benutzung            " link "Usage" 0}     Wie setze ich das Skript praktisch ein ?
@{" Support              " link "Support" 0}     Neue Versionen, Fehlermeldungen usw.
@{" Danksagungen         " link "Greetings" 0}     "Danke" an einige Leute...

@{" History              " link "History" 0}     Änderungen in den Versionen

@{" MailManager          " link "MailManager" 0}     Über MailManager

@{" Rechtlicher Kram     " link "Copyright" 0}     Copyright-Hinweis
@endnode
@node "Introduction" "MM_SuperCC.guide/Introduction"
@next "Distribution"
Wofür MM_SuperCC ?
------------------

 MM_SuperCC.rexx ist ein ARexx(R)-Skript für Pino Alibertis's @{"MailManager" link "MailManager" 0}.
 Es dient zum Erstellen von sog. "Carbon-Copies" (=CC), also "Durchschriften"
 einer NetMail an einen oder mehrere andere Leute.

 Merkmale:

    - Mailing-Listen durch Suchmuster erstellen lassen (momentan wird nur das
      Sternchen als Wildcard unterstützt)
    - Mailing-Listen für spätere Wiederverwendung abspeichern
    - Eingabe-Modus: Adressen per Hand ergänzen
    - Hübsche CC:-Header erstellen lassen (optional)
    - Zwei verschiedene Arten von CC:-Headern
    - Leistungsstarke Nodelist-Name nach Domain Konvertierung
    - Unmittelbarer Export aus dem Skript heraus (optional)
    - Leistungsstarke Unterstützung von InterNet-Adressen mit konfigurierbarem
      Gateway; mit FTN-Adressen mischbar in Mailing-Listen
    - Genauso leistungsstarke Unterstützung von Versenden der Mailings in Areas
      (ebenfall mit dem anderen Kram ;) mischbar)
    - Unterstützung aller Flow-Typen (Crash, Hold, Normal)
    - Auf einfache Weise alle Empfänger mit mehreren Nodes löschen lassen
    - Nodelist-Unterstützung
    - Support von lokalen Network-Files und HUB-Segmenten
    - Automatischer Textumbruch des Nachrichtentextes (optional)
    - Anfordern von Empfangsbestätigungen (optional)
@endnode
@prev "Main"
@node "Distribution" "MM_SuperCC.guide/Distribution"
@next "Installation"
Dateien im Archiv
-----------------

   MM
   |
   |\
   | - Config
   |   |
   |   |\
   |   | - MM_SuperCC
   |   |   |
   |   |   |\
   |   |   | - Excelsior_Sysops_Ger.CC   Beispiel Mailing-Liste
   |   |   |
   |   |   |\
   |   |   | - Fido_Nodes_78xx.CC        Beispiel Mailing-Liste
   |   |   |
   |   |   |\
   |   |   | - Pla-net_Nodes.CC          Beispiel Mailing-Liste
   |   |   |
   |   |   |\
   |   |   | - Fido_Points.CC            Beispiel Mailing-Liste
   |   |   |
   |   |    \
   |   |     - Amiga-Echos.CC            Beispiel Mailing-Liste
   |   |
   |    \
   |     - MM_SuperCC.cfg                Beispiel-Konfiguration
   |
   |\
   | - Docs
   |   |
   |   |\
   |   | - MM_SuperCC_GER.guide          Deutsches AmigaGuide-File
   |   |
   |    \
   |     - MM_SuperCC.guide              Englisches AmigaGuide-File
   |
    \
     - Rexx
       |
       |
       |\
       | - MM_SuperCC_GER.rexx           Das Hauptprogramm in deutsch
       |
        \
         - MM_SuperCC.rexx               Das Hauptprogramm in englisch
@endnode
@prev "Introduction"
@node "Installation" "MM_SuperCC.guide/Installation"
@next "Configuration"
Wie man das Skript installiert
------------------------------

 1. 'MM_SuperCC_GER.rexx' nach 'MM:Rexx/' kopieren.
 2. 'MM_SuperCC.cfg' nach 'MM:Config/' kopieren.
 3. 'MM_SuperCC_GER.guide' nach 'MM:Docs/' kopieren.
 4. Ein neues Verzeichnis erstellen (Vorschlag: 'MM:Config/MM_SuperCC/'), in
    welchem die Mailing-Listen gespeichert werden.
 5. Die @{"Konfigurations-Datei" link "Configuration" 0} anpassen.

 HINWEIS: für die englische Version bitte die entsprechenden Dateien ohne das
          "_GER" kopieren !

 Um MM_SuperCC.rexx aus @{"MailManager" link "MailManager" 0} heraus benutzen zu können,
 folgende Zeile in 'MM:Config/MailManager.cfg' einfügen:

 #AREASMENU "Super CC" "rx MM:Rexx/MM_SuperCC_GER.rexx" "S"

 "Super CC" ist der Text in der Menüleiste, "S" ist die Taste, die zusammen
 mit der rechten Amiga-Taste zum starten des Programms gedrückt werden muß.

 Dieser Eintrag kann alternativ durch MM_Prefs vorgenommen werden (User/Areas
 Menü).
@endnode
@prev "Distribution"
@node "Configuration" "MM_SuperCC.guide/Configuration"
@next "Usage"
Wie passe ich die Konfiguration an ?
------------------------------------

 Es gibt 12 zulässige Befehle für die Konfigurations-Datei:

 #NODELISTPATH <Verzeichnis>

    Gibt an, wo sich die Nodeliste(n) befinden.

    Beispiel: #NODELISTPATH Nodelist:

 #MAILINGLISTS <Verzeichnis>

    Dies ist das Verzeichnis, in dem die Mailing-Listen gespeichert sind.
    Dieses Verzeichnis muß zuerst während der @{"Installation" link "Installation" 0} erzeugt werden.

    Beispiel: #MAILINGLISTS MM:Config/MM_SuperCC/

    In Mailing-Listen werden die Adressen/Tags für einen bestimmten Empfänger-
    kreis gespeichert, je Zeile eine Adresse. Das Format einer Zeile ist:

    <4D-Adresse>[@<Domain>] [<Name>]

    für FTN-Adressen.

    Ist <Domain> nicht angegeben, wird die Standard-Domain genommen.
    Ist <Name> nicht angegeben, sucht MM_SuperCC den Namen aus der Nodeliste
    raus. Kann er auch dort nicht gefunden werden, wird 'Unknown' als Name
    eingesetzt.

    Für InterNet-Adressen lautet das Format

    *<FQDA> [<Realname>]

    Das Format bei Areatags lautet:

    #<Areatag> [<Name>]

 #CONVERT <Nodelist> <Domain>

    Dieses Schlüsselwort wird für die Nodelist->Domain-Konvertierung benötigt.
    Der erste Schritt nach dem Start von MM_SuperCC.rexx ist das Auswählen
    einer Nodeliste, die benutzt werden soll. Wenn der Name der ausgewählten
    Nodeliste "<Nodelist>" lautet, wird "<Domain>" als Domain benutzt. Wenn
    der Name der Nodeliste nicht in der Konfiguration auftaucht, wird der Name
    der Nodeliste als Domain-Name verwendet. '#CONVERT' kann in der Konfigura-
    tionsdatei mehr als einmal auftauchen.

    Beispiel: #CONVERT nodelist fidonet

    Dies bedeutet: wird nach dem Programmstart eine Nodeliste mit dem Namen
    'nodelist.*' ausgewählt, wird 'fidonet' als Domain verwendet. Würde diese
    Zeile nicht auftauchen, wird 'nodelist' als Domain verwendet (was voll-
    kommen sinnfrei ist).

 #TEXTDIR <Verzeichnis>

    Hier sollte das Verzeichnis eingestellt werden, in dem normalerweise Text-
    dateien gespeichert werden. Wenn MM_SuperCC nach dem zu versendenden File
    fragt, erscheint ein Filerequester, der standardmäßig auf diesen Pfad ein-
    gestellt ist.

 #EDITOR <Befehl>

    Das ist der KOMPLETTE (!) Befehl zum Aufruf des Texteditors, inklusive des
    Filenamens der temporären Datei.

 #TEMPFILE <Pfad&Filename>

    Dies ist der Name des temprären Files, das beim Aufruf des Texteditors zu
    verschicken ist.

 #GATEADDR <Zone>:<Netz>/<Node>[.<Point>][@<Domain>]

    Adresse des Gateways, das beim versenden von eMails verwendet werden soll.
    Wenn nichts anderes angegeben, wird das Gateway der Morphic Fields Wupper-
    tal (2:2448/7808.999) verwendet.

 #GATENAME <Name>

    Name des Gateways, der als Empfängername bei Nachrichten an das Gateway
    einzusetzen ist. Standardwert ist "AmiGate".

 #ECHOREC <Name>

    Standard-Empfängername bei Echomails.

 #UNKNOWN <Name>

    Standard-Empfängername bei ungelisteten Sites.

 #ZONE <Nummer>

    Default Zone im Wildcard-Modus (zum Network-File-Support).

 #NET <Nummer>

    Default Netz-Nummer im Wildcard-Modus (zum Network-File-Support).
@endnode
@prev "Installation"
@node "Usage" "MM_SuperCC.guide/Usage"
@next "Support"
Wie setze ich das Skript praktisch ein ?
----------------------------------------

 1.  Die zu benutzende Nodeliste auswählen (für den Wildcard-Suchmodus).
     WICHTIG: auch wenn keine Wildcard-Suche gestartet werden soll, muß hier
              zwecks Bestimmung der Domain eine Nodeliste ausgewählt werden.

 2.  Das Programm sollte nun die korrekte Domain anzeigen. Wenn sie stimmt,
     einfach <RETURN> drücken, ansonsten die Domain korrigieren und auf OK
     klicken.

 3.  Gewünschten Modus auswählen.

 3a. Wildcard-Suche:
     Einfach das Suchmuster eingeben. Als Wildcard ist nur ein Stern zulässig.
     Beispiele:

        2:*/0.0
        *:100/*.*
        2:2448/*.0
        *:*/0.0

     Die folgenden Eingaben wären z.B. FALSCH:

        2:24*/*.0
        *:2448/78??.*

     WICHTIG:
     Bei längeren Nodelisten kann es sehr lange dauern, bis das Programm die
     Suche beendet hat (auch auf 040/060ern) ! Empfehlung: erstellen kleinerer
     Teilnodelisten der Regionen, für die Mailinglisten erstellt werden.

 3b. Mailing-Listen:
     Einfach die gewünschte Mailing-Liste auswählen. Die Listen können entweder
     per Hand erstellt oder von MM_SuperCC gespeichert werden (siehe unter
     Schritt 5). Zum Aufbau der List-Files s.o.

 3c. Eingabe-Modus:
     Ein Requester, der nach den Adressen fragt, erscheint. Das Eingabeformat
     ist folgendes:

     <Address>[@<Domain>] [<Name>]
     oder
     *<FQDA> [<Name>]
     oder
     #<Areatag> [<Name>]

     Nach jeder Adresse auf OK klicken. Wenn alle Adressen/Tags eingegeben sind
     "Abbruch" anwählen.

     Gültige Eingaben für FTN-Adressen sind z.B.:

     2:2448/7808
     2:2410/309.0
     2:2448/7022.0@fidonet
     2:2448/7808.999 AmiGate

     Wird [@<Domain>] weggelassen, wird dir Standard-Domain angehängt. Wenn
     [<Name>] weggelassen wird, schaut MM_SuperCC in der Nodeliste nach. Wird
     auch hier nichts gefunden, wird "Unknown" als Name angenommen.

     Beispiele für gültige eMail-Adressen:

     *root@morphic.art-line.de
     *aminet@wuarchive.wustl.edu Urban Müller

     "Urban Müller" wird nur im CC:-Header verwendet. Würde der Name wegge-
     lassen werden, würde die eMail-Adresse im Header erscheinen.

     Beispiele für gültige Areatags:

     #amiga.ger
     #24000.GER All
     #cCc.GeR ---> ALLE <---

     Im Echo AMIGA.GER wird der mittels #ECHOREC definierte Empfängername be-
     nutzt. In der 24000.GER der Empfänger "All", und in der CCC.GER ent-
     sprechend "---> ALLE <---".

 4.  Ein Fenster mit allen gefundenen Adressen/Tags und Namen erscheint. Ein-
     zelne Einträge können durch anwählen des Eintrags und Klick auf OK ge-
     löscht werden. Es erscheint dann noch eine Sicherheitsabfrage. Wenn die
     Liste in Ordnung ist, einfach auf OK klicken ohne einen Eintrag zu se-
     lektieren.

 5.  Wurde der Wildcard-Suchmodus benutzt oder falls bei Schritt 4 Einträge ge-
     löscht wurden, fragt MM_SuperCC ob die geänderte Liste als Mailing-Liste
     gespeichert werden soll. Falls ja, einfach den Namen angeben und OK an-
     wählen.

 6.  Als nächstes muß der zu versendende Text definiert werden. Hierfür kann
     man entweder den Editor aufrufen und den Text tippen oder, falls der Text
     bereits in Form einer Datei vorliegt, einfach die entsprechende Datei aus-
     wählen. Dann wird der Editor natürlich nicht gestartet.

 7.  Betreff eingeben.

 8.  Flow-Typ aussuchen. Normalerweise wählt man hier "Normal".

 9.  Wenn gewünscht, kann MM_SuperCC einen Zeilenumbruch vornehmen. Dabei werd-
     en Zeilen mit mehr als 80 Zeichen auf mehrere Zeilen verteilt.

 10. 'Empfangsbestätigung': Fordert bei allen verschickten NetMail/eMails eine
     Empfangsbestätigung an.

 11. 'Mehrfachempfänger löschen': manchmal kommt es vor, daß ein und dieselbe
     Person mehrfach in der Nodeliste gelistet ist. Diese Person würde das
     Rundschreiben mehrfach erhalten. An dieser stelle können solche Mehrfach-
     empfänger gelöscht werden, so daß sie den Brief nur einmal erhalten.

 12. Optional kann MM_SuperCC.rexx 'CC:-Header' erzeugen. Diese sehen z.B. so
     aus:

        CC: Person A, Person B, Person XYZ, Bill Gates, Person Z, The Devil,
            Fields Of The Nephilim, Person 1, Person 2

     Wurde der Wildcard-Suchmodus verwendet, kann auch ein anderer CC:-Typ
     verwendet werden. Statt der Namen erscheint dann das verwendete Suchmuster
     im Header.

 13. Die für den Versand von NetMails zu benutzende Matrix-Area auswählen.

 14. Letzter Schritt: die verschickten Mails können sofort exportiert werden.
@endnode
@prev "Configuration"
@node "Support" "MM_SuperCC.guide/Support"
@next "Greetings"
Neue Versionen, Fehlermeldungen
-------------------------------

 Für Fehlermeldungen, neue Versionen, Vorschläge etc. bin ich zu erreichen unter

    Fido:  Michael A. Bode 2:2448/7808
    eMail: root@morphic.art-line.de

 Oder über meine Mailbox:

    Morphic Fields BBS [Excelsior! BBS Regional (Eastern European) Support BBS]
    Line 1 : +49-202-2611023 (2400-28800bps V.34/V.FC/V.32bis)
    Line 2 : +49-202-2611024 (2400-28800bps V.FC/V.32bis)
    Line 3 : +49-202-2611025 (9600-64000bps ISDN X.75/V.110, 2kB frames)

 Oder per Sackpost:

    Michael A. Bode
    Hausfeld 43
    42399 Wuppertal
    Germany

 Oder telefonisch:

    +49-202-2611025

 Oder Fax:

    +49-202-2611024

 Die aktuelle Version kann mit dem Magic "SUPERCC" requestet werden bei:

    Line 1 : 2:2448/7808.0 (Nummer siehe oben)
    Line 2 : 2:2448/7809.0 (Nummer siehe oben)
    Line 3 : 2:2448/7820.0 (Nummer siehe oben)
@endnode
@prev "Usage"
@node "Greetings" "MM_SuperCC.guide/Greetings"
@next "History"
"Danke" an einige Leute...
--------------------------

 Mein Dank gilt

    Hartmut Birkholz - fürs Beta-testen und dafür, daß er sein BBS trotz zweier
                       Harddisk-Crash nicht offline genommen hat sowie für sei-
                       ne ständige Kritik an meinen Programmen, um diese zu
                       perfektionieren... ;)

    Juergen Werner   - für die Idee zu diesem Programm

    @{"Pino Aliberti" link "MailManager" 0}   - für die beste Fido-Software, die es jemals gab (Tosser)

    Mirko Viviani    - für die beste Fido-Software, die es jemals gab (Mailer)

    Siggi Weisner    - für seinen großartigen MM-Support in Deutschland

    Tilo Winkler     - für einige gute Ideen zu MM_SuperCC

    Birgit Aldefeld  - ...warum wohl ? :-)
@endnode
@prev "Support"
@node "History" "MM_SuperCC.guide/History"
@next "MailManager"
+---------+----------+-------------------------------------------------------+
| Version | Date     | Changes/Comments                                      |
+---------+----------+-------------------------------------------------------+
|   0.10  | 16.10.95 | Erstes Release                                        |
+---------+----------+-------------------------------------------------------+
|   0.15  | 07.12.95 | - Eingabe-Modus hinzugefügt:                          |
|         |          |   Adressen können einzeln per Hand eingegeben werden, |
|         |          |   ohne jegliche Listen                                |
+---------+----------+-------------------------------------------------------+
|   0.20  | 08.12.95 | - Tearline hinzugefügt                                |
|         |          | - Support für Gateways und eMails hinzugefügt         |
|         |          | - Kleine kosmetische Änderungen am Guide              |
+---------+----------+-------------------------------------------------------+
|   0.25  | 02.01.96 | - Tearline geändert (jetzt FTN-konform)               |
|         |          | - Temporäre Files werden nach Beendigung des Programms|
|         |          |   nun gelöscht                                        |
|         |          | - Alternativer CC:-Header-Typ bei der Wildcard-Suche  |
|         |          |   (Suchmuster statt Namen) implementiert              |
|         |          | - Nodelist-Support erweitert                          |
|         |          | - Man selbst wird nun als Empfänger gelöscht          |
|         |          | - Bugfix: letzter Eintrag in der Liste kann nun ge-   |
|         |          |   löscht werden                                       |
|         |          | - Bugfix: im Wildcard-Suchemodus klappt das Versenden |
|         |          |   nun, wenn es nur einen Empfänger gibt und dieser    |
|         |          |   mehr als einen Nodelist-Eintrag hatte               |
+---------+----------+-------------------------------------------------------+
|   0.27  | 14.02.96 | - Ärgerlicher Bug in der Mailing-List-Funktion ent-   |
|         |          |   fernt (Nachrichten wurden immer an "Unknown" ge-    |
|         |          |   schickt, wenn der Empfänger nicht in der Nodeliste  |
|         |          |   auftauchte, selbst wenn in der Mailingliste ein Name|
|         |          |   angegeben war)                                      |
|         |          | - Deutsches Hauptprogramm und Dokumentation erstellt  |
|         |          | - Kleine Korrekturen in der Dokumentation             |
+---------+----------+-------------------------------------------------------+
|   0.30  | 26.02.96 | - Bugfix: in einigen Fällen wurden FTN-NetMails nicht |
|         |          |   verschickt                                          |
|         |          | - Bugfix: FTN-NetMails hatten grundsätzlich keinen    |
|         |          |   Empfängernamen                                      |
|         |          | - Posten in Areatags implementiert                    |
|         |          | - Neues Keyword in der Konfiguration: #ECHOREC für den|
|         |          |   Standard-Empfängernamen bei Areas                   |
|         |          | - Bei NetMails können nun Empfangsbestätigungen ange- |
|         |          |   fordert werden                                      |
|         |          | - History-File in das Guide-File eingebunden          |
|         |          | - Komplette Überarbeitung des Programms               |
+---------+----------+-------------------------------------------------------+
|   0.35  | 02.05.96 | - Bugfix: manchmal wurde nicht gefragt, ob die Liste  |
|         |          |   gespeichert werden soll, wenn etwas geändert wurde  |
|         |          | - Neue Keywords: #ZONE und #NET, für besseren Support |
|         |          |   von Network-Files im Wildcard-Modus                 |
|         |          | - Neues Keyword: #UNKNOWN für den Standard-Namen von  |
|         |          |   ungelisteten Sites                                  |
|         |          | - Unterstützt jetzt Realnamen bei eMail-Adressen (im  |
|         |          |   CC:-Header), siehe oben bei Listenformat/Eingabe    |
|         |          | - Es sind jetzt für jeden Areatag unterschiedliche    |
|         |          |   Empfängernamen möglich (siehe auch oben)            |
|         |          | - Zwei kleine "Bugs" im Guide entfernt                |
|         |          | - Listview arbeitet nun mit MM 1.2                    |
+---------+----------+-------------------------------------------------------+
@endnode
@prev "Greetings"
@node "MailManager" "MM_SuperCC.guide/MailManager"
@next "Copyright"
                         @{b}M A I L   M A N A G E R@{ub}

                              @{i}v1.2 release@{ui}

                             Full Integrated
                   Tosser/Scanner/Editor/Tick Processor

                              Copyright (C)
                        1994/95/96 @{"Pino Aliberti" link "Greetings" 0}
                           All rights reserved
@endnode
@prev "History"
@node "Copyright" "MM_SuperCC.guide/Copyright"
Copyright-Hinweis
-----------------

 Dieses programm wurde unter dem Konzept der Freeware herausgegeben. Jeder darf
 das Programm kopieren und benutzen, solange am Programm und/oder den dazuge-
 hörenden Dateien keine Änderungen vorgenommen werden.
@endnode
@prev "MailManager"
