
                 Dokumentation:  AscDown -> ZC-Puffer
                                 ~~~~~~~~~~~~~~~~~~~~

da  das  schreiben des Programmes nur wenige Minuten dauerte, waere es
bloedsinn,  jetzt  eine  ordentliche,  saubere Anleitung zu schreiben.
daher fasse ich mich kurz:

sinn und zweck des programmes:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
ich  hatte  hier  in  meiner  Box  das  problem,  das  ich einem Point
unnbedingt  alle  Eintraege  in  einem  Netz-brett nocheinmal schicken
musste,  obwohl er sie schoneinmal "zu hause" bei seinem Pointprogramm
hatte, die eintraege also fuer ihn <ALT> waren.
Wie  gibt  man  nun  also  in  einer solchen situation dem Point einen
Puffer, in dem "alte" Mails nocheinmal drin sind ?
Auf  jede  Mail  einzeln  zu  antworten  waere  recht  langwierig  und
umstaendlich.  mit den files ".index" und "TextFile" kann ein XP- oder
MD-Point nichts anfangen..  nunja..  also muessen alle Mails irgendwie
ausgelagert und als ZCONNECT Puffer umgewandelt werden.
Das macht das kleine AREXX-Script, vondem ihr hier die Anleitung lest!

vor/nachteile:
~~~~~~~~~~~~~~
nachteile: - das programm is tierisch langsam
           - es unheimlich kompliziert aufzurufen
           - es ist in AREXX und nicht in C

vorteile:  - es funktioniert und erfuellt seinen zweck
           - es dauerte nur wenige minuten den Script zu schreiben

installation:
~~~~~~~~~~~~~
1. sicherstellen, das das file "C:SMail" existiert (von Kai Szymanski)

2. das programm "AD2ZC" in ein beliebiges verzeichnis kopieren.
   in unserem beispiel hier in der anleitung soll es das verzeichnis
   "BBS:" sein!

3. ueber ConLogin in die eigene Mailbox gehen und im "Box-Inhalt"
   in den entsprechenden Brettern alle gewuenschten Eintraege MARKIEREN
   und anschliessend MERKEN.

4. nun die gemerkten Nachrichten mit "gemerktes Download" packen (da
   es in der aktuelle Version von AmBoS (v2.065) nicht moeglich ist,
   die Nachrichten ungepackt zu uebertragen) und das Archiv lesen.

5. Anschliessend wird das Paket entpackt.
   Fuer jedes Brett, aus dem Mails gemerkt wurden, existiert nun ein
   einzelnes file. Diese werden z.B. in's RAM: kopiert.

6. jetzt kann's losgehen  :))


anwendung:
~~~~~~~~~~
Da  das  Programm "AD2ZC" ein AREXX-Script ist, muss es mit dem Befehl
"Rx"  ausgerufen  werden,  der bei jeder WorkBench Diskette dabei sein
sollte; ebenso die entsprechenden Libraries!

Der Syntax lautet wie folgt:

Rx AD2ZC BRETT ADOWN DOMAIN DATUM

BRETT  = Emfaenger-Brett (z.B.: "/AmBoS-NET/TEST/TESTMAILS")
ADOWN  = entpacktes AscDownload-File (z.B.: "RAM:Lokales")
DOMAIN = Domain der eigenen Box (z.B.: "nasus.north.de")
DATUM  = Soll das Datum der Original-Mail in der konvertierten Mail
         aufgefuehrt werden?  "JA" oder "NEIN"

Ein richtiger Aufruf kann zum Beispiel folgender sein:

Rx AD2ZC /AmBoS-NET/TEST/TESTMAILS RAM:Diskussion nasus.north.de JA

Das    bedeutet:     Alle    Eintraege    aus   dem   AscDownload-File
"RAM:Diskussion" werden fuer das Brett /AmBoS-NET/TEST/TESTMAILS/ kon-
vertiert.   Da  auch  Online-User in Bretter schreiben koennen, ist es
wichtig,  dass die Box-Domain angegeben ist (hier:  "nasus.north.de").
Ein kleines prob gibt es allerdings bei der ganzen sache:
in  den  ZCONNECT-Puffer werden alle Eintraege mit dem aktuellen Datum
versehen und nicht mit dem Original-Datum.
Aus  diesem  Grund  hat  man  mit  dem  letzten  Parameter "DATUM" die
moeglichkeit,  bei  den konvertierten Mails in den Puffer, automatisch
eine Extra-Zeile einfuegen zu lassen, den einen entsprechenden Hinweis
und das richtige Datum erhaelt:

[Diese Nachricht wurde kopiert! Original-Datum: 21-08-95  07:43:00]

