                           Dokumentation zu

                                 mapS


                   Version 1.2 vom 9. Februar 2001
                     (C) 2000, 2001 Gerald Dietze
             P.O. Box 1401   70810 Korntal   Deutschland

                          Inhaltsverzeichnis

Inhaltsverzeichnis
==================

 1  Allgemeines zu mapS
    1.1  Fr wen ist mapS interessant?
    1.2  Rechtliches und Einschrnkungen in der Demoversion
    1.3  Hard- und Software-Voraussetzungen
    1.4  ==> Registrierung <==
    1.5  Der Registrierungsvorgang
    1.6  Bezugsquellen fr die jeweils aktuellste Version
    1.7  Kontakt zum Autor
    1.8  Das Softwarepaket
    1.9  Dank an...

 2  Die Dateiformate
    2.1  Das Dateiformat der Adredatei (*.ADR)
    2.2  Das Dateiformat der Mailtextdateien (*.TXT)
    2.3  Kompatibilitt der Dateien

 3  Installation und Bedienung
    3.1  Installation
    3.2  Die Bedienung von mapS
    3.3  Die Online-Hilfe

 4  Vergangenheit und Zukunft
    4.1  mapS History
    4.2  Ausblick



1  Allgemeines zu mapS
**********************


1.1  Fr wen ist mapS interessant?
==================================


mapS ist fr alle interessant, die

    den STinG-kompatiblen Mailer MyMail von Erik Hll verwenden.

    Massenmails mit Variablem Inhalt verschicken mchten.


1.2  Rechtliches und Einschrnkungen in der Demoversion
=======================================================

                  mapS (C) 2000, 2001 Gerald Dietze
                       Alle Rechte vorbehalten

     Dietze Soft International - P.O. Box 1401 - D-70810 Korntal

      Urheberrechtliches und Einschrnkungen in der Demoversion

mapS ist Shareware. Als einzige Einschrnkung zur registrierten
Version gibt das Programm unter jeder Mail einen Infotext aus, der
darber unterrichtet, da die Mail mit einem unregistrierten mapS
erstellt wurde.
Die beim Autor erhltlichen Codes zur Erzeugung der Vollversion drfen
unter keinen Umstnden Dritten zugnglich gemacht werden, weil mit
ihnen beliebig viele voll lauffhige Programme unter Ihrem Namen
erstellt werden knnen. Die Programmdateien der Vollversion drfen
nicht an Dritte weitergegeben werden. Eine Weitergabe der Demoversion
ist gestattet und erwnscht. Allerdings mu immer das komplette,
unvernderte Originalarchiv weitergegeben werden.
Die Vernderung der Programmdateien und der Anleitung (alle beiliegen-
den Formate) ist nicht gestattet.
Zuwiderhandlungen werden verfolgt.
Ferner ist es nicht erlaubt, mit Hilfe des Programmes unerwnschte
SPAM zu verschicken.


                          Haftungsausschlu

Dieses Programm wurde sorgfltig programmiert und unzhlige Male ge-
testet. Dennoch sind Fehler nie ganz auszuschlieen. Ich bernehme
weder ausdrcklich noch stillschweigend irgendwelche juristische Ver-
antwortung oder Haftung fr Schden, die durch den Betrieb von mapS
entstehen. Fr die Vollstndigkeit und Richtigkeit des Handbuches
mapS.hyp bzw. mapS.txt kann keine Gewhr bernommen werden.
Mit der Verwendung des Programms erkennt der Benutzer an, da er
selbst fr alle Schden verantwortlich ist, die durch das Absenden der
mit mapS erzeugten Mails verursacht werden.

                             Warenzeichen

Innerhalb dieser Dokumentation wird auf Warenzeichen Bezug genommen,
die nicht explizit als solche ausgewiesen sind. Aus dem Fehlen einer
Kennzeichnung kann nicht geschlossen werden, da ein Name frei von
Rechten Dritter ist.



   mapS ist geschrieben in OMIKRON.BASIC unter Verwendung der KLib-
                             Bibliothek.





