
                             FWDMAKER V 1.3
                             ==============

          (c) by Stephan Klepper (DR5EIN), Sysop der DR5BOX

INHALTSVERZEICHNIS
------------------

1............... Was ist FWDMAKER?
2............... Installation von FWDMAKER
3............... Update von V1.1, V1.2 oder V1.2a auf V1.3
3a.............. Neuerungen in V1.3
4............... Das FWDMAKER.CFG File
4a.............. Die H-Routenausschlussdatei
5............... Wie arbeitet FWDMAKER?
6............... Welche Zeilen werden in den Forwarddateien geplegt?
7............... Der FWDMAKER-REPORT
8............... Voraussetzungen fuer das Funktionieren von FWDMAKER
9............... Aufbau einer Forwarddatei fuer FWDMAKER
10.............. Was kann FWDMAKER nicht?
11.............. Noch Fragen?
12.............. Wichtige Hinweise
13.............. Danksagungen


1. Was ist FWDMAKER?

FWDMAKER ist eine Programm welches die Fowarddateien unter FBB automatisch
pflegen kann. Es dient dazu dem Sysop einer FBB-Mailbox die Arbeit mit den
Forwarddateien zu erleichtern in dem es diese automatisch pflegt.


2. Installation von FWDMAKER

FWDMAKER zu installieren ist sehr einfach. Kopiere FWDMAKER.EXE am besten
in das BIN-Verzeichnis von FBB, z.B.:

   COPY FWDMAKER.EXE C:\FBB\BIN

Kopiere FWDMAKER.CFG in das Hauptverzeichnis von FBB, z.B.:

   COPY FWDMAKER.CFG C:\FBB

Editiere FWDMAKER.CFG mit einem beliebigen Editor und passe es auf Deine
Dateien an. Waehle fuer den Erststart die 'Letzte Nachrichtennummer' nicht
zu klein da die Verabeitung sonst sehr lange dauern kann.

Jetzt kannst du FWDMAKER aus dem FBB-Hauptverzeichnis starten:

   CD C:\FBB
   FWDMAKER

FWDMAKER kann jederzeit gestartet werden. Die 'Letzte Nachrichtennummer'
wird festgehalten und FWDMAKER scannt nur die neu hinzugekommenden Nach-
richten.

Ich empfehle den Lauf einmal taeglich durchzufuehren. Am besten fuegst Du
FWDMAKER in das Housekeeping der Box ein. Fuege den Aufruf von FWDMAKER an
geeigneter Stelle in die APPEL.BAT im FBB\BIN-Verzeichnis ein.


3. Update von V1.1, V1.2 oder V1.2a auf V1.3

Das Update auf die neue Version 1.3 des FWDMAKER ist genauso einfach
wie die Installation. Ersetze einfach das vorhandene Programm durch das
neue Programm. Denke bitte an die neue FWDMAKER.CFG-Datei und passe diese
an. Die alte Konfigurationsdatei darf fuer V1.3 nicht mehr verwendet werden.

Wird von V1.1 auf V1.3 upgedatet empfehle ich die Mailnummer in der
Konfigurationsdatei auf einen kleinen Wert zurueckzusetzen und den Merker
fuer Indirekte Routen auf JA zu setzen. Spaeter kann dieser nach Wunsch
wieder auf NEIN gesetzt werden.

ACHTUNG! Falls von V1.1 auf V1.3 upgedatet wird kann es sein, dass viele
Routen geloescht werden da in V1.1 noch kein Datum vorhanden ist.


3a. Neuerungen in V1.3

Zu allen Funktionen und Verbesserungen der Version 1.2a kommen folgende
neue Funktionen hinzu:

- Bestimmte H-Routen koennen in den FWD-Dateien von der Verwaltung durch
  FWDMAKER ausgeschlossen werden. Diese werden dann nicht mehr geloescht
  oder geaendert. Das ermoeglicht das Eingeben von festen H-Routen.

