home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 October / PCO_10.ISO / filesbbs / zpr109.arj / ZPR.DOC < prev    next >
Encoding:
Text File  |  1996-07-19  |  11.2 KB  |  263 lines
  1.  
  2.         ZPR  -  ZCONNECT-Pufferreparierer v1.09
  3.         ---------------------------------------
  4.  
  5.  
  6.         ZPR  ist Freeware. Sie dürfen dieses Programm beliebig einsetzen und
  7.         weiterverbreiten,   unter  der  Voraussetzung,  daß   es  (a)  nicht
  8.         modifiziert wird und  (b)  die Weitergabe unentgeltlich erfolgt. Ich
  9.         kann  weder  garantieren, daß ZPR korrekt  arbeitet oder irgendeinen
  10.         bestimmten Zweck  erfüllt, noch übernehme ich  die Verantwortung für
  11.         evtl. durch den Einsatz von ZPR verursachte Schäden. 
  12.  
  13.         Die jeweils  neueste Version von  ZPR finden  Sie in der CrossPoint-
  14.         Supportbox,  02672-910152  (Modem)  oder  02672-910156 (ISDN), Login
  15.         GAST, und im Internet unter http://ttrip.worms.fh-rpl.de/xp/bin.
  16.  
  17.  
  18.         (c) 1994-96 Peter Mandrella, pm@daisy.de
  19.  
  20.         ZCONNECT ist ein eingetragenes Warenzeichen der ZERBERUS GmbH.
  21.  
  22.  
  23.  
  24.         Was ist ZPR?
  25.         ~~~~~~~~~~~~
  26.  
  27.         ZPR  ist  ein Test- und Reparaturprogramm für  ZCONNECT-Nachrichten-
  28.         Pufferdateien,  das  speziell  für Points  entwickelt wurde. ZPR ist
  29.         dazu geeignet, um
  30.  
  31.         o  defekte  Pufferdateien  formal  so  zu  reparieren,  daß  sie von
  32.            Pointprogrammen verarbeitet werden können.
  33.  
  34.         o  Puffer  auf  bestimmte  Fehler  in  Nachrichtenheadern  wie  z.B.
  35.            falsche   Datumsangaben,   falsche   Message-IDs   etc.  hin   zu
  36.            überprüfen.
  37.  
  38.  
  39.         ZPR ist NICHT dazu geeignet, um
  40.  
  41.         o  defekte  ZCONNECT-Puffer  in  einer Mailbox  zu  reparieren,  die
  42.            weiterverarbeitet werden  sollen. ZPR  stellt  zwar  die  formale
  43.            Korrektheit von Puffern wieder her,  aber  es stellt  in keinster
  44.            Weise  sicher, daß  die  erzeugten  Puffer  vollständig ZCONNECT-
  45.            konform  sind und  daß  die  erzeugten  Nachrichten den korrekten
  46.            Inhalt besitzen. Beim Beschädigen von Puffern gehen Informationen
  47.            verloren,    die     durch    einen    Pufferreparierer     nicht
  48.            wiederhergestellt werden können.
  49.  
  50.         o  die   ZCONNECT-Konformität   einer  Software   durch  Testen  der
  51.            erzeugten Puffer zu überprüfen.
  52.  
  53.  
  54.         Für  das  Verständnis  des  folgenden  Textes  ist die Kenntnis  des
  55.         ZCONNECT-Nachrichtenformates  nötig.  Eine Beschreibung von ZCONNECT
  56.         erhalten Sie z.B.  in der CrossPoint-Supportbox, 06241-592184, Login
  57.         GAST, oder im Buchhandel unter  der ISBN  3-9802182-3-6  (Verlag Art
  58.         d'Ameublement).
  59.  
  60.  
  61.  
  62.         Anwendung
  63.         ~~~~~~~~~
  64.  
  65.         ZPR [-fhlrwz] [-dDatei] <Quelldatei> [Zieldatei]
  66.  
  67.         Die Dateinamen  können  Laufwerks-  und Pfadangaben  enthalten. Wenn
  68.         keine  Zieldatei  angegeben  wird, überschreibt ZPR  beim Reparieren
  69.         (Parameter -r)  die  Quelldatei  mit  dem  korrigierten Puffer.  Die
  70.         Schalter können  in  beliebiger  Reihenfolge  an  beliebiger  Stelle
  71.         stehen; mehrere Schalter dürfen zusammengefaßt werden. Z.B.:
  72.  
  73.             ZPR -r PUFFER
  74.             ZPR -h PUFFER -z
  75.             ZPR EINGABE -hr AUSGABE -l
  76.  
  77.  
  78.         Die Bedeutung der einzelnen Schalter ist:
  79.  
  80.         -d  Schreibt alle  fehlerhaften  Nachrichten  in  eine eigene  Datei
  81.             unter  dem umittelbar auf  '-d' folgenden Namen. Die Nachrichten
  82.             werden unverändert kopiert. 
  83.  
  84.         -f  Protokolliert  alle Fehler und Warnungen, die auch am Bildschirm
  85.             angezeigt werden, in der Datei ZPR.LOG.
  86.  
  87.         -h  Strenge  Headerzeilen-Überprüfung.  Der Inhalt  von  Adreß-  und
  88.             Datumszeilen, Message-IDs,  Dateinamen und  Telefonnummern  wird
  89.             auf ZCONNECT-Konformität getestet.
  90.  
  91.         -l  Defekte Nachrichten werden nicht repariert, sondern entfernt.
  92.  
  93.         -r  Repariert  den  Puffer  (ansonsten  wird er  nur getestet).  Bei
  94.             Angabe  eines   Zieldateinamens  wird  Schalter  -r  automatisch
  95.             gesetzt.
  96.  
  97.         -w  Warnungen  unterdrücken.  Warnungen werden bei Steuerzeichen  in
  98.             Headerzeilen und bei Fehlern  in Adreß-, Datums und  Message-ID-
  99.             Zeilen angezeigt, falls der Schalter "-h" nicht angegeben ist.
  100.  
  101.         -z  Zeigt   neben  den   Fehlermeldungen   auch   den   Inhalt   der
  102.             fehlerhaften Headerzeilen an.
  103.  
  104.  
  105.         ZPR gibt folgende Errorlevel zurück:
  106.  
  107.           0 = überprüfter Puffer ist fehlerfrei
  108.           1 = Puffer ist fehlerhaft
  109.           2 = Parameter-Fehler oder Überprüfung abgebrochen
  110.  
  111.  
  112.  
  113.         Beispiele
  114.         ~~~~~~~~~
  115.  
  116.         ZPR <Datei>            überprüft eine Datei auf formale Korrektheit,
  117.                                d.h.   ob   sie   von   einem   Pointprogramm
  118.                                verarbeitet werden kann. 
  119.  
  120.         ZPR -h <Datei>         überprüft   eine   Datei   detailliert    auf
  121.                                Abweichungen   vom   ZCONNECT-Standard.  Wenn
  122.                                keine  Fehler/Warnungen   angezeigt   werden,
  123.                                bedeuet das allerdings  nicht,  daß die Datei
  124.                                100%ig ZCONNECT-konform ist. 
  125.  
  126.         ZPR <Eingabedatei> <Ausgabedatei>       repariert  die  Eingabedatei
  127.                                formal, d.h. sie  kann anschließend von einem
  128.                                Pointprogramm verarbeitet werden. 
  129.  
  130.         ZPR <Datei> -hd<Fehlerdatei>     kopiert alle  als  nicht  ZCONNECT-
  131.                                konform    erkannten   Nachrichten   in   die
  132.                                Fehlerdatei
  133.  
  134.  
  135.  
  136.         Headerzeilen
  137.         ~~~~~~~~~~~~
  138.  
  139.         Bei Fehlermeldungen  benennt ZPR die fehlerhaften Zeilen  durch ihre
  140.         ZCONNECT-Kürzel. Dies sind im Einzelnen (alle mit * gekennzeichneten
  141.         Zeilen dürfen mehrfach vorhanden sein):
  142.  
  143.           ABS               Absender
  144.         * ANTWORT-AN        Antwortadresse für PMs
  145.           BET               Betreff
  146.         * BEZ               Message-ID(s) der Bezugsnachricht(en)
  147.           CRYPT             Codierverfahren
  148.           DDA               Dateidatum
  149.         * DISKUSSION-IN     Antwortbrett für öffentliche Nachrichten
  150.         * EB                Empfangsbestätigungsanforderung
  151.           EDA               Erstellungsdatum
  152.         * EMP               Empfänger
  153.           FILE              Dateiname
  154.           KOM               Kommentarlänge
  155.         * KOP               Kopienempfänger
  156.           LEN               Größe des Nachrichteninhalts
  157.           MID               Message-ID
  158.           O-EDA             Original-Erstellungsdatum
  159.           OAB               Originalabsender
  160.         * OEM               Originalempfänger
  161.           PRIO              Priorität
  162.           ROT               Routweg
  163.           TELEFON           Telefonnummer(n) des Absenders
  164.           TRACE             Testnachricht
  165.         * VER               Vertreteradresse
  166.           WAB               Weiterleit-Absender
  167.  
  168.         Alle hier nicht  aufgeführten  Headerzeilen werden von ZPR ignoriert
  169.         und bei Schalter -r unverändert in die reparierte Datei übernommen.
  170.  
  171.         ABS, BEZ,  EDA,  EMP,  LEN,  MID  und  ROT  sind  Pflichtzeilen.  Am
  172.         Vorhandensein  dieser  sieben  Zeilen  erkennt  ZPR  einen  gültigen
  173.         Header.
  174.  
  175.  
  176.  
  177.         Tests
  178.         ~~~~~
  179.  
  180.         ZPR führt die folgenden Test und Reparaturen durch:
  181.  
  182.         o  Überprüfung  der  Nachrichtenlängen,   d.h.  formale  Korrektheit
  183.            des   Puffers.  Ggf.   Anpassen  von  LEN  an   die  tatsächliche
  184.            Nachrichtenlänge. 
  185.  
  186.         o  Test auf  korrekte Zeilentrennungen  - alle  Headerzeilen  müssen
  187.            mit CR+LF getrennt sein. Ggf. Ergänzen von LF oder CR.
  188.  
  189.         o  Test  der  Headernamen   auf   syntaktische   Korrektheit.   Ggf.
  190.            Entfernen fehlerhafter Headerzeilen.
  191.  
  192.         o  Test  auf  mehrfaches  Vorkommen  von  Zeilen,  die  nur  einfach
  193.            erlaubt sind. Ggf. Entfernen aller unerlaubten Kopien.
  194.  
  195.         o  Test auf  Vorkommen  von  Headern,  die nur in  PMs oder  in  AMs
  196.            (Brettnachrichten)   erlaubt    sind,    im    jeweils    anderen
  197.            Nachrichtentyp. Ggf. Entfernen nicht erlaubter Header. [Ich weiß,
  198.            ZCONNECT  beinhaltet  diesbezüglich  keine exakten  Vorschriften.
  199.            Aber daß EB in einer AM oder DISKUSSION-IN in einer PM ein Fehler
  200.            ist, sollte  offensichtlich sein]. Diese  Tests  gelten nicht für
  201.            kombinierte AM/PMs. 
  202.  
  203.         o  Test  auf Steuerzeichen innerhalb  von Headerzeilen, d.h. Zeichen
  204.            mit ASCII-Wert  kleiner  32  mit  Ausnahme  von  TAB  (#9).  Ggf.
  205.            Entfernnen nicht erlaubter Zeichen.
  206.  
  207.         o  Test  von Datumszeilen (EDA, DDA,  O-EDA) auf  korrektes  Format;
  208.            ggf. Korrektur.
  209.  
  210.         o  Test von  Adreßzeilen (ABS, ANTWORT-AN, OAB, WAB, VER, evtl. EMP,
  211.            EB, KOP und OEM) auf (halbwegs) korrektes Format.
  212.  
  213.         o  Test  von  Brettnamen  (EMP,  OEM,  DISKUSSION-IN) auf  korrektes
  214.            Format. 
  215.  
  216.         o  Test von Message-IDs (MID) auf korrektes Format.
  217.  
  218.         o  Test  der  Kommentarlänge  (KOM)  auf  korrektes Format  und  auf
  219.            Plausibilität. 
  220.  
  221.         o  Test   von  Dateinamen   (FILE)   auf   korrektes  Format;   ggf.
  222.            Entfernen von Pfadnamen.
  223.  
  224.         o  Test von Priorität (PRIO) auf numerischen Inhalt; ggf. Setzen auf
  225.            0. 
  226.  
  227.         o  Test von Telefonnummern (TELEFON) auf korrektes Format.
  228.  
  229.  
  230.  
  231.         Versionsgeschichte
  232.         ~~~~~~~~~~~~~~~~~~
  233.  
  234.         11.08.93   0.91   erste freigegebene Vorabversion
  235.                    0.92   Ausstieg bei Steuerzeichen in unbekannter Header-
  236.                           zeile beseitigt
  237.         20.10.93   0.93   größerer Fehler bei Längenkorrektur beseitigt;
  238.                           Tippfehler korrigiert..
  239.         05.11.93   1.0    noch ein paar Bugs bei der Suche nach gültigen
  240.                           Headern beseitigt
  241.         28.11.93   1.01   Syntaxüberprüfung der LEN-Zeile hinzugefügt
  242.                           Adreßüberprüfung funktioniert jetzt auch bei von
  243.                           XP konvertierten RFC-Puffern
  244.                           Syntaxüberprüfung von BEZ entfernt
  245.         15.12.93   1.02   zu viele Leerzeichen vor Realname werden erkannt
  246.         04.02.94   1.03   Fehler bei Headersuche (RTE 201) beseitigt
  247.         05.12.94   1.04   Leerzeichen vor Headerzeilen werden entfernt
  248.                           Ungültige Headernamen werden erkannt
  249.                           Fehler bei Headerlängenkorrektur behoben
  250.                           lange Headerzeilen werden beim Reparieren nicht
  251.                           mehr gekürzt
  252.         15.01.95   1.05   Syntaxüberprüfung von EMP, OEM und DISKUSSION-IN
  253.                           hinzugefügt
  254.                           OS/2-Version
  255.         05.06.95   1.06   weniger strenge Überprüfung von Brettnamen
  256.         07.06.95   1.07   Fehler bei Puffern > 20,5 MB behoben
  257.         19.06.95   1.08   Fehler bei mehrfachem LEN behoben
  258.                           Überprüfung von TELEFON an ZCONNECT 3.1 angepaßt
  259.                           Überprüfung von KOM, KOP und VER hinzugefügt
  260.         16.07.96   1.09   Header, die mit einem Doppelpunkt beginnen, werden
  261.                           als fehlerhaft erkannt
  262.  
  263.