1.3  Hard- und Software-Voraussetzungen
=======================================

     Hard- und Software-Voraussetzungen fr den Betrieb von mapS:

    Jeder Rechner, auf dem ein TOS-kompatibles Multitaskingsystem
     luft oder emuliert wird. Unter Single-TOS selbst luft das Pro-
     gramm nicht. Getestet wurde unter MagiC! 6

    Grafikauflsung von mindestens ST high res (640*400). Die Farb-
     tiefe spielt keine Rolle.

    Ein Texteditor, der das TAB-Zeichen (ASCII 9) mitspeichert, z.B.
     qed.

    Natrlich MyMail von Erik Hll





1.4  ==> Registrierung <==
==========================

mapS ist Shareware und selbstverstndlich freue ich mich ber jede
eingehende Registrierung.

Der Registrierungsbeitrag fr mapS betrgt nur

                                3 EUR

Zur Anforderung der Registrierschlssel gibt es nur die folgende Mg-
lichkeit:

    per E-Mail (siehe "Kontakt zum Autor")
      berweisung auf das Konto:
          Gerald Dietze
          Konto Nr. 347 36 72
          Landesbank B-W (BLZ 600 501 01)
     Die Codes werden bei Eintreffen der berweisung per E-Mail abge-
     schickt.

Bei berweisungen bitte Namen und E-Mail-Adresse vollstndig angeben,
diese Daten sind absolut notwendig zum Erstellen des Codes.
Den folgenden Bestellschein bitte parallel dazu ausgefllt per E-Mail
an mich senden:

----------------------------------------------------------------------


     Dietze Soft International
     -Gerald Dietze-
     P.O. BOX 1401
     D-70810 Korntal-Mnchingen

     E-Mail: Internet: DSI@gerald-dietze.de
     Mausnetz: Gerald Dietze@S


     Betr.: DSI mapS

     Hiermit bitte ich um bersendung des mapS-Registriercodes an meine
     E-Mail-Adresse ______________________________

     Den Betrag i.H. von 3 EUR habe ich berwiesen.

     Meine Adresse:

                      Name   :_____________________________

                      Strae :_____________________________

                      PLZ/Ort:_____________________________






1.5  Der Registrierungsvorgang
==============================

Eine unregistrierte Version von mapS kann man mit den Registriercodes
folgendermaen registrieren:
Im Programm mapS.prg den Infodialog aufrufen und dort den Punkt "R"
whlen. Namen und Registriercode eingeben und die Eingabe besttigen.
Die Registrierung war erfolgreich, wenn der Registrierungsbutton nicht
mehr anwhlbar ist.
Eine Weitergabe der Registriercodes ist ausdrcklich verboten!



1.6  Bezugsquellen fr die jeweils aktuellste Version
=====================================================

           Bezugsquelle fr die jeweils aktuellste Version

    Nur noch im WWW:
     http://gerald-dietze.de/dsi.html





1.7  Kontakt zum Autor
======================

                          Kontakt zum Autor

Ich bin am Besten ber meine E-Mail Adressen erreichbar. Per
Schneckenpost kann es mit der Antwort etwas dauern. In diesem Falle
knnen auch nur Anfragen mit beiliegendem Freiumschlag beantwortet
werden.

    Internet: DSI@gerald-dietze.de
    Snail-Mail:
     Gerald Dietze
     Postfach 1401
     D-70810 Korntal






1.8  Das Softwarepaket
======================

                Die wichtigsten beiliegenden Dateien:

 MAPS.PRG: Das Programm mapS



