home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1177 / pswsortp.doc < prev    next >
Encoding:
Text File  |  1993-10-02  |  13.4 KB  |  396 lines
  1. 7.      Programmbedienung
  2. -------------------------
  3.  
  4.         Da PSWSORT für seinen Ablauf eine Reihe von Parametern
  5.         benötigt, empfiehlt es sich, den Ablauf in eine Stapeldatei
  6.         (BAT-Datei, s. DOS-Handbuch) einzubetten.
  7.  
  8.         Die Programmparameter werden mit dem SET-Aufruf (s. DOS-
  9.         Handbuch) in die Programmumgebung eingefügt und danach
  10.         PSWSORT aufgerufen.
  11.  
  12.         SET kkk=pppp,pppp,p....
  13.  
  14.         k : Kennwort
  15.  
  16.         p : Detailparameter
  17.  
  18.         Durch die Vergabe von symbolischen Parametern in der
  19.         Stapeldatei lassen sich leicht Standardabläufe für öfter
  20.         benötigte Dateiformen aufbauen.
  21.  
  22.  
  23. 7.1     Grundaufbau der Programmparameter
  24. -----------------------------------------
  25.  
  26.         Nachfolgend wird das grundsätzliche Format der
  27.         Programmparameter im Format kkk=ppp.. (s. auch 7.)
  28.         beschrieben.
  29.  
  30.         Das Kennwort stellt jeweils einen Sachverhalt der
  31.         Programmsteuerung dar, die Detailparameter die hierzu
  32.         aktuell zugeordneten Werte. Wenn der Programmparameter
  33.         fehlen kann, wird dies mitsamt der automatisch
  34.         durchgeführten Funktion bei  der jeweiligen Beschreibung
  35.         erwähnt.
  36.  
  37.         Es gelten für die Beschreibung und die Angabe der
  38.         Detailparameter die folgenden Konventionen:
  39.  
  40.         a) Es werden ein oder mehrere Detailparameter angegeben.
  41.            Wird das Kennwort mit dem Gleichheitszeichen ohne
  42.            Detailparameterwert angegeben, so gilt dies als Löschung des
  43.            Programmparameters (s. auch DOS-Handbuch).
  44.  
  45.            Beispiel: SORTCORE=
  46.  
  47.         b) Mehrere Detailparameter werden durch Komma getrennt.
  48.  
  49.            Beispiel: SORTFIELDS=TEXT,1,50
  50.  
  51.         c) Kleinbuchstaben in der Parameter-Musterangabe
  52.            repräsentieren Variablen, Großbuchstaben konstante Werte mit
  53.            den beschriebenen Bedeutungen.
  54.  
  55.            Beispiel: SORTFIELDS=format,stelle[,länge][,A|D]
  56.  
  57.         d) Kann ein Detailparameter in mehreren Varianten auftreten,
  58.            so werden diese in der Musterangabe durch einen senkrechten
  59.            Strich (z.B. name|DUMMY getrennt und die Wahlmöglichkeiten
  60.            einzeln erläutert).
  61.  
  62.            Beispiel: SORTFIELDS=format,stelle[,länge][,A|D]
  63.  
  64.         e) Die angegebene Folge der Detailparameter ist einzuhalten.
  65.            Detailparameter, die fehlen können, sind durch eckige
  66.            Klammern eingeschlossen (z.B. [.länge] ). Steht das Komma
  67.            innerhalb der eckigen Klammer, kann es auch entfallen.
  68.            Kommata, die nicht in dieser Weise gekennzeichnet sind,
  69.            müssen gesetzt werden.
  70.  
  71.            Beispiel: SORTFIELDS=format,stelle[,länge][,A|D]
  72.  
  73.         f) Die Detailparameter selbst können, auch wenn sie in
  74.            dieser Beschreibung in Großbuchstaben formuliert sind, in
  75.            Groß- und in Kleinbuchstaben angegeben werden.
  76.  
  77.  
  78. 7.2     SORTPROT - Ausgabe des Ablaufprotokolls
  79. -----------------------------------------------
  80.  
  81.         Dieser Programmparameter regelt die Ausgabe des beim Ablauf
  82.         erstellten Protokolls, das Fehler- und Ablaufmeldungen
  83.         enthält.
  84.  
  85.         Musterangabe:
  86.  
  87.            SORTPROT=name|DUMMY
  88.  
  89.         name: Dateiname des Ablaufprotokolls, ggf. mit Pfad- und
  90.               Laufwerksangabe.
  91.  
  92.         DUMMY: kein Ablaufprotokoll
  93.  
  94.         Fehlt die Information, wird das Protokoll auf Bildschirm
  95.         ausgegeben.
  96.  
  97.  
  98.  
  99. 7.3     SORTCORE - Speicherbelegung
  100. -----------------------------------
  101.  
  102.         Mit diesem Programmparameter wird die Belegung des
  103.         Arbeitsspeichers festgelegt.
  104.  
  105.         Musterangabe:
  106.  
  107.            SORTCORE=n
  108.  
  109.         n : zu verwendender Sort-Arbeitsspeicherbereich in Bytes
  110.  
  111.         Fehlt die Information, wird der gesamte verfügbare
  112.         Arbeitsspeicher verwendet. Wird mehr als der verfügbare
  113.         Arbeitsspeicherplatz angegeben, reduziert PSWSORT die Angabe
  114.         automatisch auf den restlichen verfügbaren
  115.         Arbeitsspeicherbereich.
  116.  
  117.         Die verwendete Arbeisspeichergröße wird im Ablaufprotokoll
  118.         nachgewiesen.
  119.  
  120.  
  121.  
  122. 7.4     SORTIN - Eingabedatei
  123. -----------------------------
  124.  
  125.         Hiermit wird die zu sortierende Datei als Eingabedatei
  126.         bestimmt. Dieser Programmparameter darf nicht fehlen.
  127.  
  128.         Musterangabe:
  129.  
  130.             SORTIN=name[,BIN|ASC],FIX|VAR|VARCOB[,länge]
  131.  
  132.         name    : Dateiname, ggf. mit Pfadangabe
  133.  
  134.         BIN|ASC :  Dateiart
  135.  
  136.                 ASC : ASCII-Datei mit CR/LF-Steuerzeichen (ASCII-
  137.                       Steuerzeichen für "Carriage Return" und "Line-Feed",
  138.                       s. DOS-Handbuch)
  139.  
  140.                 BIN : Binäre Datei im EBCDIC-Code ohne die bei "ASC"
  141.                       aufgeführten Steuerzeichen
  142.  
  143.                 -> Fehlt die Angabe, wird BIN angenommen.
  144.  
  145.         FIX|VAR|VARCOB : Dateiformat
  146.  
  147.             FIX=feste Satzlänge
  148.  
  149.                 . die Dateiart BIN setzt eine Datei mit gleich langen
  150.                   Datensätzen ohne irgendwelche Satzendekennungen voraus.
  151.  
  152.                 . bei Dateiart ASC muß sich die Satzende-kennung CR/LF
  153.                   anschließen. Hierauf erfolgt eine Prüfung.
  154.                  Anmerkung : Diese Angabe ist nur bei ASCII-Dateien mit
  155.                   garantiert gleichen Satzlängen zu verwenden (Vorteil ist die
  156.                   Prüfung dieses Sachverhaltes). Andernfalls ist ASC,VAR zu
  157.                   verwenden.
  158.  
  159.             VAR=variable Satzlänge
  160.  
  161.                 . bei Dateiart BIN ist bei  variabler Satzlänge vor jedem
  162.                   Satz die Länge gespeichert. Format 2 Bytes als Wort bzw.
  163.                   Cardinalzahl (= Ganzzahl ohne Vorzeichen).
  164.  
  165.                 . bei Dateiart ASC handelt es sich um ASCII-Files mit
  166.                  variabler Zeilenlänge und Satzendekennungen w.o.
  167.  
  168.             VARCOB=variable Satzlänge, COBOL-Format (s. Sonderheiten,
  169.                                            Kapitel 9.1).
  170.  
  171.  
  172.  
  173.         länge   : Satzlänge bei Dateiformat FIX, bei VAR und VARCOB
  174.                   die maximale Satzlänge. Ist bei VAR und VARCOB keine Länge
  175.                   angegeben, wird 4.096 angenommen.
  176.  
  177.                   Die maximale Satzlänge ist 65.528.
  178.  
  179.  
  180.  
  181.  
  182. 7.5     SORTFORM - Sortierformat
  183. --------------------------------
  184.  
  185.         Dieser Programmparameter beschreibt die Form, in der die
  186.         interne Sortierung vorgenommen wird.
  187.  
  188.         Anmerkung: Die Form wird ohne gesonderte Spezifikation von
  189.         der SORTIN-Angabe übernommen, kann aber hier zum Zwecke der
  190.         Umformatierung speziell definiert werden. Auf diese Weise
  191.         lassen sich leicht Formatänderungen bei der Sortierung
  192.         vornehmen (z.B. wenn der Eingabesatz nur in verkürzter Länge
  193.         benötigt wird).
  194.  
  195.         Musterangabe:
  196.  
  197.            SORTFORM=[FIX|VAR][,länge]
  198.  
  199.         FIX|VAR : Satzformat
  200.  
  201.         FIX=feste Satzlänge
  202.  
  203.         VAR=variable Satzlänge
  204.  
  205.         länge : Satzlänge bei Satzformat FIX, Maximallänge bei
  206.                 Satzformat VAR
  207.  
  208.         Fehlen Parameter oder die gesamte Information, werden die
  209.         Angaben der SORTIN-Information übernommen.
  210.  
  211.  
  212. 7.6     SORTOUT - Ausgabedatei
  213. ------------------------------
  214.  
  215.         Hiermit wird die Datei für das Sortier-Ergebnis bestimmt.
  216.         Der Programmparameter darf nicht fehlen.
  217.  
  218.         S. auch Anmerkung zu 7.5 : Es läßt sich hier außer dem
  219.                                    Format auch die Dateiart ändern.
  220.  
  221.         Musterangabe:
  222.  
  223.            SORTOUT=name[,BIN|ASC][,FIX|VAR|VARCOB[,länge,[min]]]
  224.  
  225.         name    : Dateiname, Syntax entsprechend SORTIN
  226.  
  227.                 Anmerkung: Es kann die gleiche Datei wie bei SORTIN
  228.                 verwendet werden. In diesem Falle wird die Eingabedatei
  229.                 überschrieben.
  230.  
  231.         BIN|ASC :  Dateiart, Syntax entsprechend SORTIN
  232.  
  233.                 Fehlt die Angabe BIN|ASC, wird sie aus SORTIN übernommen.
  234.  
  235.                 ACHTUNG: Ist die Eingabe ASC und wird die Ausgabe auf VARCOB
  236.                 umformatiert, ist hier unbedingt BIN anzugeben, da sich
  237.                 VARCOB und ASC gegenseitig ausschließen.
  238.  
  239.         FIX|VAR|VARCOB : Dateiformat, Syntax entsprechend SORTIN
  240.  
  241.                 Fehlt die Angabe FIX|VAR|VARCOB, wird sie aus SORTIN
  242.                 übernommen
  243.  
  244.         länge   : Satzlänge bei Dateiformat FIX, maximale Satzlänge
  245.                   bei variablem Format. Syntax entsprechend SORTIN.
  246.  
  247.                   ACHTUNG: Bei Dateiformat VARCOB werden Sätze mit der
  248.                   Länge 0, die ggf. aus einer Umformatierung von ASC,VAR
  249.                   stammen, nicht ausgegeben.
  250.  
  251.                   Fehlt die Angabe >länge<, wird sie aus SORTIN übernommen
  252.  
  253.         min     : Mindest-Satzlänge bei variablen Dateien. Ist der aktuelle
  254.                   Satz kürzer, wird er entsprechend aufgefüllt und die
  255.                   Satzlänge abgeändert.
  256.  
  257.  
  258. 7.7     SORTFIELDS - Sortierfelder
  259. ----------------------------------
  260.  
  261.         Dieser Programmparameter beschreibt die Sortierfelder. Die
  262.         Angabe der Detailparameter kann in 2 Formaten vorgenommen
  263.         werden. Der Programmparameter darf nicht fehlen und muß in
  264.         einem der beiden Formate angegeben sein.
  265.  
  266.         Es können bis zu 25 Sortierfelder angegeben werden.
  267.  
  268.  
  269.  
  270. 7.7.1 Format 1 = einheitliches Format aller Felder
  271. --------------------------------------------------
  272.  
  273.         Musterangabe:
  274.  
  275.         SORTFIELDS=format,stelle[,länge][,A|D]
  276.  
  277.                         {,stelle[,länge][,A|D]}{,...
  278.  
  279.         format   : Format Sortierfeld, eine der Zeichenfolgen:
  280.  
  281.                 BIN|BINARY      Binäre Bytefolge, Länge lt.. Parameter >länge<
  282.  
  283.                 CHAR|CHARACTER  Zeichen, Länge lt. Parameter >länge<
  284.  
  285.                     für die Sortierung werden die Groß- und die Kleinbuch-
  286.                     staben gleichgesetzt und Sonderzeichen wie die normalen
  287.                     Zeichen behandelt (s. Kap. 9.2.1).
  288.  
  289.                 TEXT    Text, Länge lt. Parameter >länge<
  290.  
  291.                     grundsätzlich wie CHAR, zusätzlich werden die deutschen
  292.                     Umlaute gespreizt (s. Kap. 9.2.2).
  293.  
  294.                 INT|INTEGER             Ganzzahl mit Vorzeichen, 2 Bytes
  295.  
  296.                 LONGINT|LONGINTEGER     Ganzzahl mit Vorzeichen, 4 Bytes
  297.  
  298.                 LONG8                   Ganzzahl mit Vorzeichen, 8 Bytes
  299.  
  300.                 CARD|CARDINAL           Ordinalzahl ohne Vorzeichen, 2 Bytes
  301.  
  302.                 REAL                    Gleitpunktzahl, 8 Bytes
  303.  
  304.                 REAL4                   Gleitpunktzahl, 4 Bytes
  305.  
  306.                 DEC|DECIMAL             Dezimalzahl, Länge lt. Parameter
  307.                                                 >länge<
  308.  
  309.                       Das Format DEC entspricht dem dezimal gepackten Format,
  310.                       das von den COBOL-Compilern und auch den Coprozessoren
  311.                       verarbeitet wird.
  312.  
  313.         stelle : Beginn des Sortierfeldes, n. Byte (relativ zu 1)
  314.  
  315.                 . bei variablen Datensätzen entspr. Datenbytes.
  316.                   Ausnahme: das Satzlängenfeld wird mit Stelle=0 und
  317.                             CARDINAL sortiert.
  318.  
  319.         länge : Länge des Sortierfeldes (nur bei BIN, CHAR, TEXT und DEC)
  320.  
  321.         A|D  : Reihenfolge A(oder keine Angabe)=aufsteigend,
  322.                            D=absteigend
  323.  
  324.  
  325. 7.7.2   Format 2 = gemischte Feldformate
  326. ----------------------------------------
  327.  
  328.         Musterangabe:
  329.  
  330.         SORTFIELDS=stelle,format[,länge][,A|D]
  331.  
  332.                  {,stelle,format[,länge][,A|D]}{,...
  333.  
  334.                 Parameter wie bei Format 1.
  335.  
  336.  
  337.  
  338. 7.8     SORTWORK - Arbeitsdateien
  339. ---------------------------------
  340.  
  341. 7.8.1    Allgemeines
  342. --------------------
  343.  
  344.         Wenn die Größe des angegebenen oder noch freien
  345.         Arbeitsspeichers nicht ausreicht, um die aktuelle Datenmenge
  346.         zu sortieren, werden zur Sortierung Arbeitsdateien auf
  347.         Datenträger hinzugezogen.
  348.  
  349.         PSWSORT legt die Arbeitsdateien als temporäre Dateien auf
  350.         dem aktuellen oder, wenn angegeben, auf den spezifizierten
  351.         Medien an. Diese Medien werden im Regelfalle Festplatten
  352.         sein, es ist jedoch auch eine Verwendung von virtuellen
  353.         Platten (VDISK/RAMDISK) oder sogar Disketten als Sortier-
  354.         Arbeitsdatei möglich.
  355.  
  356.         Achtung: Bei Verwendung von Disketten wird der
  357.                  Sortiervorgang durch den langsameren Zugriff wesentlich
  358.                  verzögert.
  359.  
  360.         PSWSORT legt die temporären Arbeitsdateien in 2 Gruppen an,
  361.         die wechselweise zur Vereinigung der im Arbeisspeicher
  362.         vorsortierten Sequenzen verwendet werden:
  363.  
  364.         - 1. Gruppe = Workdateien 1 und 2
  365.  
  366.         - 2. Gruppe = Workdateien 3 und 4
  367.  
  368.         Zu jeder dieser Gruppen kann mit dem SORTWORK-
  369.         Programmparameter ein gesondertes Speichermedium zugeordnet
  370.         werden.
  371.  
  372.         Berechnung der Kapazität: Es ist zu beachten, daß jede
  373.         Arbeitsdatei-Gruppe einen Speicherplatz benötigt, der so
  374.         groß wie die zu sortierende Datenmenge ist.
  375.  
  376.         -> Als Gesamt-Speicherplatz der Workdateien wird also die
  377.            doppelte Größe der Eingabedatei benötigt.
  378.  
  379.  
  380. 7.8.2   Beschreibung Programmparameter
  381. --------------------------------------
  382.  
  383.         Angabe des Sortier-Mediums, fehlt der Programmparameter,
  384.         wird das aktuelle Laufwerk verwendet.
  385.  
  386.         Musterangabe:
  387.  
  388.         SORTWORK=x:[,y:]
  389.  
  390.         x = für Workdateien 1 und 2
  391.  
  392.         y = für Workdateien 3 und 4
  393.  
  394.         wird y nicht angegeben, wird der x-Wert auch für diese
  395.         Workdateien übernommen.
  396.