- Es koennen H-Routen-Kuerzel in einer neuen Datei erfasst werden. Routen
  in den Mails werden auf diese Kuerzel hin geprueft und ggf. von der
  Verwaltung durch FWDMAKER ausgeschlossen. Dadurch kann verhindert werden,
  dass unerwuenschte Routen eingetragen werden.

- Die Meldung des FWDMAKER an den Sysop kann unterdrueckt werden (nicht
  immer empfehlenswert).


4. Das FWDMAKER.CFG File

Das FWDMAKER.CFG File enthaelt alle benoetigten Pfadangaben, die letzte be-
arbeitete Mailnummer und das Call, welches die Meldungen von FWDMAKER er-
halten soll.

NEU in V 1.2:
-------------
Ausserdem enthaelt die Konfigurationsdatei die Anzahl Tage nachdem eine
Route als Verfallen gelten soll und ob das Datum in indirekten Routen
aktualisiert werden soll oder nicht.
Steht die Aktualisierung auf NEIN wird das Datum nur fuer in den Mails
gefundene H-Routen aktualisiert. Steht sie hingegen auf JA dann wird das
Datum auch fuer Routen in den anderen FWD-Dateien, also die nicht der
Route in den Mails entsprechen aktualisiert. 
Z.B.: Eine Route ist in Richtung XX1BOX ueber AA1BOX bekannt. Eine Mail
von XX1BOX kommt nun ueber BB1BOX. Die Route ist aber laenger. Also wird
die Route ueber AA1BOX nicht geloescht. Bei Aktualisierung JA wird das
Datum auch fuer die Route ueber AA1BOX aktualisiert selbst wenn keine
Mail von XX1BOX ueber AA1BOX kommt.

Neu in V 1.3:
-------------
Ein Pfad zu einer H-Routenausschlussdatei kann angegeben werden. Ist diese
Datei an der angegebenen Stelle nicht vorhanden erfolgt die Verarbeitung
wie bisher. Ist die Datei vorhanden wird sie bei jeder Bearbeitung einer
Mail gelesen und die Mail nach deren Angaben zur Verarbeitung geprueft.
WICHTIG: Der Pfad sollte in jedem Falle in der FWDMAKER.CFG angegeben sein,
auch wenn die Datei dann nicht vorhanden ist!
Wird beim Call anstelle des Sysopcalls 6 Striche (-) eingetragen schreibt 
FWDMAKER keine Meldung mehr.

Die Datei wird bei jedem Lauf mit der neuen letzten Mailnummer versorgt.
Diese kann auch manuell korrigiert werden um z.B. den Lauf nochmals durch-
zufuehren.

###########################
#      FWDMAKER.CFG       #
#   Konfigurationsdatei   #
#  fuer FWDMAKER.EXE V1.3 #
#       von DR5EIN        #
###########################
#
# Letzte verarbeitete Nachrichtennummer
#
100
#
# Pfad fuer die FBB-Systemdateien (BBS.SYS, DIRMES.SYS)
# z.B. C:\FBB\SYSTEM\      (wichtig: \ am Ende!)
#
C:\FBB\SYSTEM\
#
# Pfad fuer die FBB-Forwarddateien
# z.B. C:\FBB\SYSTEM\FWD\  (wichtig: \ am Ende!)
#
C:\FBB\SYSTEM\FWD\
#
# Pfad fuer die FBB-Maildateien
# z.B. C:\FBB\MAIL\        (wichtig: \ am Ende!)
#
C:\FBB\MAIL\
#
# Pfad des BBS Importfiles
# z.B. C:\FBB\MAIL.IN
#
C:\FBB\MAIL.IN
#
# Pfad und Name der H-Routenausschlussdatei
# z.B. C:\FBB\SYSTEM\FWD\NOHROUTE
#
C:\FBB\SYSTEM\FWD\NOHROUTE
#
# Call, welches die FWDMAKER-Meldungen erhalten soll
# z.B. Call des Sysops (max. 6-Stellen, '------' = keine Meldung ausgeben)
#
DR5EIN
#
# Anzahl Tage nachdem eine Route geloescht werden kann (000 bis 999)
# (bei 000 keine Loeschung der Routen)
#
090
#
# Datum in indirekten Routen aktualisieren? (JA oder NEIN)
#
NEIN
#
# *** END OF FILE ***