Dateien in deutscher Sprache:

 \GERMAN\MAPS.RSC: Die notwendige Resource-Datei
 \GERMAN\MAPS.SYS: Eine zum Betrieb ntige Systemdatei
 \GERMAN\MAPS.HLP: Die Bubble-Help Hilfetexte
 \GERMAN\HANDBUCH\ASCII\MAPS.TXT: Das Handbuch als ASCII-Text
 \GERMAN\HANDBUCH\STG\MAPS.HYP: Das Handbuch als ST-Guide Hypertext
 \GERMAN\HANDBUCH\STG\MAPS.REF: Das REF-File zum HYP
 \GERMAN\HANDBUCH\HTML\MAPS.HTM: Das Handbuch als HTML-Dokumente
 \GERMAN\BEISPIEL\*.*: Beispieldateien



Dateien in englischer Sprache:

 \ENGLISH\MAPS.RSC: Die notwendige Resource-Datei
 \ENGLISH\MAPS.SYS: Eine zum Betrieb ntige Systemdatei
 \ENGLISH\MAPS.HLP: Die Bubble-Help Hilfetexte
 \ENGLISH\HANDBUCH\ASCII\MAPS.TXT: Das Handbuch als ASCII-Text
 \ENGLISH\HANDBUCH\STG\MAPS.HYP: Das Handbuch als ST-Guide Hypertext
 \ENGLISH\HANDBUCH\STG\MAPS.REF: Das REF-File zum HYP
 \ENGLISH\HANDBUCH\HTML\MAPS.HTM: Das Handbuch als HTML-Dokumente
 \ENGLISH\EXAMPLE\*.*: Beispieldateien




 LIESMICH.TXT: Datei, die ber die neusten nderungen informiert
     (deutsch)
 README.TXT: Datei, die ber die neusten nderungen informiert (eng-
     lisch)
 MAPS.INF: Wird nach der Installation bzw. dem ersten Programmstart
     geschrieben.
     In ihr stehen die Dateipfade, der Betreff und der
     Registrierschlssel.





1.9  Dank an...
===============

    Erik Hll fr die Entwicklung des Programms MyMail.
    Karsten Ldersen fr die umfangreiche GEM-Bibliothek KLib und
     Beta-Tests
    Ulf Ronald "dlanor" Andersson fr Beta-Tests





Erik Hll
---------

    Projekte:
      MyMail: Das Mailprogramm fr STinG
    Kontakt
      Internet: erikhall@tripnet.se
      WWW: http://www2.tripnet.se/~erikhall/main.html





Karsten Ldersen
----------------

    Projekte:
      KLib: Die umfangreiche GEM-Bibliothek fr OMIKRON.BASIC.
      KLed: Den Quelltexteditor fr OMIKRON.BASIC.
      Library-Maker Weiterentwicklung des Lib-Makers fr OMIKRON.BASIC
    Kontakt
      Mausnetz: Karsten Ldersen @ HH





Ulf Ronald "dlanor" Andersson
-----------------------------

    Projekte:
      STinG: Weiterentwicklung des Netzwerkpaketes STinG von Peter
          Rottengatter.
      BetaDOS: Ein verbesserter MetaDOS-Ersatz.
      LaceScan: Auflsungsverbesserung fr STs und STEs.
    Kontakt
      Internet: dlanor@ettnet.se





Markus Kohm
-----------

    Projekte:
      Mungojerrie: Rundschreiben ber CAT verschicken
      Jelly Cat: CAT-Modul: Blockschutz fr eingerckte Blcke
    Kontakt
      Mausnetz: Markus Kohm @ KA2






2  Die Dateiformate
*******************


2.1  Das Dateiformat der Adredatei (*.ADR)
===========================================

                       Die Adredateien (*.ADR)

