home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1177 / pswsortf.doc < prev    next >
Encoding:
Text File  |  1993-10-04  |  16.3 KB  |  446 lines
  1.         +-----------------+
  2.         |   PSWSORT 2.2   |
  3.         +-----------------+
  4.  
  5.         Beschreibung und Bedienungsanleitung
  6.         -> der registrierten Vollversion
  7.  
  8.         Copyright   c  1990-1992
  9.  
  10.         Profi-Software Theo Saleck
  11.  
  12.         Langhecker Weg 13
  13.  
  14.         D-65618 Selters-Münster
  15.  
  16.         Telefon: 06483/3541
  17.  
  18.         Das Programm PSWSORT und diese Beschreibung sind
  19.         urheberrechtlich geschützt. Ein Kopieren bzw. die
  20.         Vervielfältigung der Beschreibung sind nicht erlaubt und
  21.         können rechtliche Folgen nach sich ziehen.
  22.  
  23.         Das durch die Registrierung erworbene Nutzungsrecht
  24.         berechtigt nur zur Benutzung mit einem Computer bzw. bei
  25.         Servern an einem Bildschirm. Ein Kopieren des Programms zum
  26.         Zwecke der Sicherung ist erlaubt.
  27.  
  28.         Für den Einsatz auf mehreren Computern oder in Netzwerken
  29.         sind auf Anfrage Mehrfach-Lizenzen erhältlich. Eine
  30.         weitergehende Nutzung bedarf der vorherigen Genehmigung.
  31.  
  32.  
  33. 8.      Beschreibung der Protokollierung
  34. ----------------------------------------
  35.  
  36. 8.1     Ablaufprotokoll
  37. -----------------------
  38.  
  39.         PSWSORT erstellt ein Ablaufprotokoll, aus dem der Anwender
  40.         die eingegebenen Programmparameter, die Sortiergrößen, die
  41.         Sortierzeiten und ggf. die Fehler ersehen kann. Das
  42.         Protokoll sieht im Detail folgendermaßen aus:
  43.  
  44.         Beispiel eines Ablaufprotokolls:
  45.  
  46.         (Weitere Beispiele und Erläuterungen hierzu enthalten die
  47.         zum Lieferumfang gehörenden Muster-Dateien)
  48.  
  49.         PswSort / Standard-Sortierprogramm V2.2   92-06-10 21:01:18
  50.         (c) Copyright by Profi-Software Theo Saleck 1990-1992
  51.         => lizenziert als Shareware-Version für Prüfläufe
  52.  
  53.     Parameterprotokollierung:
  54.  
  55.         ===> Parameter- und Fehlerauflistung
  56.         SORTPROT=ASCBSP1.PRT
  57.         SORTCORE=0
  58.         SORTIN=FILM.ASC,ASC,VAR
  59.         SORTFORM= ***> Parameter nicht vorhanden <***
  60.         SORTOUT=FILM.TXT
  61.         SORTWORK= ***> Parameter nicht vorhanden <***
  62.         SORTFIELDS=TEXT,1,50
  63.         ===> Parameter fehlerfrei
  64.  
  65.     Ablaufprotokoll:
  66.  
  67.         92-04-22 21:01:18 Beginn der Eingabe
  68.                  Eingabe ordnungsgemäß abgeschlossen:      56 Sätze
  69.         92-04-22 21:01:18 Beginn der Sortierung
  70.         92-04-22 21:01:18 Ende der Sortierung
  71.         92-04-22 21:01:19 Ausgabe ordnungsgemäß abgeschlossen
  72.                  verwendeter Hauptspeicher in Bytes:         512960
  73.                  interne Tabellengröße in Tabellengliedern:   16384
  74.  
  75.     Ablaufdiagnose:
  76.  
  77.                  Sortierung ordnungsgemäß durchgeführt
  78.         ===========================================================
  79.  
  80.  
  81.  
  82. 8.2 Fehlermeldungen im Ablaufprotokoll
  83. --------------------------------------
  84.  
  85.         Enthalten die Programmparameter Fehler oder treten Fehler
  86.         während des Ablaufs auf, werden diese im Ablaufprotokoll
  87.         ausgewiesen:
  88.  
  89.  
  90.  
  91. 8.2.1 Parameterprotokollierung
  92. ------------------------------
  93.  
  94.         In der Parameterprotokollierung sind die folgenden Meldungen
  95.         möglich:
  96.  
  97.         **** Fehler bei SORTPROT-Parameter (Protokollausgabe)
  98.         **** Protokoll wird über Terminal ausgegeben
  99.  
  100.              s. Beschreibung in 8.3 .
  101.  
  102.         x = Name des Programmparameters
  103.         c = Text des Programmparameters
  104.  
  105.         xxxxxxxx= ***> Parameter nicht vorhanden <***
  106.                 Dies ist eine Warnung, die anzeigt, daß ein
  107.                 Programmparameter nicht angegeben wurde. Hierbei ist aber
  108.                 das Fehlen zulässig und es wird ggf. ein Default-Wert
  109.                 angenommen.
  110.  
  111.         xxxxxxxx= ***> Parameter nicht vorhanden, Fehler <***
  112.                 Das Fehlen eines Programmparameters führt zu einem
  113.                 Fehlerabbruch.
  114.  
  115.         xxxxxxxx= ***> Parameter zu lang, Fehler <***
  116.                 Der Programmparameter insgesamt überschreitet die zulässige
  117.                 Länge. Dies führt zu einem Fehlerabbruch.
  118.  
  119.         xxxxxxxx= cccccccccccccccccccccccccc
  120.                 Ein einzelner Detailparameter des angegebenen
  121.                 Programmparameters ist fehlerhaft. Die Konkretisierung
  122.                 erfolgt in der nächsten Zeile. Es führt zu einem
  123.                 Fehlerabbruch.
  124.  
  125.                 Nach dem Text
  126.                 ****Fehler> Parameter Nr. n ....
  127.                 sind folgende Fehlermeldungen möglich:
  128.  
  129.                 fehlerhaft
  130.                         SORTWORK - der angezeigte Parameter ist zu lang
  131.  
  132.                 Feldformat nicht zulässig
  133.                         Bei dem SORTFIELDS-Parameter ist das Feldformat nicht
  134.                         bekannt.
  135.  
  136.                 in fehlerhaftem Format
  137.                         - Der Detailparameter hat z.B. Buchstaben, wo nur
  138.                           Ziffern erlaubt sind.
  139.  
  140.                         - Bei SORTCORE ist die Längenangabe nicht numerisch.
  141.  
  142.                         - Bei SORTIN und SORTOUT kann an dieser Stelle kein
  143.                         Dateiformat festgestellt werden. Da der Detailpara-
  144.                         meter komplett fehlen kann, wird dann eine Längen-
  145.                         angabe erwartet, aber keine numerische Folge
  146.                         festgestellt.
  147.  
  148.                         - Bei SORTFORM ist die Angabe weder FIX noch VAR.
  149.  
  150.                 kein Format feststellbar
  151.                         Bei dem SORTFIELDS-Parameter fehlt der 1. Detailpara
  152.                         meter.
  153.                         Aus diesem Grunde ist keine Fomat-Angabe feststellbar.
  154.  
  155.                 keine Laufwerksangabe
  156.                         Die Angabe bei dem SORTWORK-Parameter stellt keine
  157.                         Laufwerksangabe (x:) dar.
  158.  
  159.                 Länge 0 nicht zugelassen
  160.                         SORTFIELDS - Eine Sortierlänge 0 ist unzulässig (und
  161.                         unsinnig).
  162.  
  163.                 Länge in fehlerhaftem Format
  164.                         Die Angabe eines Detailparameters, der eine Längenan-
  165.                         gabe beinhalten soll, wurde in fehlerhaftem Format
  166.                         gemacht.
  167.  
  168.                 Mindest-Länge größer als Maximal-Länge
  169.                         SORTOUT - Bei variablem Format ist die Angabe der
  170.                         Mindest-Länge größer als die Angabe der Maximal-Länge.
  171.  
  172.                 Mindest-Länge in fehlerhaftem Format
  173.                         SORTOUT - Die Angabe der Mindest-Länge wurde in
  174.                         fehlerhaftem Format gemacht.
  175.  
  176.                 Mindest-Länge nicht bei festem Format
  177.                         SORTOUT - Bei Ausgabedateien mit festem Satzformat
  178.                         ist die Angabe einer Mindest-Länge nicht zulässig.
  179.  
  180.                 nicht vorhanden
  181.                         Ein erforderlicher Detailparameter ist nicht
  182.                         vorhanden.
  183.  
  184.                 nicht zusammen mit ASC zugelassen
  185.                         Die Angabe VARCOB dieses Detailparameters ist nicht
  186.                         zusammen mit der Angabe ASC in dem SORTIN- oder
  187.                         SORTOUT-Parameter zulässig.
  188.  
  189.                 Stelle 0 nur bei VAR zugelassen
  190.                         SORTFIELDS - Die Sortierung der Stelle 0 ist nur bei
  191.                         Sätzen im variablen Format zugelassen.
  192.                         Hier repräsentiert diese Angabe die Satzlänge.
  193.  
  194.                 Stelle in fehlerhaftem Format
  195.                         SORTFIELDS - Die Angabe der Stelle (Beginn des
  196.                         Sortierfeldes) hat kein numerisches Format.
  197.  
  198.                 zu lang
  199.                         Der Detailparameter überschreitet die zulässige Länge.
  200.  
  201.                 Zu viele Sortierparameter
  202.                         Es wurde mehr als 25 Sortierfelder angegeben.
  203.  
  204.         Die Parameterprotokollierung wird durch die Meldung:
  205.  
  206.         ===> Parameter fehlerhaft, Abbruch
  207.         oder
  208.         ===> Parameter fehlerfrei
  209.  
  210.         abgeschlossen.
  211.  
  212.  
  213. 8.2.2 Fehler beim Dateizugriff
  214. ------------------------------
  215.         Im Rahmen des Dateizugriffs werden die Fehler folgendermaßen
  216.         dargestellt (Beispiel):
  217.  
  218.         ******** Fehler beim Dateizugriff
  219.         Fehler in Datei:BSERR1.EIN
  220.         Operation:Eröffnen zum Lesen   Fehlerart:Name zu lang
  221.         ******** Abbruch wegen Fehler beim Dateizugriff
  222.  
  223.         Zwischen der Anfangs- und der Endezeile wird die Datei,die
  224.         Operation und die Fehlerart ausgewiesen. Nachfolgend werden
  225.         die Operationen und die Fehlerarten, die bei PSWSORT
  226.         auftreten können, beschrieben:
  227.  
  228.         Operationen:
  229.                 Die Operationen sind zum Großteil selbsterklärend. Hierbei
  230.                 wird der notwendige Schluß in Zusammenhang mit der Datei und
  231.                 der Fehlerart gezogen. Besondere Details sind zusätzlich
  232.                 erläutert.
  233.  
  234.                 Eröffnen temporäre Datei
  235.                         Für Workdateien verwendet.
  236.  
  237.                 Eröffnen zum Lesen
  238.  
  239.                 Eröffnen zum Schreiben
  240.  
  241.                 Lesen ASCII feste Länge
  242.  
  243.                 Lesen ASCII Zeilenende
  244.  
  245.                 Lesen Cobol-Label
  246.                         s. 9.1, das COBOL-Label wird am Anfang der
  247.                         Eingabedatei gelesen.
  248.  
  249.                 Lesen Cobol-Satzlänge
  250.                         s. 9.1, die COBOL-Satzlänge wird in speziellem Format
  251.                         gelesen.
  252.  
  253.                 Lesen feste Satzlänge
  254.  
  255.                 Lesen variable Satzlänge
  256.  
  257.                 Löschen alte Datei
  258.  
  259.                 Löschen Datei
  260.  
  261.                 Rücksetzen an Dateianfang
  262.                         Für Workdateien verwendet.
  263.  
  264.                 Schreiben ASCII feste Länge
  265.  
  266.                 Schreiben ASCII-Text
  267.  
  268.                 Schreiben ASCII-Text, Zeilenende
  269.  
  270.                 Schreiben ASCII Zeilenende
  271.  
  272.                 Schreiben Cobol-Label
  273.                         s. 9.1, das COBOL-Label wird am Anfang der
  274.                         Ausgabedatei geschrieben.
  275.  
  276.                 Schreiben Cobol-Satz
  277.  
  278.                 Schreiben Cobol-Satzlänge
  279.                         s. 9.1, die COBOL-Satzlänge wird in speziellem Format
  280.                         geschrieben.
  281.  
  282.                 Schreiben feste Satzlänge
  283.  
  284.                 Schreiben variable Satzlänge
  285.  
  286.         Fehlerarten:
  287.  
  288.                 Bytezähler abweichend
  289.                         Es konnte nicht die gewünschte Satzlänge gelesen oder
  290.                         geschrieben werden.
  291.                         - Einlesen: Die Datei ist fehlerhaft oder die
  292.                         Satzlängenangabe bei festem Format ist falsch.
  293.                         - Schreiben: Der Datenträger ist voll.
  294.  
  295.                 Datei für Label zu kurz
  296.                         s. 9.1, die Eingabedatei ist so kurz, daß noch nicht
  297.                          einmal das COBOL-Label eingelesen werden kann. Es
  298.                          kann sich hierbei nicht um eine variable COBOL-
  299.                          Ausgabedatei handeln.
  300.  
  301.                 Datei nicht bekannt
  302.                         Eingabedatei nicht gefunden.
  303.  
  304.                 Ende Speichermedium
  305.                         Der Datenträger für die Ausgabe ist voll.
  306.  
  307.                 falsches Satzlängenfeld
  308.                         s. 9.1, das COBOL-Satzlängenfeld ist formal falsch.
  309.                         Falsche Eingabedatei.
  310.  
  311.                 kein Label-Satz vorhanden
  312.                         s. 9.1, das COBOL-Label wurde nicht gefunden. Falsche
  313.                         Eingabedatei.
  314.  
  315.                 kein Zeilenende gefunden
  316.                         Bei ASC,FIX-Datei wurde nach der vorgegebenen Satz-
  317.                         länge in der Eingabedatei keine Zeilenende-Kennung
  318.                         gefunden.
  319.  
  320.                 keine maximale Satzlänge vorhanden
  321.                         s. 9.1, bei einer Umformatierung von anderen Formaten
  322.                         auf COBOL ist es notwendig, die maximale Satzlänge,
  323.                         die sonst aus der Eingabedatei entnommen werden kann,
  324.                         expilizit vorzugeben. Dies wurde nicht gemacht.
  325.  
  326.                 letzter Satz unvollständig
  327.                         Bei einer variablen Eingabe konnte am Ende der Datei
  328.                         der letzte Satz nicht mehr in der in der Satzlänge
  329.                         angegebenen Größe eingelesen werden. Fehlerhafte
  330.                         Eingabedatei.
  331.  
  332.                 nicht durchgeführt
  333.                         Die Operation konnte wegen fehlender Voraussetzungen
  334.                         nicht durchgeführt werden.
  335.  
  336.  
  337.                 Medium nicht bekannt
  338.                         Der Datenträger (z.B. F:) ist im System nicht bekannt.
  339.  
  340.                 Name zu lang
  341.                         Der Dateiname ist zu lang.
  342.  
  343.                 zu viele Dateien
  344.                         Es wurden zu viele Dateien auf einmal eröffnet.
  345.                         -> In der Systemdatei CONFIG-SYS ist mit dem
  346.                            FILES-Parameter die Anzahl der maximal zulässigen
  347.                            Dateien zu erhöhen (s. DOS-Handbuch).
  348.  
  349.  
  350. 8.2.3 Ablaufdiagnose
  351. --------------------
  352.  
  353.         Der ordnungsgemäße Ablauf wird mit der Meldung:
  354.                  Sortierung ordnungsgemäß durchgeführt
  355.         dokumentiert.
  356.  
  357.         Fehler werden in der Ablaufdiagnose folgendermaßen
  358.         angezeigt:
  359.  
  360.         ******** Abbruch wegen Fehler beim Dateizugriff
  361.  
  362.                 Es kam ein in 8.2.2 beschriebener Fehler vor. Die Details
  363.                 sind aus dem Ablaufprotokoll ersichtlich.
  364.  
  365.         ******** Abbruch wegen fehlerhaftem Parameter
  366.  
  367.                 Es kam ein in 8.2.1 beschriebener Fehler vor. Die Details
  368.                 sind aus dem Ablaufprotokoll ersichtlich.
  369.  
  370.         Weitere Fehler können in den Abschnitten Eingabe, Sortierung
  371.         und Ausgabe auftreten. Nach den Meldungen
  372.  
  373.         ******** Eingabe ...
  374.         ******** Ausgabe ...
  375.         ******** Sortierung ...
  376.  
  377.         werden folgende Diagnosen gestellt:
  378.  
  379.                 nicht genügend Speicherplatz
  380.                         Der Arbeitsspeicherplatz reicht nicht aus.
  381.  
  382.                 Tabellenüberlauf
  383.                         - Bei der Vollversion interner Fehler
  384.                         - Bei der PD-Version zeigt diese Meldung an, daß
  385.                           . die zu sortierende Datenmenge die PD-Begrenzung
  386.                             (64KB) überschritten hat oder
  387.                           . die PD-Begrenzung der Anzahl Sortierfelder (3)
  388.                             überschritten wurde oder
  389.                           . ein Eingabesatz die PD-Begrenzung der Satzlänge
  390.                             (256) überschreitet.
  391.  
  392.                 Sortiertabelle zu klein
  393.                         Die angegebene SORTCORE-Größe bzw. der restlich freie
  394.                         Arbeitsspeicher reicht nicht für eine Grundsortierung
  395.                         bei der angegebenen Satzlänge aus. Es muß mehr
  396.                         Arbeitsspeicherplatz zur Verfügung gestellt werden.
  397.  
  398.                 falsches Tabellenformat, interner Fehler
  399.                         Interner Fehler, PSW benachrichtigen.
  400.  
  401.                 sonstiger Fehler
  402.                         Interner Fehler, PSW benachrichtigen.
  403.  
  404.  
  405. 8.3 Meldungen auf dem Bildschirm
  406. --------------------------------
  407.  
  408.         Wenn das Ablaufprotokoll nicht auf dem Bildschirm ausgegeben
  409.         wird, erscheint dort ein Kurzreport, der aus der
  410.         Produktbezeichnung, dem Copyright-Vermerk und einer
  411.         Ablaufdiagnose besteht. Beispiel:
  412.  
  413.         PswSort / Standard-Sortierprogramm V2.2   92-07-06 20:58:12
  414.         (c) Copyright by Profi-Software Theo Saleck 1990-1992
  415.         => lizenziert für Saleck Unternehmensberatung
  416.  
  417.         Ablaufdiagnose:
  418.  
  419.         ******** Abbruch wegen Fehler beim Dateizugriff
  420.  
  421.                 Die Ablaufdiagnosen sind in 8.2.3 erläutert.
  422.  
  423.         Sollte ein Fehler bei dem SORTPROT-Parameter auftreten, wird
  424.         das Ablaufprotokoll auf Bildschirm anschließend an die
  425.         folgenden Fehlermeldungen ausgegeben:
  426.  
  427.         **** Fehler bei SORTPROT-Parameter (Protokollausgabe)
  428.         **** Protokoll wird über Terminal ausgegeben
  429.  
  430.  
  431.  
  432. 8.4 Errorlevel für die Batch-Verarbeitung
  433. -----------------------------------------
  434.  
  435.         Es wird folgender ERRORLEVEL gesetzt, der in Batch-Abläufen
  436.         abgefragt werden kann (s. DOS-Handbuch):
  437.  
  438.         0 = fehlerfreier Durchlauf
  439.  
  440.         1 = Warnungen vorhanden
  441.  
  442.         2 = Fehler in den Steuerinformationen
  443.  
  444.         3 = Fehler bei der Dateiverarbeitung
  445.  
  446.