ACHTUNG! Kommentarzeilen muessen an ERSTER Stelle ein # haben. Die Datei
darf nicht GROESSER als 55 Zeilen (incl. Kommentarzeilen) werden!


4a. Die H-Routenausschlussdatei

Ist ein Ausschliessen von H-Routen von der Verwaltung durch FWDMAKER
gewuenscht kann eine H-Routenausschlussdatei erstellt werden. Der Pfad
zu dieser Datei muss dann in der FWDMAKER.CFG eingetragen sein.

Es koennen beliebige H-Routen oder auch nur Teile von H-Routen angegeben
werden. Jede Route muss in einer eigenen Zeile in der Datei stehen,
Kommentarzeilen sind NICHT erlaubt. Joker (* oder ?) sind NICHT erlaubt.

Die Datei kann mit jedem beliebigen Editor als reine Textdatei erstellt
werden.

Bespiel fuer den Inhalt einer H-Routenausschlussdatei:

.ITA.
#DR.HES
.WW
XX1BOX.#YY.HES.DEU.EU

Alle Routen in Mails, die die obigen Routenteile beinhalten, werden von
FWDMAKER nicht beruecksichtigt. 

FWDMAKER informiert ueber einen Ausschluss wenn die Meldung an den Sysop
nicht deaktiviert ist.


5. Wie arbeitet FWDMAKER?

FWDMAKER aktualisiert bei jedem Lauf die Forwarddateien. Es scannt alle
seit dem letzten Lauf eingegangenen Mails und fuegt eine neue Route in die
entsprechende Forwarddatei ein. Die Mails werden auf die Routingzeilen (R:)
hin gescannt.

Die jeweils erste und letzte R:-Zeile einer Mail wird ausgewertet. Die
erste Zeile enthaelt die unmittelbare Nachbarbox von der die Mail kam und
die letzte Zeile enthaelt die Route wo die Mail ihren Ursprung hatte.

Jetzt wird die Route aus der letzten Zeile in den Forward der in der ersten
Zeile ermittelten Box eingetragen. Der Eintrag erfolgt nur dann wenn das
Routing kuerzer ist als in einem der andern Forwarddateien. Gleichzeitig
wird der Routingeintrag in einer anderen Forwarddatei entfernt.
Dies setzt natuerlich voraus, das auch zu den Boxen geforwardet wird von
denen die Mails kommen.

FWDMAKER merkt sich die Anzahl Zwischenstationen eines Routings und traegt
dies auch in den Forwarddateien ein.

So werden Mails einer bestimmten Route automatisch an die Box versand von
der diese Route kam.

NEU in V 1.2:
-------------
FWDMAKER merkt sich das Datum an dem eine Route ermittelt oder bestaetigt
wurde. Es kann angegeben werden nach wieviel Tagen eine Route 'verfallen'
ist. Eine verfallene Route wird ersatzlos geloescht.


6. Welche Zeilen werden in den Forwarddateien gepflegt?

FWDMAKER pflegt nur die H-Zeilen in den Forwarddateien. Es werden immer die
KOMPLETTEN Routen in den H-Zeilen erfasst. Dadurch duerfen auch doppelte
Boxnamen vorkommen. Sie werden dann durch die Route voneinander unter-
schieden.

Die H-Zeilen werden am Anfang der Forwarddateien unmittelbar nach der A-
Zeile eingefuegt. Jeder H-Zeile folgt eine #-Zeile (Kommentarzeile) welche
die Anzahl Boxen auf dem Routingweg und das Datum beinhaltet.

Kommentarzeilen und alle andern Zeilen bleiben unberuehrt.

Neu in V 1.3:
-------------
Wird in einer FWD-Datei in der zu einer H-Route gehoerenden Kommentarzeile
anstelle der Anzahl der Zwischenstationen 3 Striche (-) eingetragen wird
diese H-Route von der Verarbeitung durch FWDMAKER ausgeschlossen.