In jeder Adredatei werden in der ersten Zeile die Variablennamen
definiert. Jede Variable sollte mit $ beginnen und die nachfolgende
Buchstabenfolge sollte gro geschrieben sein. Gro- und Kleinschrei-
bung werden nmlich unterschieden. Die definierten Variablennamen
werden durch ein TAB-Zeichen, im Folgenden als [T] gekennzeichnet,
getrennt. Die erste Variable steht immer fr die Mailadresse des
Empfngers und lautet $ADR. Den Rest knnen Sie nach Belieben selbst
festlegen. Einzige Regel: Alle Variablenbezeichnungen mssen verschie-
den sein und drfen nicht Teil voneinander sein. Beispielsweise wren
$NAME und $NA gleichzeitig nicht gestattet. mapS sucht nmlich einfach
nach den Variablenbezeichnern und ersetzt diese im Mailtext. Wenn $NA
ersetzt wird durch "Helmut" knnte es passieren, da HelmutME in der
Mail herauskommt!
In den folgenden Zeilen stehen die Datenstze, auch wieder durch [T]
getrennt. Fr jede Zeile wird spter eine Mail ausgegeben, wobei der
Variablen an der n. Position in der 1. Zeile der Wert an der n.
Position aus der gerade zu bergebenden Zeile zugewiesen wird. Klingt
kompliziert, ist aber eigentlich ganz einfach, wie Sie anhand eines
Beispiels sehen werden: Sie haben ein Veranstaltungsbro fr Kurse zur
Persnlichkeitsbildung und mchten in einem Rundschreiben mehrere
Leute mit persnlicher Anrede anschreiben und einladen.

Es wird folgendes File angelegt:

$ADR[T]$R[T]$NAME
helmut@knackis.de[T]r[T]Herr Kohl
Clement@irrenhaus.de[T]r[T]Herr Clement
merkel@bundestag.de[T][T]Frau Merkel


Wichtig ist, da Sie einen Editor verwenden, der das [T]-Zeichen
korrekt mit abspeichert.
Jetzt ist nicht gesagt, da Sie unbedingt die Mails an alle in der
Adredatei genannten Personen ausgeben mchten. Empfnger, die Sie aus
dem Mailempfang ausschlieen wollen, werden einfach mit den Steuerwor-
ten $OFF und $ON geklammert. Jedes der Steuerworte mu allein, nicht
eingerckt in einer eigenen Zeile stehen.

Mchten Sie beispielsweise die nur Leuten aus der CDU das Seminar
anbieten, so schreiben Sie die Steuerworte an folgenden Positionen in
die Datei:


$ADR[T]$R[T]$NAME
helmut@knackis.de[T]r[T]Herr Kohl
$OFF
Clement@irrenhaus.de[T]r[T]Herr Clement
$ON
merkel@bundestag.de[T][T]Frau Merkel


Selbstverstndlich kann ein Block aus mehr als nur einer Adresse
bestehen.

Seit V1.1 ist mapS um eine mchtige Funktion reicher. Jeder kennt das
Problem, da man auch Mails zu verschiedenen berbegriffen an einen
Adressaten schicken mchte. Bisher mute man pro Kategorie eine eigene
Mailadressen-Datei anlegen und darin den Namen ablegen. ndert sich
die Mail-Adresse eines Empfngers, kommt es schnell zum Chaos, weil
man jede Adredatei berprfen und die Adresse dort ndern muss. In
der neuen Programmversion ist es auch anders mglich, so da man alle
Mailadressen in einer einzigen Adredatei verwalten kann. Dazu wird
noch eine Variable, mit dem fest vorgegebenen Namen $DISTRIBUTION
eingefhrt. Man verteilt fr unterschiedliche Mail-Listen unterschied-
liche Buchstaben und trgt diese in jedem Datensatz an der Stelle von
$DISTRIBUTION ein, wenn jemand Mails aus dieser Liste erhalten soll.
Die Auswahl des Personenkreises wird dann whrend der Laufzeit von
mapS getroffen, indem man unter Empfnger die Abkrzungsbuchstaben der
Gruppen eintrgt, an die die Mail verschickt werden soll.

Auch hier ein kleines Beispiel:


$ADR[T]$R[T]$NAME[T]$DISTRIBUTION
helmut@knackis.de[T]r[T]Herr Kohl[T]c
Clement@irrenhaus.de[T]r[T]Herr Clement[T]s
merkel@bundestag.de[T][T]Frau Merkel[T]c
Dieter@hallervorden.de[T]r[T]Herr Hallervorden[T]k

Damit wren folgende Empfngergruppen klassifiziert:
c: Parteimitglied der Partei A
s: Parteimitglied der Partei B
k: Komiker

Mchte man nun eine Mail an alle mglichen komischen Leute eine Mail
schreiben, trgt man in mapS im Feld "Empfnger" einfach die Buchsta-
ben "csk" ein. Mchte man nur an Parteimitglieder von Partei A
versenden, gibt man c ein. Ein Versand nur an Komiker erfolgt mit "k".



2.2  Das Dateiformat der Mailtextdateien (*.TXT)
================================================

                     Die Mailtext-Dateien (*.TXT)

Um nun eine persnliche Mail an die Leute in einer Mailingliste zu
richten reicht es, die Variablen als Platzhalter an gewnschter Stelle
einzubauen, Z.B. so:


Liebe$R $NAME!
Wir wrden Sie gern zu unserem Seminar "Das dumme Volk betrgen leicht
gemacht" einladen. Auerdem bieten wir den Wochenendkurs "Einschch-
tern von Journalisten - im Dienste der Demokratie" an. Der erste Kurs
wird in der CDU-Zentrale stattfinden, der zweite im Nordrheinwestfli-
schen Staatsministerium. Bei Interesse melden Sie sich bitte per Mail.

Es grt Sie Ihr
Convenience-Consulting-Bureau Mller

Empfngeradresse: $ADR



2.3  Kompatibilitt der Dateien
===============================

Wer Das Maustauschprogramm CAT kennt, wird sicher auch schon Rund-
schreiben mit dem Modul Mungojerrie (siehe "Markus Kohm") verschickt
haben.
Die Idee fr mapS ist aus Mungojerrie entstanden. Deshalb sind die
Dateiformate fr Adredateien und Mailtexte auch kompatibel. Wer
bereits Dateien unter CAT und Mongojerrie verwendet hat, kann diese
direkt bernehmen!



3  Installation und Bedienung
*****************************


3.1  Installation
=================

                             Installation

Kopieren Sie zuerst den gesamten MAPS-Ordner auf eine beliebige
Festplattenpartition. Wenn Sie mapS auf Englisch statt auf deutsch
verwenden mchten, gehen Sie wiefolgt vor:
Whlen Sie den Ordner "GERMAN" fr deutsch, oder "ENGLISH" fr eng-
lisch und kopieren Sie den gesamten Inhalt am Stck eine Ebene nach
aussen, d.h. auf die Ebene von mapS.prg.
Wenn Sie den ST-Guide als Hilfesystem verwenden, knnen sie noch
mapS.hyp und mapS.ref in den Hypertext-Ordner oder auf die Ebene von
mapS.prg kopieren.
Starten Sie mapS.prg.


3.2  Die Bedienung von mapS
===========================

                        Die Bedienung von mapS

mapS ist einfach zu bedienen und hat nur den Hauptdialog, eine Men-
leiste gibt es nicht.
Sofern Sie Bubble-Help installiert haben, bekommen Sie zu den Dialog-
elementen durch Klicken mit der Rechten Maustaste einen Informations-
text.