Es  muss  darauf geachtet werden, das als letzte Parameter "DATUM" nur
"JA"  oder  "NEIN"  zulaessig ist (gross/kleinschreibun ist allerdings
egal!).

waehrend des programm-ablaufes wird die Anzal der bisher konvertierten
Mails  angezeigt.   Anschliessend  liegen  alle  Mails  aufgeteilt und
einzeln in dem Verzeichnis:

T:Sort/

Man  muss  nun  nur  noch  unter  AmBoS folgenden Punkt im ZNetz-Modul
starten, um die Mails einzusortieren:

Modules/ZNetz.MOD/SETUP/"Puffer einsortieren"

Beim einsortieren ist darauf zu achten, dass als "Server" eine Mailbox
angegeben  wird  und  kein  Point,  da  sonst der Absender automatisch
geaendert wird! Weiterhin muss das angegebene Sites (die Mailbox)
auch Schreibzugriff in dem entsprechenden Brett haben.


fehler beim Aufruf, bzw. Verarbeitungsfehler:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Da ich es immer ganz gut finde, wenn programme den Benutzer mitteilen,
was  sie  beim  Aufruf  falsch gemacht haben, faengt auch das Programm
"AD2ZC" moeglichst viele fehlbedienungen ab:

- Das Empfaenger-Brett wurde nicht angegeben!
- Die Angabe des entpacktes ASCII-Download Files fehlt!
- Das angegebene AscDownload-File fehlt: "FILENAME"
- Die eigene Mailbox-Domain wurde nicht angegeben!
- Falsche Parameter-Angabe: <DATUM>
  an dieser Stelle ist nur "JA" oder "NEIN" zulaessig!
- Das Programm  "C:SMail"  fehlt !
- Das angegebene File ist KEIN AscDownload-File: "FILENAME"

Verarbeitungsfehler:
auch  hier  ist  eine  sache  bekannt!   In den Mails, die konvertiert
werden   sollen,   darf  keine  Zeile  vorhanden  sein,  die  74x  den
Bindestrich "-" enthaelt und die naechste Zeile eine Leerzeile ist und
die darauffolgende Zeile den Eintrag "Absender :  " enthaelt.
ACHTUNG:  In den ausgelagerten AscDownload-Files sind natuerlich diese
Zeilenkombinationen  vorhanden,  da  sie  immer  2  Mails  voneinander
trennen.   Dort  duerfen sie auch drin sein, nur eben nicht einer Mail
selbst.    Aber   dazuzusagen   muss   man  noch,  das  es  sogut  wie
unmoeglich  ist,  dass  die  besagte  Kombination jemals in einer Mail
auftreten wird! :)


distribution und copyrights:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Das  Programm  "AD2ZC",  sowie  alle  dazugehoerigen Progammteile sind
FREEWARE!  Es darf frei kopiert und weitergegeben werden, solange fuer
die  Duplizierung  kein  Geld  genommen  wird  und das Programm, sowie
Programmteile,  Beschreibungen  und  diese  Dokumentation unveraendert
bleiben.  Eine Distribution in Mailboxen ist ausdruecklich erwuenscht!
Saemtliche Rechte liegen bei dem Autor des Programmes.
Der   Autor   schliesst  jegliche  Haftungen  bei  die  Benutzung  des
Programmes  aus  und  kann  fuer  moegliche Schaeden an Soft- und/oder
Hardware  oder  fuer moeglichen Datenverlust, die direkt oder indirekt
durch  das  Programm  verursacht  wurden, nicht verantwortlich gemacht
werden.
Die  Benutzung  des Programmes geschieht auf eigene Gefahr.  Der Autor
versichert,  dass  ihm  vor der Veroeffentlichung keine Fehler bekannt
sind, die oben genannte Schaedigungen herbeifuehren koennten.
Sämtliche   genannten   Firmen-,   Marken-  und  Artikel-Namen,  sowie
Copyrights in dieser Dokumentation, im Programm oder in Programmteilen
liegen  bei  den entsprechenden Herstellern, Autoren oder Programmier-
ern.  Alle Rechte vorbehalten.
Das Zusatzprogramme "SMail" stammt von:
(c) Kai Szymanski & Jörg Eßmann 1993/1994/1995

Mögliche   gramatikalische   Fehler  oder  Rechtschreibfehler  in  der
Anleitung und in dem Programm sind zu entschuldigen.


autor:
~~~~~~
das programm wird garantiert NIE weiterentwickelt!  :)
Da  es  sich  erstens  garnicht lohnt und zweitens verkaufe ich meinen
Amiga und mache die Mailbox zu!  :))

wer mir mal was schreiben will, kann es gerne machen:

bAStARd@d-area.ohz.north.de

...byebye and stay tuned!