7. Der FWDMAKER-Report

FWDMAKER schreibt dem im FWDMAKER.CFG File eingetragenem Sysop eine Mail mit
den durchgefuehrten Aenderungen.

Neu in V 1.3:
-------------
Bei Eintrag von 6 Strichen (-) als Sysopcall wird keine Mail erstellt.


8. Voraussetzungen fuer das Funktionieren von FWDMAKER

FWDMAKER holt sich die aktuelle Mailnummer aus der Datei DIRMES.SYS. Diese
muss also im SYSTEM-Verzeichnis zu FBB vorhanden sein.

FWDMAKER setzt voraus, dass die Boxen von denen Mails eintreffen in der
Datei BBS.SYS aufgefuehrt sind. Es nimmt an, dass zu den Boxen von denen
Mails kommen auch ein Forward eingerichtet ist.

Beispiel fuer eine BBS.SYS (gekuerzt):

########################
# BBS.SYS for FBB 5.15 #
# for DR5BOX by DR5EIN #
########################
#
# File containing all BBSs we forward to.
#
# Make sure that NO numbers are removed.
#
01 XX1BOX
02 XX2BOX
03
04 XX3BOX
05
.
. (bis)
.
79
80

ACHTUNG! Kommentarzeilen muessen an ERSTER Stelle ein # haben.

Weiterhin setzt FWDMAKER voraus, dass der Forward in UNTERDATEIEN zur
FORWARD.SYS eingerichtet ist. Diese muessen ueber den Pfad in FWDMAKER.CFG
gefunden werden koennen. Die Unterdateien MUESSEN den jeweiligen BOXNAMEN
haben.

Der Aufbau einer FORWARD.SYS mit Unterdateien kann in der Dokumentation zu
FBB nachgelesen werden.

Beispiel fuer eine FORWARD.SYS:

****************
* Forward-File *
*  for DR5BOX  *
****************
*
< FWD\XX1BOX
< FWD\XX2BOX
< FWD\XX3BOX
*

Der obige Aufbau zeigt dem Forward-File, dass die entsprechenden Unterda-
teien im Verzeichnis ...\FWD zu finden sind und die Namen der jeweiligen
Box haben.


9. Aufbau einer Forwarddatei fuer FWDMAKER

Wie schon erwaehnt MUESSEN fuer das korrekte Funktionieren von FWDMAKER die
einzelnen Forwards in eigene Unterdateien zur FORWARD.SYS eingerichtet sein
welche den Namen der zu forwardenen Box haben.

Beispiel fuer den Aufbau einer Unterdatei zur FORWARD.SYS (mit Kommentaren):

A XX1BOX                       (Box zu der wir forwarden wollen)
#
H XX1BOX.#XX.HES.DEU.EU
# 001 24101996
H YY1BOX.#YY.HES.DEU.EU        (H-Routen, welche entweder manuell, oder
# 005 13101996                  von FWDMAKER eingefuegt wurden, die nach-
H ZZ1BOX.#ZZ.BAY.GER.EU         folgende Kommentarzeile enthaelt die An-
# 011 01101996                  zahl Zwischenstationen auf dem Routingweg
H AA6BOX.AA.RPL.DL.EU           und das Datum an welchem die Route angelegt
# 003 05101996                  wurde, H * sollte NICHT vorkommen!)
H XYZ01A.999.NDS.DEU.EU
# 009 13101996
H *.HES.*                      (Diese H-Routen sind von der Verarbeitung
# ---                           durch FWDMAKER ausgeschlossen und somit
H *.DEU.EU                      konstant, ab V 1.3)
# ---
#
G BAY                          (Group-Zeilen fuer BULLETINS, Mails
G NDS                           adressiert an @DEU, etc. werden weiter- 
G HES                           geleitet, G * wird nicht empfohlen)  
G DEU
G EU
G WW
#
B XX1BOX                       (B-Zeile fuer PRIVATES an die Box in A-Zeile)
F XX1BOX                       (F-Zeile zur vorhergehenden B-Zeile,
F SYSOP1                        B * sollte NICHT vorkommen!)
#
IF 2-10                        (Starte FWD zwischen 2 und 10 Uhr)
P A                            (Starte FWD auf Channel A)
C C XX1BOX                     (Connecte Box aus A-Zeile)
ENDIF
#
--------------                 (Ende des Forwardfiles)

