home *** CD-ROM | disk | FTP | other *** search
/ Boink! 1995 May/June / Image.bin / df_ / mailbox / point / xp_tool1.arj / ZPR.DOC < prev    next >
Text File  |  1993-10-20  |  9KB  |  223 lines
  1.  
  2.         ZPR  -  ZCONNECT-Pufferreparierer v0.93       P.Mandrella@HOT.zer.de
  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.         Bei Version 0.93 handelt es sich noch um eine Betaversion - Feedback
  14.         erwünscht. 
  15.  
  16.  
  17.         ZCONNECT ist ein eingetragenes Warenzeichen der ZERBERUS GmbH.
  18.  
  19.  
  20.  
  21.         Was ist ZPR?
  22.         ~~~~~~~~~~~~
  23.  
  24.         ZPR ist  ein  Test-  und Reparaturprogramm für ZCONNECT-Nachrichten-
  25.         Pufferdateien,  das  speziell für  Points  entwickelt wurde. ZPR ist
  26.         dazu geeignet, um
  27.  
  28.         o  defekte  Pufferdateien  formal  so  zu  reparieren, daß  sie  von
  29.            Pointprogrammen verarbeitet werden können.
  30.  
  31.         o  Puffer  auf  bestimmte  Fehler  in  Nachrichtenheadern  wie  z.B.
  32.            falsche  Datumsangaben,   falsche   Message-IDs   etc.   hin   zu
  33.            überprüfen.
  34.  
  35.  
  36.         ZPR ist NICHT dazu geeignet, um
  37.  
  38.         o  defekte  ZCONNECT-Puffer  in  einer  Mailbox  zu reparieren,  die
  39.            weiterverarbeitet  werden  sollen. ZPR stellt  zwar  die  formale
  40.            Korrektheit von Puffern  wieder her, aber  es  stellt in keinster
  41.            Weise sicher,  daß  die  erzeugten  Puffer  vollständig ZCONNECT-
  42.            konform  sind und  daß  die  erzeugten  Nachrichten den korrekten
  43.            Inhalt besitzen. Beim Beschädigen von Puffern gehen Informationen
  44.            verloren,    die     durch    einen    Pufferreparierer     nicht
  45.            wiederhergestellt werden können.
  46.  
  47.         o  die   ZCONNECT-Konformität   einer  Software   durch  Testen  der
  48.            erzeugten Puffer zu überprüfen.
  49.  
  50.  
  51.         Für  das  Verständnis  des  folgenden  Textes  ist die Kenntnis  des
  52.         ZCONNECT-Nachrichtenformates  nötig.  Eine Beschreibung von ZCONNECT
  53.         erhalten  Sie z.B. in  der BI-LINK, 05202-88888, Login DOKU, oder im
  54.         Buchhandel unter der ISBN 3-9802182-3-6 (Verlag Art d'Ameublement).
  55.  
  56.  
  57.  
  58.         Anwendung
  59.         ~~~~~~~~~
  60.  
  61.         ZPR [-fhlrwz] [-dDatei] <Quelldatei> [Zieldatei]
  62.  
  63.         Die Dateinamen  können  Laufwerks- und Pfadangaben  enthalten.  Wenn
  64.         keine  Zieldatei  angegeben  wird,  überschreibt ZPR beim Reparieren
  65.         (Parameter -r)  die  Quelldatei  mit  dem  korrigierten Puffer.  Die
  66.         Schalter können  in  beliebiger  Reihenfolge  an  beliebiger  Stelle
  67.         stehen; mehrere Schalter dürfen zusammengefaßt werden. Z.B.:
  68.  
  69.             ZPR -r PUFFER
  70.             ZPR -h PUFFER -z
  71.             ZPR EINGABE -hr AUSGABE -l
  72.  
  73.  
  74.         Die Bedeutung der einzelnen Schalter ist:
  75.  
  76.         -d  Schreibt alle fehlerhaften  Nachrichten  in  eine  eigene  Datei
  77.             unter dem umittelbar auf '-d'  folgenden Namen.  Die Nachrichten
  78.             werden unverändert kopiert. 
  79.  
  80.         -f  Protokolliert alle Fehler und Warnungen, die auch  am Bildschirm
  81.             angezeigt werden, in der Datei ZPR.LOG .
  82.  
  83.         -h  Strenge Headerzeilen-Überprüfung.  Der  Inhalt  von  Adreß-  und
  84.             Datumszeilen, Message-IDs,  Dateinamen und  Telefonnummern  wird
  85.             auf ZCONNECT-Konformität getestet.
  86.  
  87.         -l  Defekte Nachrichten werden nicht repariert, sondern entfernt.
  88.  
  89.         -r  Repariert den  Puffer  (ansonsten  wird  er  nur getestet).  Bei
  90.             Angabe  eines   Zieldateinamens  wird  Schalter  -r  automatisch
  91.             gesetzt.
  92.  
  93.         -w  Warnungen  unterdrücken. Warnungen werden bei Steuerzeichen  und
  94.             kleingeschriebenen  Adressen  erzeugt, falls  die Schalter  '-g'
  95.             bzw. '-s' nicht angegeben sind. 
  96.  
  97.         -z  Zeigt   neben   den   Fehlermeldungen   auch  den   Inhalt   der
  98.             fehlerhaften Headerzeilen an.
  99.  
  100.  
  101.         ZPR gibt folgende Errorlevel zurück:
  102.  
  103.           0 = überprüfter Puffer ist fehlerfrei
  104.           1 = Puffer ist fehlerhaft
  105.           2 = Parameter-Fehler oder Überprüfung abgebrochen
  106.  
  107.  
  108.  
  109.         Beispiele
  110.         ~~~~~~~~~
  111.  
  112.         ZPR <Datei>            überprüft eine Datei auf formale Korrektheit,
  113.                                d.h.   ob   sie   von   einem   Pointprogramm
  114.                                verarbeitet werden kann. 
  115.  
  116.         ZPR -h <Datei>         überprüft   eine   Datei   detailliert    auf
  117.                                Abweichungen   vom   ZCONNECT-Standard.  Wenn
  118.                                keine  Fehler/Warnungen   angezeigt   werden,
  119.                                bedeuet das allerdings  nicht,  daß die Datei
  120.                                100%ig ZCONNECT-konform ist. 
  121.  
  122.         ZPR <Eingabedatei> <Ausgabedatei>       repariert  die  Eingabedatei
  123.                                formal, d.h. sie  kann anschließend von einem
  124.                                Pointprogramm verarbeitet werden. 
  125.  
  126.         ZPR <Datei> -hd<Fehlerdatei>     kopiert alle  als  nicht  ZCONNECT-
  127.                                konform    erkannten   Nachrichten   in   die
  128.                                Fehlerdatei
  129.  
  130.  
  131.  
  132.         Headerzeilen
  133.         ~~~~~~~~~~~~
  134.  
  135.         Bei Fehlermeldungen  benennt ZPR die fehlerhaften Zeilen  durch ihre
  136.         ZCONNECT-Kürzel. Dies sind im Einzelnen (alle mit * gekennzeichneten
  137.         Zeilen dürfen mehrfach vorhanden sein):
  138.  
  139.           ABS               Absender
  140.         * ANTWORT-AN        Antwortadresse für PMs
  141.           BET               Betreff
  142.         * BEZ               Message-ID(s) der Bezugsnachricht(en)
  143.           CRYPT             Codierverfahren
  144.           DDA               Dateidatum
  145.         * DISKUSSION-IN     Antwortbrett für öffentliche Nachrichten
  146.         * EB                Empfangsbestätigungsanforderung
  147.           EDA               Erstellungsdatum
  148.         * EMP               Empfänger
  149.           FILE              Dateiname
  150.           LEN               Größe des Nachrichteninhalts
  151.           MID               Message-ID
  152.           O-EDA             Original-Erstellungsdatum
  153.           OAB               Originalabsender
  154.           PRIO              Priorität
  155.           ROT               Routweg
  156.           TELEFON           Telefonnummer(n) des Absenders
  157.           TRACE             Testnachricht
  158.           WAB               Weiterleit-Absender
  159.  
  160.         Alle hier nicht  aufgeführten  Headerzeilen werden von ZPR ignoriert
  161.         und bei Schalter -r unverändert in die reparierte Datei übernommen.
  162.  
  163.         ABS, BEZ,  EDA,  EMP,  LEN,  MID  und  ROT  sind  Pflichtzeilen.  Am
  164.         Vorhandensein  dieser  sieben  Zeilen  erkennt ZPR  einen  korrekten
  165.         Header.
  166.  
  167.  
  168.  
  169.         Tests
  170.         ~~~~~
  171.  
  172.         ZPR führt die folgenden Test und Reparaturen durch:
  173.  
  174.         o  Überprüfung   der  Nachrichtenlängen,  d.h.  formale  Korrektheit
  175.            des  Puffers.  Ggf.   Anpassen  von  LEN   an  die   tatsächliche
  176.            Nachrichtenlänge. 
  177.  
  178.         o  Test auf  korrekte  Zeilentrennungen  - alle Headerzeilen  müssen
  179.            mit CR+LF getrennt sein. Ggf. Ergänzen von LF oder CR.
  180.  
  181.         o  Test  auf  mehrfaches  Vorkommen  von  Zeilen,  die  nur  einfach
  182.            erlaubt sind. Ggf. Entfernen aller überflüssigen Kopien.
  183.  
  184.         o  Test auf  Vorkommen von  Headern, die  nur  in  PMs  oder in  AMs
  185.            (Brettnachrichten)   erlaubt    sind,    im    jeweils    anderen
  186.            Nachrichtentyp. Ggf. Entfernen nicht erlaubter Header. [Ich weiß,
  187.            ZCONNECT    beinhaltet   diesbezüglich   noch    keine    exakten
  188.            Vorschriften. Aber daß EB in einer AM oder DISKUSSION-IN in einer
  189.            PM  ein  Fehler  ist, sollte offensichtlich  sein].  Diese  Tests
  190.            gelten nicht für kombinierte AM/PMs.
  191.  
  192.         o  Test auf Steuerzeichen innerhalb  von  Headerzeilen, d.h. Zeichen
  193.            mit  ASCII-Wert  kleiner  32  mit  Ausnahme  von  TAB  (#9). Ggf.
  194.            Entfernnen nicht erlaubter Zeichen.
  195.  
  196.         o  Test  von Datumszeilen (EDA,  DDA,  O-EDA)  auf korrektes Format;
  197.            ggf. Korrektur.
  198.  
  199.         o  Test von  Adreßzeilen  (ABS, ANTWORT-AN,  OAB, WAB, evtl. EB) auf
  200.            (halbwegs) korrektes Format.
  201.  
  202.         o  Test von Message-IDs (MID, BEZ) auf korrektes Format.
  203.  
  204.         o  Test   von   Dateinamen   (FILE)   auf  korrektes  Format;   ggf.
  205.            Entfernen von Pfadnamen.
  206.  
  207.         o  Test von Priorität (PRIO) auf numerischen Inhalt; ggf. Setzen auf
  208.            0. 
  209.  
  210.         o  Test von Telefonnummern (TELEFON) auf korrektes Format.
  211.  
  212.  
  213.  
  214.         Versionsgeschichte
  215.         ~~~~~~~~~~~~~~~~~~
  216.  
  217.         11.08.93   0.91   erste freigegebene Vorabversion
  218.                    0.92   Ausstieg bei Steuerzeichen in unbekannter Header-
  219.                           zeile beseitigt
  220.         20.10.93   0.93   größerer Fehler bei Längenkorrektur beseitigt;
  221.                           Tippfehler korrigiert..
  222.  
  223.