+--------------------------+------------------------------------------------------------------------------------+
| Dialogfeld/Button        | Erklrung                                                                          |
+--------------------------+------------------------------------------------------------------------------------+
| Adresse                  | Auswahl der zu verwendenden Adredatei.                                            |
+--------------------------+------------------------------------------------------------------------------------+
| Mailtext                 | Hier whlen Sie die Datei mit dem zu versendenden Mailtext aus.                    |
+--------------------------+------------------------------------------------------------------------------------+
| Betreff                  | Hier geben Sie den Betreff der Serienmail an.                                      |
+--------------------------+------------------------------------------------------------------------------------+
| MyMail                   | Damit mapS richtig arbeitet, mssen Sie hier den Pfad zum Programm MyMail angeben. |
+--------------------------+------------------------------------------------------------------------------------+
| Info                     | Info-Dialog und Registrierung.                                                     |
+--------------------------+------------------------------------------------------------------------------------+
| Hilfe                    | Ruft diese HYP-Seite auf.                                                          |
+--------------------------+------------------------------------------------------------------------------------+
| Ende                     | Sichert die Einstellungen und beendet das Programm.                                |
+--------------------------+------------------------------------------------------------------------------------+
| Mails an MyMail ausgeben | Gibt die Serienmails in die Datei qmail.txt aus.                                   |
+--------------------------+------------------------------------------------------------------------------------+

                Tabelle 1: Bedienung des Hauptdialoges


Sobald Sie die Ausgabe der Serienmails gestartet haben, wird in einem
ersten Durchgang berprft, ob wirklich jeder Datensatz der Adredatei
die ntige Anzahl an Datenelementen hat. Erkennt das Programm einen
Fehler, wird dieser gemeldet und die Ausgabe der Mails findet nicht
statt. Mit $OFF und $ON (siehe "Die Dateiformate") geklammerte
Bereiche werden einfach ignoriert.


3.3  Die Online-Hilfe
=====================

mapS bietet zwei Hilfemglichkeiten:

 ST-Guide: Damit Sie die Online-Hilfe nutzen knnen, mu in Ihrem
     System der ST-Guide als Hilfe-System installiert sein. MAPS.HYP
     und MAPS.REF knnen sich entweder im Verzeichnis von MAPS.PRG
     oder im Hypertext-Ordner befinden.
 Bubble-Help: Sofern Sie Bubble-Help installiert haben, bekommen Sie
     zu den Dialogelementen durch Klicken mit der Rechten Maustaste
     einen Informationstext.







4  Vergangenheit und Zukunft
****************************


4.1  mapS History
=================

    V1.0 vom 05.04.2000 (siehe "History V1.0")
    V1.1 vom 24.08.2000 (siehe "History V1.1")
    V1.2 vom 02.08.2001 (siehe "History V1.2")





History V1.0
------------

    Bugfixes:

        - Noch keine, da erste ffentliche Version von mapS

    Neues:

        - Alles, da erste ffentliche Version





History V1.1
------------

    Bugfixes:

        - keine, da keine Bugs bekannt

    Neues:

        - Es knnen Adressatengruppen angelegt werden. Ab jetzt
          braucht man keine Maillisten fr verschiedene Empfngergrup-
          pen mehr, sondern eine Datei mit allen Adressen. gengt.





History V1.2
------------

    Bugfixes:

        - Das Programm arbeitet nun ohne Probleme parallel zu STinG
          und dem Dialer.
        - Fehler in den Dateipfaden gefixt
        - Beim ersten ffnen des Programms konnte der Hauptdialog in
          die Menzeile heireinragen.
        - Durch einen Fehler im englischen Resource-File, konnte der
          englische ST-Guide Hypertext nicht als Online-Hilfe
          verwendet werden.
        - In der Englischen Version wurde mein Drcken der Help-Taste
          die Online-Hilfe nicht aufgerufen.

    Neues:

        - nichts...





4.2  Ausblick
=============

                               Ausblick

Wieviel an diesem Programm weiterentwickelt wird, hngt auch von den
Rckmeldungen der Benutzer ab. Vorschlge fr Programmerweiterungen
knnen gern gemacht werden, wenngleich ich deren Verwirklichung nicht
garantieren kann.
Ansonsten schau'mer mal, was mir noch einfllt...




