home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 August / PCO0897.ISO / filesbbs / dos / cs271.arj / GENMSG92.ARJ / GENMSG.DOC next >
Encoding:
Text File  |  1995-04-20  |  15.4 KB  |  349 lines
  1.  |      Phantasoft                                                 20.4.1995
  2.  
  3.         Oliver Engel                                FIDO:  2:2410/704.14
  4.                                                     Email: engel@wad.fido.de
  5.                                                     CIS:   100120,2131
  6.  
  7.  
  8.  |      GenMSG v0.92Beta
  9.         ════════════════
  10.  
  11.  
  12.         Was macht das Programm ?
  13.         ────────────────────────
  14.         Mit CrossSecretary hat man die Moeglichkeit,  bei Auftreten  von ge-
  15.         suchten Begriffen in  einer Mail,  ein externes Programm aufzurufen.
  16.         Als Beispiel in der CS.DOC wird u.a. der Export dieser Nachricht als
  17.         MSG-Datei in das AUTOEXEC-Verzeichnis von XP aufgefuehrt.
  18.         Das Problem dabei ist  leider,  das immer nur eine  Nachricht in das
  19.         AUTOEXEC-Verzeichnis kopiert werden kann, jede weitere ueberschreibt
  20.         die vorgehende Nachricht.
  21.         GenMSG schaut im  AUTOEXEC- Verzeichnis nach,  ob die zu erstellende
  22.         MSG-Datei schon vorhanden ist,  und legt dort bei Vorhandensein eine
  23.         neue Datei mit laufender  Nummer an:  GMSG0000.MSG ... GMSG9999.MSG.
  24.         Weiterhin kann  GenMSG den Originalbetreff der Nachricht in die MSG-
  25.         Datei uebernehmen,  einen moeglichen  UseNet-Header loeschen und die
  26.         Nachricht als Textdatei in ein beliebiges Verzeichnis kopieren.
  27.  
  28.         Man kann GenMSG  gut als ReadGate verwenden,  z.B. alle  Nachrichten
  29.         eines Echos (oder Netzes)  in ein anderes Nachrichtenbrett remappen,
  30.         oder einen  ListServer in  der Art:  alle Mails von User xyz  werden
  31.         automatisch an den Empfaenger abc oder an den Verteiler [ListServer]
  32.         weitergeleitet.
  33.  
  34.         Angenommen, ein Freund macht Urlaub und bestellt seine gesamte Echo-
  35.         mail vorher ab.
  36.         Mit GenMSG koennen Sie einfach  alle ihn interessierenden Brettnach-
  37.         richten automatisch an ihn als NetMail weiterleiten lassen.
  38.  
  39.         Auch das  automatische Weiterleiten  von FileAttaches  (Dateien) ist
  40.         moeglich, wann immer ein FileAttach von User xyz ankommt, wird diese
  41.         Datei an den User abc  oder den Verteiler [FileEmpfaenger] weiterge-
  42.         leitet.
  43.  
  44.         Ausserdem kann GenMSG  Textdateien in Crosspoint verstaendliche MSG-
  45.         Dateien konvertieren.  So laesst sich relativ einfach ein Automatis-
  46.         mus erzeugen, der,  wenn eine Nachricht von  User xyz ankommt,  eine
  47.         vorher angelegte  Textdatei an den User abc oder  an einen Verteiler
  48.         verschickt.
  49.         
  50.  
  51.         Weiterleiten von FileAttaches
  52.         ─────────────────────────────
  53.         Wird von  GenMSG im Header der  Nachricht (KOPF.TMP) das FileAttach-
  54.         Flag ("X-XP-ATT: __1_"-Zeile) gefunden,  und der Parameter -nf wurde
  55.         nicht angegeben, generiert GenMSG eine FileAttach-Nachricht.
  56.         Dazu wird im unter  SET XP=pfadname gesetztem  Verzeichnis die Datei
  57.         FIDO.CFG nach  der Zeile  Inpath=verzeichnisname durchsucht.  Dieser
  58.         Eintrag enthaelt das unter Config/Pfade/FileReq angegebene Verzeich-
  59.         nis, also das, in dem alle ankommenden Dateien abgelegt werden.
  60.         Der Eintrag, den GenMSG automatisch im MSG-File taetigt lautet dann:
  61.  
  62.         Datei: filereq-verzeichnis+dateiname.
  63.  
  64.         Zu beachten ist, das FileAttaches im FIDO nur bei privaten Nachrich-
  65.         ten moeglich sind.
  66.  
  67.  
  68.         Installation
  69.         ────────────
  70.         Um die Weiterleite-Funktion auch fuer FileAttaches nutzen zu koennen
  71.         ist die Aufnahme des XP-Haupt-Verzeichnisses in das Environment noe-
  72.         tig.
  73.  
  74.         GenMSG erkennt folgende SET-Eintraege:
  75.  
  76.         SET XP=pfadname
  77.         SET XPOINT=pfadname 
  78.         SET CROSSPOINT=verzeichnis
  79.  
  80.         Das AUTOEXEC- Verzeichnis von CrossPoint wird immer beim Start abge-
  81.         arbeitet. Die von GenMSG erzeugten Nachrichten werden also erst beim
  82.         naechsten Start von XP abgesandt.
  83.         Man kann  sich aber auch das Abarbeiten  des AUTOEXEC-Verzeichnisses
  84.         im XP auf eine Taste legen:
  85.  
  86.               ┌─ Ctrl-F10 ────────────────────────────────────────────┐
  87.               │                                                       │
  88.               │  Menüanzeige                                          │
  89.               │                                                       │
  90.               │  Programmname   *                                     │
  91.               │                                                       │
  92.               │  $FILE-Nachr.   ohne Kopf          [ ]   aus Betreff  │
  93.               │                                                       │
  94.               │   [ ]   Warten                                        │
  95.               │   [ ]   Vollbild              Speicher:   500  KByte  │
  96.               │   [ ]   Ausgabe an Lister                             │
  97.               │   [x]   AUTOEXEC-Verzeichnis bearbeiten               │
  98.               │                                                       │
  99.               └───────────────────────────────────────────────────────┘
  100.  
  101.         Weiteres  zum Belegen  einer Taste  finden sie  im  Kapitel 5.4  der
  102.         XPOINT.DOC.
  103.  
  104.  
  105.         Aufruf
  106.         ──────
  107.         GENMSG -bBETREFF -eEMPFAENGER [-oVERZEICHNIS -sSERVER -iINFILE]
  108.  |                                    [-nh -nw -nf -nl -ns -txt -zer -a -tcf]
  109.   
  110.          -b   =  Betreff der Nachricht (@BET = Originalbetreff)
  111.          -e   =  z.B. /FIDO/TEST.GER oder name@kiste.domain oder [Verteiler]
  112.          -o   =  Ausgabeverzeichnis fuer GMSGnnnn.MSG
  113.          -s   =  Servername z.B. 2:2410/704
  114.          -i   =  Dateiname des zu versendenden Nachrichtentextes
  115.          -nh  =  UseNet-Header innerhalb der Mail wird unterdrueckt
  116.          -nw  =  Weiterleite-Text wird unterdrueckt
  117.          -nf  =  FileAttach wird unterdrueckt
  118.          -nl  =  Aktivitaeten werden nicht in GENMSG.LOG gespeichert
  119.          -ns  =  GenMSG-StatusMail wird unterdrueckt
  120.          -txt =  Ausgabe als Textdatei (zur Weiterverarbeitung)
  121.          -zer =  Ausgabe als ZCONNECT-Nachrichtenpuffer
  122.          -a   =  Append-Modus fuer -txt und -zer
  123.  |       -tcf =  TCFilter-Support
  124.  
  125.         -b
  126.         Moechte man  den Betreff der Originalnachricht mit  in die MSG-Datei
  127.         uebernehmen , kann als  Parameter  -bBETREFF  ein -b@BET eingetragen
  128.         werden.
  129.         Es ist zu beachten, dass nur @BET  in Grossschreibung erkannt wird !
  130.         Ein aus mehreren Worten bestehender Betreff kann durch Einschluss in
  131.         Anfuehrungszeichen realisiert werden: -b"Das ist ein Betreff !"
  132.  |      Wird -b nicht angegeben,  setzt GenMSG standardmaessig den Original-
  133.  |      betreff ein.
  134.  
  135.         -e
  136.         Als Empfaenger  fuer die Nachricht  kann ein Echoname,  ein Username
  137.         (mit Adresse) und ein Verteiler angegeben werden. Auch hier kann mit
  138.         Anfuehrungszeichen ein Empfaenger angegeben werden,  der Leerzeichen
  139.         enthaelt: -e"Oliver Engel@2:2410/704.14".
  140.  |      Fehlt der Parameter -e, wird der Originalempfaenger benutzt.
  141.  
  142.         -o
  143.         In dem dort angegebenen Verzeichnis werden die von GenMSG erstellten
  144.  |      Dateien abgelegt.
  145.         Wird dieser Parameter nicht angegeben, werden die MSG-Dateien stand-
  146.         ardmaessig im aktuellen Verzeichnis erstellt.
  147.         Hier kann auch PRN, LPT1, LPT2, COM1 und COM2 angegeben werden,  die
  148.         Ausgabe erfolgt dann auf dem jeweiligen Geraet.
  149.  
  150.         -s
  151.         Hier kann der Servername angegeben werden.  Wird kein Server angege-
  152.         ben, setzt XP automatisch die Stammbox ein.  Je nach Server wird der
  153.         Absendername und die -adresse von XP bestimmt.
  154.  
  155.         -i
  156.         Die angegebene Datei wird anstatt der CSOUT.TMP verschickt.  Das ist
  157.         vorallem  interessant,  wenn bei Auftreten eines  gesuchten Begriffs
  158.         eine Nachricht mit beliebigen Nachrichtentext versendet werden soll.
  159.         Wird der -i nicht angegeben, wird die Nachricht immer mit dem  Nach-
  160.         richtentext der Datei CSOUT.TMP erstellt.
  161.  |      Dieser Modus  ist bei  der Erstellung von  Nachrichtenpuffern (-zer)
  162.  |      nicht moeglich.
  163.  
  164.         -nh
  165.         Bei gegateteten UseNet-Nachrichten steht der Original-UUCP-Header am
  166.         Anfang jeder Mail. Dieser ist durch eine  Leerzeile vom eigentlichen
  167.         Nachrichtentext getrennt.
  168.         Wird dieser Parameter angegeben,  schreibt GenMSG die Nachricht erst
  169.         nach dieser Leerzeile in die MSG-Datei.
  170.  
  171.         -nw
  172.         Standardmaessig setzt GenMSG in jede MSG-Datei einen Text:
  173.  
  174.  |      *automatisch durch GenMSG v0.92 weitergeleitete Nachricht*
  175.         Originalabsender:   originalabsender@adresse
  176.         Originalempfaenger: originalempfaenger@adresse
  177.  
  178.         Durch Angabe dieses  Parameters wird dieser Weiterleite-Text  unter-
  179.         drueckt.  Bei Erstellung von  Textnachrichten (-txt)  oder ZCONNECT-
  180.         Puffern (-zer) wird der Weiterleitetext generell unterdrueckt.
  181.  
  182.         -nf
  183.         Handelt sich die Ursprungsnachricht um einen FileAttach,  wird stan-
  184.         dardmaessig auch diese Datei weitergeleitet.
  185.         Wird  dieser Parameter angegeben,  wird  zwar  der  Nachrichtentext,
  186.         jedoch nicht die angehaengte Datei weitergeleitet.
  187.  
  188.         -nl
  189.         Mit diesem Schalter laesst sich die Erstellung einer GenMSG-Logdatei
  190.         (GENMSG.LOG) im XP-Log-Verzeichnis unterbinden.
  191.   
  192.         -ns
  193.         Bei jedem Aufruf erstellt GenMSG im Brett /»GenMSG  eine Statusnach-
  194.         richt,  in der saemtliche GenMSG- Aktionen aufgefuehrt sind.  Dieser
  195.         Parameter deaktiviert die StatusMail-Funktion.
  196.   
  197.         -txt
  198.         Standardmaessig erzeugt GenMSG sogenannte .MSG-Dateien, die durch XP
  199.         automatisch in ZCONNECT-Nachrichten konvertiert werden,  sofern sich
  200.         diese im AUTOEXEC-Verzeichnis von XP befinden.
  201.         Dazu setzt GenMSG den Empfaengernamen, den Betreff, den Server (wenn
  202.         -s angegeben) und,  wenn es sich um eine  Nachricht mit angehaengtem
  203.         File handelt und der  Parameter -nf fehlt,  eine Zeile 
  204.   
  205.         Datei: dateiname
  206.   
  207.         an den Anfang der MSG-Datei:
  208.   
  209.         Empfaenger: Oliver Engel@2:2410/704.14
  210.         Betreff: Das ist ein Betreff !
  211.         Datei: C:\XP\FILES\TESTFILE.ZIP
  212.         Server: 2:2410/704
  213.   
  214.         [Nachrichtentext]
  215.   
  216.         Durch Angabe von Parameter -txt wird dieser Nachrichtenheader unter-
  217.         drueckt,  nur der Nachrichtentext steht in der erstellten Datei.  So
  218.         kann der Nachrichtentext  als Textdatei zur  Weiterverarbeitung fuer
  219.         ein Programm (z.B. Ausgabe auf Drucker)  in dem unter -o angegebenen
  220.         Verzeichnis abgelegt werden.
  221.         Die mit diesem Parameter erstellten Nachrichten  erhalten die Datei-
  222.         endung .TXT.
  223.   
  224.         -zer
  225.         Wird -zer als Parameter angegeben,  enthaelt die erstellte Datei den
  226.         kompletten  Nachrichtenkopf,  so wie er in der Datei  FPUFFER steht.
  227.         Die von GenMSG  erstellten Nachrichten erhalten die Endung .ZER,  so
  228.         das diese  Puffer nachtraeglich in XP eingelesen oder von ZQWKPro in
  229.         ein QWK-Paket konvertiert werden koennen.
  230.  |      Ein Aendern des Betreffs oder des Empfaengernamens ist in diesem Mo-
  231.  |      dus nicht moeglich.
  232.  
  233.  |      -a
  234.  |      Append-Modus fuer die Verarbeitung bei -txt und -zer.  Normalerweise
  235.  |      werden die von GenMSG erstellten Nachrichten von  0 bis  9999 durch-
  236.  |      nummeriert.  Im Append-Modus  wird nur die Datei GMSG0000.ZER (.TXT)
  237.  |      erstellt. Alle weiteren Nachrichten werden an diese angehaengt.
  238.         
  239.  |      -tcf
  240.  |      Standardmaessig bearbeitet GenMSG die  von CrossSecretary erstellten
  241.  |      temporaeren Dateien KOPF.TMP, CSOUT.TMP und CSPUFFER.TMP. Dieser Pa-
  242.  |      rameter weist  GenMSG an,  nach den von TCFilter  erstellten Dateien
  243.  |      HEADER.FIL und MAIL.FIL zu suchen und diese zu verarbeiten.
  244.  
  245.  
  246.         Einbindung in die FILTER.TXT von CS v2.30
  247.         ─────────────────────────────────────────
  248.         Beispiel 1:
  249.         Alle an Oliver Engel adressierten NetMail mit dem  Absender GermNews
  250.         sollen durch GenMSG ohne UseNet-Header, mit Weiterleitetext und Ori-
  251.         ginal-Betreff, als Nachricht in das Brett /FIDO/704.GermNews weiter-
  252.         geleitet werden:
  253.  
  254.         [FILTER.TXT]
  255.         ---Oliver Engel
  256.         germnews Ωne »tools\germnews.bat
  257.  
  258.         [GERMNEWS.BAT]
  259.         c:\xp\tools\genmsg.exe -b@BET -e/FIDO/704.GERMNEWS -oc:\xp\autoexec
  260.                                -nh
  261.  
  262.         Beispiel 2:
  263.         Alle Nachrichten  von Harry van Leuken im Brett /FIDO/MOVIE.GER sol-
  264.         len als NetMail an die Empfaenger im Verteiler [HvL-FilmKritik] ver-
  265.         schickt werden.
  266.  
  267.         [FILTER.TXT]
  268.         ---/FIDO/MOVIE.GER
  269.         harry van Ωlne »tools\hvl.bat
  270.  
  271.         [HVL.BAT]
  272.         c:\xp\tools\genmsg.exe -b@BET -e[HvL-Filmkritik] -oc:\xp\autoexec
  273.  
  274.         Beispiel 3:
  275.         Alle Nachrichten der Brettebene /COMPUSERVE/ sollen ohne Weiterleit-
  276.         text und ohne UseNet-Header in das lokale FIDO-Echo  /FIDO/lokal.CIS
  277.         verschickt werden.
  278.  
  279.         [FILTER.TXT]
  280.         ---/COMPUSERVE
  281.         @ Ωne »tools\cis_map.bat
  282.  
  283.         [CIS_MAP.BAT]
  284.         c:\xp\tools\genmsg.exe -b@BET -e/FIDO/lokal.CIS -oc:\xp\autoexec -nw
  285.                                -nh
  286.  
  287.         Beispiel 4:
  288.         Alle Nachrichten, die "Blitzplan" im Betreff enthalten, sollen auto-
  289.         matisch bei Empfang als Text ausgedruckt werden.
  290.  
  291.         [FILTER.TXT]
  292.         ---ALLE
  293.         blitzplan Ωse »c:\xp\tools\genmsg.exe -nm -oPRN
  294.  
  295.  
  296.         Beispiel 5:
  297.         Wenn in einer Nachricht des Brettes  /FIDO/704.SYSINFO der Nachrich-
  298.         tentext "Neues Echo angelegt"  gefunden wird,  soll eine neue Brett-
  299.         liste bei AreaFix bestellt werden.
  300.   
  301.         [FILTER.TXT]
  302.         ---/FIDO/704.SYSINFO
  303.         neues echo angelegt Ωvec »tools\arealist
  304.   
  305.         [AREALIST.BAT]
  306.         c:\xp\tools\genmsg.exe -bPASSWORT -iC:\XP\SEND\LIST.TXT -nw 
  307.                                -e"AreaFix@2:2410/704" -oC:\XP\AUTOEXEC
  308.   
  309.         [LIST.TXT]
  310.         %LIST
  311.         ---
  312.         
  313.  
  314.         Fehlermeldungen
  315.         ───────────────
  316.         Bei Auftreten  eines Fehlers wird die Fehlerursache  auf dem Monitor
  317.         ausgegeben und  GenMSG mit einem Errorlevel beendet.
  318.   
  319.         Folgende Errorlevel und Fehlermeldungen koennen auftreten:
  320.   
  321.         0    Programm ordnungsgemaess beendet - keine Fehler
  322.         1    Hilfeschirm angefordert
  323.         2    Eingabedatei dateiname nicht gefunden !
  324.         5    Ausgabeverzeichnis nicht gefunden, Datei nicht angelegt !
  325.         6    Dateien CSOUT.TMP und KOPF.TMP nicht vorhanden !
  326.         7    Datei KOPF.TMP nicht gefunden !
  327.         8    Datei CSOUT.TMP nicht gefunden !
  328.         
  329.         Fehlermeldungen werden im  LOG-Verzeichnis von CrossPoint in der Da-
  330.         dei GENMSG.LOG protokolliert.
  331.  
  332.  
  333.         Debug-Modus
  334.         ───────────
  335.         Wird GenMSG mit gedrueckter "ROLLEN"-Taste (die zwischen "Druck" und
  336.         "Pause" ;-))  gestartet,  arbeitet das Programm im Debug-Modus.  Das
  337.         Programm wartet nach Beendung 10 Sekunden.  Genug Zeit also,  um die
  338.         angezeigten Parameter zu ueberpruefen.
  339.         Diese Warteschleife kann selbstverstaendlich durch einen Tastendruck
  340.         vorzeitig beendet werden.
  341.  
  342.  
  343.         sonstige Bemerkungen
  344.         ────────────────────
  345.         Zum besseren  Verstaendnis von  GenMSG sollte man unbedingt  Kapitel
  346.         7.6 der  XPOINT.DOC  und die Dokumentation zu CrossSecretary lesen !
  347.  
  348.         GenMSG ist in der vorliegenden Version Freeware.
  349.