ACHTUNG! Kommentarzeilen muessen an ERSTER Stelle ein # haben.

ACHTUNG! Eine Zeile der Forwarddatei darf die Laenge von 50 Zeichen nicht
ueberschreiten. Jeder H-Zeilen MUSS eine Kommentarzeile (#) folgen welche
die Anzahl Zwischenstationen enthaelt. Die gesamte Datei darf die Laenge
von 1000 Zeilen nicht ueberschreiten. Ggf. muss die Datei manuell gekuerzt
werden.

Da FWDMAKER die kompletten H-Routen erfasst empfehle ich auf ein Routing
mit  H *.DEU.EU  oder aehnlich zu verzichten. Auch sollte die allseits
beliebte Zeile  B *  nicht vorkommen da ja dann doch wieder ALLE Mails in
die entsprechende Richtung geroutet werden. Wer dennoch Routen fest
eintragen moechte kann dies ab V 1.3 tun und die Zeilen wie oben gezeigt
vor FWDMAKER schuetzen.


10. Was kann FWDMAKER nicht?

FWDMAKER kann dem Sysop die Verantwortung fuer seine Forwardateien nicht
abnehmen. Es kann nur die Arbeit mit ihnen erleichtern. Der Sysop sollte in
regelmaessigen Abstaenden seine Forwarddateien kontrollieren.

FWDMAKER macht Fehler wenn die R:-Zeilen in den Mails nicht stimmen. Es kann
eine R:-Zeile nur eingschraenkt auf Korrektheit ueberpruefen. Insbesondere
wenn Mails, wie leider haeufig aufgetreten, verstuemmelt sind und die
R:-Zeilen nicht korrekt gelesen werden koennen.

In den meisten Faellen wird jedoch lediglich eine andere gefundene Route als
die eigentlich letzte der Mail in die Forwarddateien eingetragen (was ja
auch nicht falsch ist).


11. Noch Fragen?

Wenn jetzt noch etwas unklar sein sollte dann kontakte mich ueber:

 PR-NET  : DR5EIN@DR5BOX.#DR.HES.DEU.EU
 FIDO-NET: Stephan Klepper@2:244/1120.24
 TREK-NET: Stephan Klepper@37:106/200.4
 E-MAIL  : Stephan.Klepper@t-online.de
 HOMEPAGE: http://home.t-online.de/home/Stephan.Klepper

oder ruf an unter 06103/86401


12. Wichtige Hinweise!

FWDMAKER wurde von mir in der vorliegenden Version getestet. Die Benutzung
erfolgt auf eigenes Risiko. Es besteht keine Garantie fuer die einwandfreie
Funktion des Programms. Fuer Schaeden an Soft- oder Hardware kann keine
Haftung uebernommen werden.

FWDMAKER ist Freeware. Es duerfen ohne Einverstaendnis des Autors keine
Gebuehren fuer das Programm erhoben werden.

Das Programm und die zugehoerige Dokumentation duerfen nur komplett ohne
Veraenderungen weitergegeben werden.

Fehler und Verbesserungsvorschlaege bitte ich mir mitzuteilen.


13. Danksagungen

Ich moechte mich bei allen bedanken welche die Version 1.1 und 1.2 ein-
setzen und mir Verbesserungsvorschlaege und Kritik mitgeteilt haben.

Besonderer Dank geht an Christian (DG6FFP) fuer wichtige Tips bei der
Dokumentation und dem Beta-Test der Version 1.3.


Viel Spass mit FWDMAKER und gute connects

Stephan, Sysop der DR5BOX                           Dreieich, 24.5.1997   
   




  


