home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / printer / spool200 / spool.txt < prev    next >
Text File  |  1993-03-09  |  30KB  |  705 lines
  1.  
  2.                   ####  ###   ###   ###  #     ##### ####  
  3.                  #     #   # #   # #   # #     #     #   # 
  4.                   ###  ####  #   # #   # #     ####  ####     
  5.                      # #     #   # #   # #     #     #  #  
  6.                  ####  #      ###   ###  ##### ##### #   # 
  7.  
  8.  
  9.                          Highspeed Druckerspooler
  10.  
  11.                               Copyrights by
  12.  
  13.                             Andreas Mandel @ OG
  14.  
  15.                               Version 2.00
  16.                               
  17.  
  18.                                10.03.1993
  19.  
  20.  
  21.                            S H A R E W A R E
  22.  
  23.  
  24.                    CPX-Modul - programmiert mit PURE C
  25.         
  26.              Treiber - programmiert mit Easy Rider Assembler
  27.  
  28.  
  29.          (Dokumentation und ChefBetaTester:  Alexander Güth @ WÜ)
  30.  
  31.  
  32.  
  33.   EINLEITUNG / FUNKTIONSPRINZIP
  34.   ----------------------------------------------------------------------------
  35.  
  36.   SPOOL ist ein Druckerspooler, welcher es ermöglicht Ausgaben auf Drucker  
  37.   erheblich in seiner Geschwindigkeit zu steigern, indem die Daten zuerst in  
  38.   einem RAM-Speicherbereich zwischengespeichert und dann im Hintergrund  an den 
  39.   Drucker geschickt werden. Hierbei besteht auch die Möglichkeit eines Quick 
  40.   Print Moduses sowie auch die Ausgabe in eine Datei oder in's Nirvana 
  41.   umzuleiten.
  42.   Weiter unterstützt SPOOL verscheidene Parameter wie Startzeit, Start-
  43.   schwelle, Timeout, sowie Herkunft des Speicherbereiches - ST-RAM oder TT-RAM. 
  44.   Auch bietet SPOOL an, den Speicher veränderbar oder fest zu installieren,
  45.   führt SPOOL eine einfache Online-Koprimierung der Druckdaten durch, damit 
  46.   weniger Pufferspeicher benötigt wird. Init von HP Druckern. GDOS-Ausgaben 
  47.   können bis zum 1000 % schneller ablaufen !!!
  48.  
  49.   Desweiteren können alle Parameter bequem per CPX-Modul eingestellt werden,  
  50.   und ein ausführlicher Statistikteil informiert über die aktuellen Ereignisse.
  51.  
  52.  
  53.   LAUFFÄHIGKEIT
  54.   ----------------------------------------------------------------------------
  55.  
  56.   SPOOL.PRG sollte auf allen ST(E),TT Modellen laufen. 
  57.   Wer es auf den FALCON testen kann, bitte melden !!!
  58.  
  59.   SPOOL.PRG benötigt selbst ca. 4 KB sowie zustätzlich den angeforderten
  60.   Pufferspeicher.
  61.  
  62.   SPOOL.CPX sollte dank des modularen Kontrollfeldes von ATARI auf allen
  63.   Rechnern/TOS-Version (>=1.04) und in allen Auflösungen (ST-LOW bis TT-HIGH)
  64.   sowie Grafikkarten laufen.
  65.  
  66.   SPOOL.CPX benötigt im aktiven Betriebszustand, d.h. wenn es vom Kontrollfeld
  67.   aufgerufen wird oder auch resident geladen wird, ca. 25 KB Speicher.
  68.  
  69.   Im passiven Betriebszustand, d.h. nicht resident im Kontrollfeld und nicht  
  70.   gestartete CPX-Application, benötigt SPOOL.CPX nur 512 Bytes (!!!), d.h. nur 
  71.   der CPX-Header ist geladen :-).
  72.   
  73.  
  74.   LIEFERUMFANG
  75.   ----------------------------------------------------------------------------
  76.  
  77.   Das Softwarepaket besteht aus folgenden Dateien:
  78.  
  79.   SPOOL   .PRG :  Treiber (AutoOrdner Programm)
  80.   SPOOL   .CPX :  CPX-Modul
  81.   SPOOL   .TXT :  Diese Anleitung
  82.  
  83.   Eine Weitergabe des unvollständigen Softwarepaketes ist untersagt !!!
  84.  
  85.  
  86.   COPYRIGHT / SHAREWAREGEBÜHR
  87.   ----------------------------------------------------------------------------
  88.  
  89.   SPOOL ist SHAREWARE, d.h.
  90.  
  91.   * Sie dürfen SPOOL beliebig weitergeben, jedoch muß stets der Inhalt des
  92.     Ordners SPOOLxxx.LZH/ZIP KOMPLETT und UNVERÄNDERT kopiert werden. 
  93.     Kürzungen und Änderungen verletzen die Copyright-Bestimmungen !
  94.  
  95.   * Sie dürfen SPOOL in aller Ruhe ausprobieren. Die vorliegende Version
  96.     ist eine "Vollversion", also in keiner Weise eingeschränkt.
  97.  
  98.   * Wenn Sie SPOOL regelmäßig benutzen, so müssen Sie einen Shareware-Betrag 
  99.     von 20 DM entrichten und werden im Gegenzug registrierter Anwender. 
  100.     Weiterhin erhalten Sie dann einen Diskette mit der neuesten Version sowie 
  101.     weiteren Tools.
  102.  
  103.   Eine Verbreitung über Mailboxen ist gestattet. Der Vertrieb in Verbindung
  104.   mit kommerzieller Software oder über PD/Shareware-Anbieter ist nur nach
  105.   vorheriger Absprache erlaubt. (Verstöße werden geahndet !!!)
  106.  
  107.   Fehlerberichte, Fragen und Registierungen sind mir willkommen.
  108.  
  109.    Postanschrift:   Andreas Mandel
  110.                     Postfach 26
  111.                     7601 Ortenberg
  112.                     D-W 7601 Ortenberg  (ab 1.7.93,  77799 Ortenberg)
  113.  
  114.          E-Mail :   Andreas_Mandel@og.maus.de
  115.          MausNet:   Andreas Mandel @ OG
  116.  
  117.   Bankverbindung:   Volksbank Offenburg
  118.                     Kto.Nr. 6478 4307
  119.                     BLZ     664 900 00
  120.   
  121.   
  122.   UPDATE / UPGRADE
  123.   ----------------------------------------------------------------------------
  124.   
  125.   Die neueste Version von SPOOL, bekommen Sie immer
  126.   
  127.   a) in der Maus OG (0781-38807) im öffentlichem Programmteil unter dem Namen
  128.      "SPOOL*.*"
  129.      
  130.   b) gegen Einsendung Ihrer Orginal-Diskette zusammen mit einem ausreichend
  131.      frankierten und an Sie adressierten Rückumschlag
  132.                     
  133.  
  134.   HAFTUNGSAUSSCHLUß
  135.   ----------------------------------------------------------------------------
  136.  
  137.   Natürlich kann die Funktionsfähigkeit des Treibers, sowie des CPX-Moduls 
  138.   nicht garantiert werden und der Autor haftet auch nicht für irgendwelche 
  139.   Schäden, die sich aus der Benutzung des Programmes oder der Dokumentation 
  140.   ergeben können.
  141.  
  142.  
  143.   INSTALLATION
  144.   ----------------------------------------------------------------------------
  145.  
  146.   - Kopieren Sie SPOOL.PRG in den AUTO-Ordner ihrer Festplatte oder Boot-
  147.     Diskette. (Spool sollte nach Möglichkeit am Ende der physikalischen
  148.     Bootreihenfolge aus dem AUTO-Ordner liegen, was aber nicht zwingend ist !)
  149.   - Kopieren Sie SPOOL.CPX in den CPX-Ordner von XCONTROL (ATARI)
  150.   - Aktivieren Sie das XCONTROLL.ACC, d.h. Endung = .ACC
  151.   - Booten Sie den Rechner neu oder laden Sie im XCONTROL.ACC unter dem
  152.     Menüpunkt "Voreinstellungen" die CPX-Module neu ein.
  153.   - Booten Sie den Rechner neu oder installieren Sie per Doppelklick auf
  154.     SPOOL.PRG den Treiber.
  155.   - Rufen Sie SPOOL.CPX auf (Doppelklick auf "Spooler set" )
  156.     (Zum Einstellen der Spoolerdaten - Siehe weiter unten ...)
  157.   - Klicken Sie "OK" und Sie kommen wieder ins Hauptmenü von XCONTROL.ACC
  158.  
  159.  
  160.   START / BEDIENUNG
  161.   ----------------------------------------------------------------------------
  162.  
  163.   SPOOL.PRG
  164.   ---------
  165.   1) Programmstart
  166.      Beim Programmstart wird zunächst getestet ob das Programm eventuell
  167.      schon im Speicher ist. Danach werden die Systemparameter getestet
  168.      und entsprechend verwertet (z.B. der Stack Offset).
  169.      
  170.      Nun erfolgt eine Überprüfung, ob der Spooler installiert werden soll,
  171.      falls nicht, wird das Programm verlassen. Die für den Spooler
  172.      benötigten Programmteile bleiben resident.
  173.      
  174.      Ist eine Installation des Spoolers erwünscht und die Puffergröße
  175.      gleich null, so werden die Gemdos und Bios Vektoren zum Programm
  176.      gebogen, und das Programm resident verlassen.
  177.  
  178.        
  179.   2) Spooler Betrieb
  180.      Ist der Spooler inaktiv, dann werden lediglich die benötigten
  181.      Funktionen für das SPOOL.CPX zur Verfügung gestellt.
  182.      
  183.      Bei aktivem Spooler werden die Gemdos und Bios Funktionen, die Daten
  184.      zum Drucker schicken abgefangen, und die Daten entsprechend dem
  185.      eingestelltem Ausgabegerät verarbeitet. Bei Ausgabe an den Drucker
  186.      ist, soweit zumindest ein Zeichen im Speicher ist, entweder der
  187.      VBL-Interrupt oder der MPF-Interrupt aktiv. Die Daten werden so lange
  188.      im Puffer gesammelt bis entweder die Startschwelle überschritten
  189.      wird, oder die eingestellte Startzeit abgelaufen ist. Dann wird ein
  190.      MPF-Interrupt aktiviert, der immer dann ausgelöst wird, wenn der
  191.      Drucker bereit ist ein Zeichen zu empfangen. Dadurch wird die
  192.      Geschwindigkeit des Druckers voll ausgenutzt. Es ist nicht nötig
  193.      anzugeben, wieviele Zeichen der Drucker pro Sekunde verarbeiten kann.
  194.      
  195.      Die benötigten Vektoren werden alle nach dem XBRA Verfahren installiert 
  196.      und entfernt. Nur wenn alle eventuelle andere vektorverbiegende Pro-
  197.      gramme ebenfalls das XBRA Verfahren verwenden, ist gewährleistet, daß 
  198.      der Spooler im inaktiven Zustand seine Vektoren ausklingt. Ist das nicht 
  199.      möglich, wird der entsprechende Trap durch einen sofortigen Aufruf des 
  200.      nächsten Programms in der Verktorliste ersetzt. 
  201.      
  202.      Kennungen:      XBRA    "Spol"
  203.                      Cookie  "Spol"
  204.      
  205.   SPOOL.CPX
  206.   ---------
  207.   
  208.   Nach öffenen des modularen Kontrollfeldes von ATARI, kommen Sie mit
  209.   Doppelklick auf den Eintrag "Spooler set" in den Statistikteil von 
  210.   SPOOL.CPX.
  211.   
  212.   Wie Sie erkennen können, benutzt SPOOL.CPX eine Menüleiste, welche wie 
  213.   bei vielen anderen GEM-Programmen zu bedienen ist.
  214.   
  215.   Unterhalb der Menüleiste, können Sie den Statistikteil von SPOOL.CPX 
  216.   betrachten.
  217.  
  218.  
  219.   Beginnen wir mit der Menüleiste: 
  220.   
  221.   Info
  222.   ----
  223.   Nach betätigen dieses Menüeintrages, kommen Sie in einen Dialog, in welchem
  224.   sich die Copyrighthinweise, sowie die aktuellen Versionsdaten zum CPX-Modul,
  225.   sowie Treiber (SPOOL.PRG) befinden. 
  226.   
  227.   Quit ( OK )
  228.   -----------
  229.   Über diesen Menüeintrag kann das CPX-Modul verlassen werden. Dieser Button
  230.   hat den selben Effekt wie der Button OK, unterhalb des Statistikteils.
  231.    
  232.   Spooler Setup
  233.   -------------
  234.   Hier werden sämtliche Einstellung gemacht, welche den Spoolertreiber be-
  235.   treffen. Die entsprechenden Slider sowie PopUpMenüs sind nur dann verfügbar, 
  236.   wenn eine Einstellung möglich oder sinnvoll ist, d.h. je nach Rechnertyp und
  237.   Ausgabegerät kann entsprechende Einstellungen machen.
  238.  
  239.   1) Spooler
  240.      o Aktiv   
  241.      o Inaktiv
  242.      Mit diesem PopUpMenü kann der Spooler an- bzw. abgeschaltet werden.
  243.   
  244.   2) Ausgabe an
  245.      In diesem PopUpMenü kann das Ausgabegerät, an das die Druckerdaten
  246.      geschickt werden sollen gewählt werden. Es stehen folgende Möglich-
  247.      keiten zur Verfügung:
  248.   
  249.      o Nichts
  250.        Sämtliche Daten, die zum Drucker geschickt werden, werden verworfen,
  251.        d.h. es erfolgt keine Ausgabe. (Daten landen im Nirvana)
  252.   
  253.      o Drucker
  254.        Die Daten werden im Pufferspeicher zwischengespeichert und unter
  255.        Verwendung der Quick Printroutinen zum Drucker geschickt.
  256.   
  257.      o Datei
  258.        Nach Anwahl von Datei gelangt man zunächst in eine Fileselector Box,
  259.        in der die gewünsche Datei ausgewählt werden kann. Exsistiert die 
  260.        gewählte Datei bereits, wird man in einer Dialogbox gefragt, wie 
  261.        weiterverfahren werden soll. Sämtliche Ausgaben an den Drucker werden
  262.        nun im Puffer zwischengespeichert, und in die angegebene Datei 
  263.        geschrieben. Man sollte darauf achten, daß genügend Platz für die Daten
  264.        vorhanden ist. Wenn das Schreiben nicht möglich war, wird ein Fehler
  265.        gemeldet.
  266.        
  267.        Beachte:
  268.        --------
  269.        Es ist nicht zu empfehlen, die aktuelle Ausgabedatei bei aktivem 
  270.        Spooler auszudrucken, da dies zu einer Endlosschleife führen kann.
  271.   
  272.      o Quick PRN
  273.        In diesem Modus werden sämtliche Druck-Daten durch eine schnelle 
  274.        Routine zum Drucker geschickt. Es wird kein Pufferspeicher verwendet,
  275.        trotzdem ist die verwendete Routine wesentlich schneller, als die vom
  276.        TOS zur Verfügung gestellte.
  277.   
  278.   
  279.   3) Speicher
  280.  
  281.      o veränderbar (Pufferspeicher oben)
  282.  
  283.        NORMAL-Modus
  284.        
  285.        SPOOL installiert einen in seiner Größe veränderbaren Pufferspeicher, 
  286.        welcher nach Möglichkeit am oberen Ende des Gesamtspeicherbereiches 
  287.        liegt, so daß beim Verkleinern und Vergrößern des Pufferspeichers, der
  288.        Gesamtspeicher nicht unnötig fragmentiert wird.
  289.        
  290.      o nicht oben ( = veränderbar, Pufferspeicher _nicht_ oben)
  291.  
  292.        FLEXDISK-Modus
  293.        
  294.        SPOOL installiert einen in seiner Größe veränderbaren Pufferspeicher,
  295.        welcher _nicht_ am oberen Ende des Speicherbereiches liegt.
  296.        Da einige Programme/Accessorys (z.B. Flexdisk) sich unbedingt einen
  297.        Teil ihres Speichers direkt vor dem Bildschirmspeicher holen wollen,
  298.        ist dieser Menüpunkt eingebaut um Kompatibilitätsschwierigkeiten mit
  299.        solchen Programmen entgegen zu wirken.
  300.      
  301.      o fest ( Pufferspeicher _nicht_ oben)
  302.  
  303.        TROUBLE-Modus
  304.        
  305.        SPOOL installiert einen in seiner Größe festen (residenten) Puffer-
  306.        speicher, welcher _nicht_ am oberen Ende es Speicherbereiches liegt.
  307.        Diesen Modus sollten Sie verwenden, wenn Sie aufgrund irgendwelcher
  308.        Probleme ärger mit SPOOL haben.
  309.        
  310.        (Bitte melden Sie sich, wenn Sie diesen Modus verwenden müssen !!!)
  311.        
  312.        Beim Wechsel von "fest" nach "veränderbar"/"nicht oben" oder umgekehrt,
  313.        sind diese Einstellung erst nach dem nächstem RESET gültig. (SAVE 
  314.        nicht vergessen !!)
  315.  
  316.   4) RAM   (Nur mit TT-RAM)
  317.      Hier können alle TT-Ram (Fast-RAM) Besitzer einstellen, welchen Speicher-
  318.      bereich SPOOL als Pufferspeicher verwenden soll. Alle ST-RAM User können
  319.      hier nichts einstellen.
  320.  
  321.      o ST
  322.        Der Pufferspeicher wird vom ST-RAM angefordert.
  323.  
  324.      o TT
  325.        Der Pufferspeicher wird vom TT-RAM angefordert 
  326.        
  327.      o ST->TT
  328.        Zuerst wird ST-RAM angefordert, reicht dieser nicht aus, wird lieber
  329.        TT-RAM angefordert.                            
  330.  
  331.      o TT->ST
  332.        Zuerst wird TT-RAM angefordert, reicht dieser nicht aus, wird lieber
  333.        ST-RAM angefordert.
  334.  
  335.   5) Puffergröße    (Bereich: 1 - 9999 KB)
  336.      Hier kann die gewünschte Größe des Pufferspeichers eingestellt werden.
  337.  
  338.      Mit Klick mit der linken Maustaste auf den Slider kann man in einer
  339.      Dialogbox direkt den gewünschten Wert per Tastatur eingeben. Bei 
  340.      gedrückt halten der linken Maustaste, erscheint die Hand und man kann 
  341.      den Slider und somit den Bereich verschieben. Dies gilt auch für alle 
  342.      anderen Bereichsschieber !!!
  343.   
  344.   6) Startschwelle  (Bereich: 1 - 99 %)
  345.      Hier kann die gewünschte Startschwelle eingestellt werden. Die Ausgabe
  346.      startet dann spätestens, wenn der Pufferinhalt die eingestellte Grenze 
  347.      erreicht hat.
  348.      z.B. Ist die Puffergröße 100 KB und wird haben eine Startschwelle von
  349.           75 %, so beginnt der Ausdruck bei 75 KB Pufferfüllung.
  350.   
  351.   7) Startzeit      (Bereich: 1-600/10 Sekunden )
  352.      Hier kann die gewünschte Startzeit eingetragen werden. Die Drucker-
  353.      ausgabe, wird nach Empfangen des ersten Zeichens, unter verstreichen 
  354.      einer Wartezeit (= Startzeit) gestartet.
  355.      Bei Ausgabe an Disk wird der Puffer spätestens nach Versteichen der 
  356.      Startzeit oder des letzten Zeichens gespeichert.
  357.      
  358.      d.h. beginnt sich der Puffer des Spoolers zu füllen, beginnt SPOOL
  359.           eine vordeffinierte Zeit zu warten, und beginnt dann, nach Ablauf
  360.           dieser Zeit, mit dem Druckvorgang. 
  361.           
  362.      Nun könnte man meinen, die Startschwelle alleine würde doch genügen um
  363.      Daten an den Drucker weiter zu leiten. Doch wenn wir z.B. einen Puffer-
  364.      speicher von 100 KB bei einer Startschwelle von 75 % haben und möchten 
  365.      nun eine Datei mit 2 KB ausdrucken, würde diese nie ausgedruckt, da 
  366.      SPOOL erst ab einer Startschwelle von 80 KB mit dem Drucken beginnen 
  367.      würde.
  368.      Damit diese 2 KB Datei nicht im Spooler "verschimmelt", benötigen wir
  369.      die Startzeit, welche dafür sorgt, das auch Dateien ausgedruckt werden,
  370.      welche nicht die Startschwelle erreichen (kleine Dateien, Steuerzeichen
  371.      von CODE.CPX)
  372.      
  373.   8) Timeout        (Bereich: 0 - 300 Sekunden)
  374.      0s = Timeout ausgeschaltet
  375.      
  376.      Eine Verwendung von Timeout ist nur bei Ausgaben auf den Drucker 
  377.      möglich/sinnvoll !
  378.      
  379.      Der Timeoutzähler fängt zu zählen an, sobald zum ersten mal ein Versuch 
  380.      scheitert, ein Zeichen an den Drucker zu schicken. Erreicht der Zähler 
  381.      den Endstand wird eine Fehlermeldung an die Application zurückgegeben.
  382.  
  383.      Läuft der Pufferspeicher schon vor dem Erreichen des Timeouts über,
  384.      wird versucht bis zum Erreichen des Timeouts ein Zeichen an den Drucker 
  385.      loszuwerden, gelingt das nicht wird ein Fehler an die Applikation 
  386.      zurückgegeben.
  387.  
  388.      Der Fehlercode (GEMDOS-Fehlernummer) wird aber bisher nur von wenigen 
  389.      Programmen ausgewertet, wie z.B. "Papyrus" oder "Idealist". 
  390.      GDOS sowie viele andere Druckprogramme ignorieren diesen Fehlercode,
  391.      und drucken blind weiter !!! SPOOL nimmt in solch einem Fall dann Daten
  392.      weiter auf und schickt Sie ins Nirvana, damit es zu keinem "hänger" 
  393.      des Rechners kommt.
  394.  
  395.   9) Save
  396.      Hier kann man die aktuellen Einstellungen nach einer Sicherheitsabfrage
  397.      dauerhaft in SPOOL.PRG sichern, damit der Treiber beim booten mit den 
  398.      richtigen Einstellungen startet. Wird das Programm nicht gefunden, so 
  399.      wird die Auswahl über eine F-Sel Box ermöglicht.
  400.  
  401.      Ist die Einstellung Aktiv selektiert, so wird der Spooler beim Start 
  402.      automatisch installiert. Bei Ausgabeumlenkung an Disk, ist darauf zu 
  403.      achten, daß die gewählte Datei nicht gelöscht wird. Neue Daten werden 
  404.      dann an diese Datei angehängt.
  405.      
  406.   10) OK
  407.       Die aktuellen Einstellungen werden zum laufenden SPOOL.PRG übertragen.
  408.       Dies ist nur bei leerem Pufferspeicher möglich.
  409.      
  410.   11) Abbruch
  411.       Das Fenster wird verlassen, die gemachten Einstellungen werden 
  412.       verworfen.
  413.   
  414.   Löschen
  415.   -------
  416.   Durch Anklicken dieses Menüeintrages, wird nach einer Sicherheitsrückfrage 
  417.   der gesammte Inhalt des Pufferspeichers gelöscht.
  418.   
  419.   Starten
  420.   -------
  421.   Hiermit kann eine gestoppte Ausgabe wieder gestartet werden, oder ein vor-
  422.   zeitiger Ausdruck bei extrem hoch eingestellter Startzeit/Startschwelle
  423.   erzwungen werden. 
  424.   
  425.   Stoppen
  426.   -------
  427.   Die Ausgabe auf das Ausgabegerät wird gestoppt, hierbei werden die Timeout-
  428.   sowie Startzeit-Zähler zurückgesetzt. Sobald ein Programm ein Zeichen zum 
  429.   Drucker schickt, werden die Zähler wieder gestartet, ist die Startschwelle 
  430.   bereits überschritten, so wird der Ausdruck fortgesetzt.
  431.  
  432.   Statistik Setup
  433.   ---------------
  434.   1) Schrift
  435.      o klein
  436.      o Groß
  437.      Mit Hilfe dieses PopUpMenüs kann angegeben werden, welcher Schrifttyp
  438.      für die im INFO-Fenster des Statistikteils angezeigten Werte, verwendet
  439.      werden soll.
  440.      
  441.   2) Statistik Update   (Bereich: 1 - 320/100 Sekunden)
  442.      Hier kann angegeben werden, wie häufig die Statistikwerte aktualisiert
  443.      werden sollen.
  444.      
  445.   3) Save
  446.      Hiermit werden die in diesem Dialog gemachten Werte in das SPOOL.CPX
  447.      Modul gesichert.
  448.      
  449.   4) OK
  450.      Hiermit werden die in diesem Dialog gemachten Werte übernommen.
  451.      
  452.   5) Abbruch
  453.      Der Dialog wird verlassen, die gemachten Einstellung werden verworfen.
  454.      
  455.   Reset
  456.   -----
  457.   Mit diesem Menüeintrag, werden sämtliche Zähler und Wertangaben im
  458.   Statistikteil auf ihre Startwerte zurückgesetzt, welche i.d.R. 0 sind. ;-)
  459.  
  460.  
  461.   Statistikmenü
  462.   -------------
  463.   Wenden wir uns nun dem Statistikteil von SPOOL.CPX zu. Hier können Sie
  464.   alle Ereignisse rund um den Ausdruck Online beobachten.
  465.   
  466.   Legen Sie sich einfach das geöffnete CPX-Modul bei laufender Application
  467.   auf den Desktop oder neben die Applicationsfenster.
  468.  
  469.   Links erkennen Sie 3 Balken.
  470.   
  471.   1) Spoolerpuffer/Auslastung (Startschwelle) - RAM
  472.      Der erste Balken zeigt an, in wie weit der Pufferspeicher mit
  473.      komprimierten Druckdaten der laufenden Application gefüllt ist.
  474.      Am oberen Ende des Balkens wird die voreingestellte Puffergröße in KB
  475.      angezeigt.
  476.      Desweiteren sehen Sie einen Pfeil (--->), welcher die Startschwelle
  477.      symbolisiert, d.h. 
  478.      ist der Pufferspeicher soweit mit Druckerdaten der laufenden Application
  479.      gefüllt, daß die Startschwelle erreicht ist, wird mit dem Ausdruck an
  480.      den Drucker begonnen.
  481.   
  482.   2) Timeout - TO
  483.      Der zweite Balken mit der Kennung "TO" symbolisiert den TIMEOUT-Zähler.
  484.      Am oberen Ende des Balken wird die voreingestellte Timeoutzeit in 
  485.      Sekunden angezeigt.
  486.     
  487.   3) Startzeit - SZ
  488.      Der dritte Balken mit der Kennung SZ symbolisiert den Startzeit-Zähler.
  489.      Am oberen Ende des Balken wird die voreingestelle Startzeit in 
  490.      Sekunden.zehntel Sekunden 
  491.      
  492.   4) INFO-Fenster
  493.      In diesem Fenster werden weitere wichtige Daten zum Ausdruck angezeigt.
  494.  
  495.      - Spoolerzustand (Aktiv/Inaktiv)
  496.      - Inhalt
  497.        Füllungszustand des komprimierten Pufferspeichers in Byte. Hierbei 
  498.        muß beachtet werden, das SPOOL eine einfache ONLINE-Comprimierung 
  499.        durchführt, mit dem Ziel Pufferspeicher zu sparen.
  500.      - Comp.ratio
  501.        Grad (%) der Effektivität der Komprimierung
  502.      - CPS to PRN
  503.        Druckgeschwindigkeit in  Zeichen/Sekunde bei Ausgabe auf den Drucker !
  504.      - Letzter Status
  505.        Hier werden aktuelle Fehler und Zustände angezeigt,
  506.        folgende Statusmeldungen sind möglich:
  507.  
  508.        * "OK"                   -> alles OK :-)
  509.        * "Datei Fopen error"    -> Fehler bei der Umlenkung auf Disk
  510.                                    (Zieldatei wurde wahrscheinlich gelöscht)
  511.        * "Datei Fwrite error"   -> dto, Disk voll?
  512.          "Mfree Error?"         -> Mfree hat nicht geklapt -> PRG Bug
  513.        * "Out of Memory"        -> Tja, RAM kaufen
  514.        * "Timeout",             -> Drucker OFFLINE
  515.          "FATAL VBL error"      -> sehr übel, konnte VBL nicht anlegen
  516.                                    Fatale Systemstuktur, Malloc ging schief...
  517.        * "Res: Out of Memory"   -> Es wurde versucht mehr residenten Speicher
  518.                                    anzulegen, als wie beim Start reserviert
  519.                                    wurde.
  520.        * "Res: Wrong Type"      -> Wurde versucht z.B. TT RAM resident zu 
  521.                                    holen, obwohl beim Start ST RAM reserviert
  522.                                    wurde.
  523.          "undefined nnnn"       -> Falscher Fehler :-( mit Fehlernummer :-)
  524.        * "XBRA Trap ..."        -> SPOOL konnte sich beim inaktivieren des
  525.                                    Spoolers nicht nach dem XBRA-Verfahren
  526.                                    aus dem Speicher entfernen, die Traps 
  527.                                    konnten nicht restauriert werden.
  528.                                    Der Spooler hängt weiter in den Traps macht
  529.                                    aber nichts (mehr).
  530.  
  531.        Für Anwender sind eigentlich nur die mit * markierten Fehlermeldungen 
  532.        interessant, bei den anderen wirds echt deftig.
  533.                           (eventuell Fehler in Spool.PRG -> Meldung an Autor)
  534.  
  535.      - Bconout   |
  536.      - Cprnout   |  Anzeige der gesendeten Zeichen in Byte,
  537.      - Cprnos    |  welche über einen dieser Druckkanäle
  538.      - Fwrite    |  von der Application an den Drucker
  539.      - Bcostat   |  gesendet wurden.
  540.      - Hardcpy   |
  541.  
  542.      - Interrupt 
  543.        Zähler, wie oft der Druckerinterrupt ein- und ausgeschalten wurde.
  544.        (wie oft Startzeit oder Startschwelle erreicht wurden.)     
  545.  
  546.      - PufferGr.
  547.        Anzeige wieviel Pufferspeicher in KB angelegt ist.
  548.      - Startsw.
  549.        Anzeige der Startschwelle in KB
  550.      - StartZeit
  551.        Anzeige der Startzeit in s/10 (zehntel Sekunden)
  552.      - Timeout
  553.        Anzeige der Timeoutzeit in Sekunden
  554.   
  555.  
  556.   BEKANNTE BESCHRÄNKUNGEN / BUGs
  557.   ----------------------------------------------------------------------------
  558.  
  559.   - Bei Benutzung der Flexdisk, Speicher mit "nicht oben" anfordern !!!
  560.  
  561.   - SPOOL.PRG läuft nicht unter MINT/MultiTOS
  562.  
  563.     Der Speicherverwaltung des Spoolers und die Schnittstelle zwischen dem 
  564.     CPX-Modul und dem TSR-Programm müßten an MINT angepaßt werden. Ohne
  565.     die Memory-Protection und wenn man den Spooler nicht umkonfiguriert 
  566.     funktioniert es aber. Eine Anpassung wird erst erfolgen, wenn die 
  567.     Unterstützung der Druckerschnittstelle von MINT in der entgültigen 
  568.     Version vorliegt. 
  569.     
  570.     Es stellt sich außerdem überhaupt die Frage, ob ein Spooler unter 
  571.     MultiTOS Sinn macht, da sowieso im Hintergrund gedruckt wird !!!
  572.     
  573.   - Programme welche aus Geschwindigkeitsgründen nicht über TOS drucken,
  574.     können nicht von SPOOL profitieren (schmutziges Drucken !)
  575.     
  576.     Man beachte aber, daß manche Programme die Möglichkeit bieten, die 
  577.     Original TOS (BIOS/GEMDOS) Routinen zu verwenden (z.B. TeX DVI Treiber-
  578.     Familie von Christoph Strunk mit dem Parameter "-o:PRN:")
  579.  
  580.   - Wird auf dem TT eine virtuelle Speicherverwaltung (wie z.B. VRAM oder
  581.     Outside) genutzt so darf der Pufferspeicher _nicht_ im TT-RAM angelegt 
  582.     werden (eventuell geht das mit dem nächsten Update ... )
  583.  
  584.  
  585.   DANKSAGUNGEN
  586.   ----------------------------------------------------------------------------
  587.   - Tja, wiedermal finde ich es toll, das Andreas sich aufgerafft hat und
  588.     ein Upgrade seines Spooler programmiert hat, welches fast schon wieder
  589.     eine Neugeburt war ... 
  590.     Aber nichts destotrotz, wir haben es geschafft, nach vielen vielen 
  591.     Bugreports und Schönheitskorrekturen ... und hier ist er,
  592.     der beste Spooler für den ST !!!!!
  593.         
  594.     und jetzt ???
  595.  
  596.     "... jetzt geh'n wir alle erstmal ein Bier trinken ;-) 
  597.                                               (Chris, Alex, wer geht mit ?)"
  598.  
  599.   - Ich, Andreas möchte mich bei Alex bedanken, daß er mir mal wieder die 
  600.     Arbeit mit der Dokumentation abgenommen hat. 
  601.     Für's Aufdecken etlicher Fehler danke ich Christoph Bartholme @ KA2, dem
  602.     Alex und allen Spooler-Usern, die mir Bugreports geschickt haben. 
  603.     Besonderer Dank verdient auch das "MausNetz" ohne das die Entwicklungs-
  604.     phase bestimmt ein vielfaches der Zeit in Anspruch genommen hätte.
  605.     Und nicht zuletzt den eingetragenen Usern des Spoolers, deren Geduld 
  606.     ich gewaltig auf die Probe stellen mußte.
  607.  
  608.  
  609.   TIPs und KNIFFE
  610.   ----------------------------------------------------------------------------
  611.  
  612.   - Fast kein Programm verwendet den TIMEOUT-Code, welcher vom Drucker an 
  613.     den Computer gesendet wird, wenn dieser nicht bereit ist Daten zu 
  614.     empfangen. GDOS-Druckertreiber drucken blind, d.h. Sie achten überhaupt
  615.     nicht darauf, ob Ausgabegeräte ONLINE sind oder nicht !!!
  616.     Das einzige Programm, welches ordnungsgemäß einen TIMEOUT erkennt, ist
  617.     das Textverarbeitungsprogramm PAPYRUS (im TOS-Modus) sowie der Idealist.
  618.     Alle anderen mir (Alex) bekannten Programme drucken blind !!!
  619.     Hier ist ein echter Nachholbedarf für ATARI-Programme !!!
  620.     
  621.   - HP DESKJET / LASERJET
  622.  
  623.     Allen HP DeskJet und HP Laserjet Benutzern wird es schon passiert sein,
  624.     das wenn man den Drucker erst nach dem Rechner einschaltet, vom ATARI aus 
  625.     nicht angesprochen werden kann. Dieses Manko behebt SPOOL automatisch,
  626.     so daß keine speziellen Programme (INIT Drucker) mehr benötigt werden !!
  627.     
  628.   - Mit folgenden Programmen wurde SPOOL getestet:
  629.     
  630.     o alle über GDOS druckenden Programme, also wie z.B. XACT, ProList,
  631.       K-Spread 4, Mydraw, Tele Office, uva.
  632.     o Tempus Word im BIOS- oder GEMDOS-Modus
  633.     o Signum3! im Centronics-BIOS-Modus, kein SPL.ACC
  634.     o Papyrus im TOS-kompatiblen-Modus
  635.     o Editoren wie QED, 7up, Everest, Harlekin III, Tempus 
  636.     o Strunk-TeX (Parameter: -o:PRN: )
  637.     o Formular pro
  638.     o QFax-Manager
  639.     o Papillon
  640.     o Phönix
  641.     o Idealist
  642.  
  643.   Wer kann noch von anderen Programmen berichten ? Test's ?
  644.     
  645.     
  646.   Fehlermeldungen
  647.   ----------------------------------------------------------------------------
  648.  
  649.   Mögliche Dialogboxen vom CPX-Modul:
  650.  
  651.   
  652.   "Nicht genug freier Speicher vorhanden. -> Siehe Status Out of Memory.
  653.    Installation abgebrochen"
  654.  
  655.   "Das gefundene SPOOL.PRG enthält un-"   ->  z.B. Spool.CPX V1.00 + 
  656.    erwartete Daten, falsche Version,          SPOOL.PRG 1.23 oder völlige 
  657.    oder zerstörte Dateistruktur."             falsches Programm ausgewählt
  658.  
  659.   "Installation nur bei leerem Buffer     -> Tja, vorher Puffer löschen oder
  660.    möglich. Parameter wurden nicht           warten bis alles ausgedruckt ist
  661.    übernommen."
  662.  
  663.   "SPOOL.PRG ist nicht Installiert oder   -> SPOOL.PRG nicht installiert
  664.    falsche Version. Der Aufruf von 
  665.    SPOOL.CPX wird daher abgebrochen."
  666.       
  667.   "Bei residentem Speicher ist das ver-   -> Siehe Status "Res: Wrong Type"
  668.    größern des Puffers nicht möglich"
  669.  
  670.   "Bei residentem Speicher ist das        -> Siehe Status "Res: Wrong Type"
  671.    Ändern des RAM-Types nicht möglich"
  672.  
  673.   "Ändern des Speicherstatus (resident    -> falls wirklich gewünscht mit
  674.    <->dynamisch) ist nur durch Sichern       sichern in SPOOL.PRG speichern
  675.    in SPOOL.PRG und neustart möglich!"       + RESET
  676.  
  677.  
  678.   Und jetzt zum SPOOL.PRG (Meldungen beim Booten bzw. Starten:)
  679.  
  680.  
  681.   "Installation abgeschlossen"            -> alles OK. 
  682.   "benutze Xcontrol zum Einstellen"
  683.  
  684.   "Cookie-Jar installiert"                -> da noch kein Cookie Jar insta-
  685.                                              lliert war wurde einer angelegt
  686.  
  687.   "Cookie-Jar erweitert"                  -> vorhandene Cookie war voll...
  688.  
  689.   "kritische Systemstruktur, kann"        -> da war was oberfaul, Malloc 
  690.   "Cookie-Jar nicht erweitert/anlegen"       über <1KB ist gescheitert :-( ..
  691.  
  692.   "Nicht genügend Speicher für den        -> Spooler wurde geladen, aber die
  693.    Puffer vorhanden"                         Automatische installation wurde 
  694.                                              abgebrochen...
  695.  
  696.  
  697.   HISTORY
  698.   ----------------------------------------------------------------------------
  699.  
  700.   10.03.93  V2.00   Vereinheitlichung der Versionsnummern.
  701.                     Komplett neue Docu (vom Alex), jetzt nicht mehr als
  702.                     TeX Source....
  703.  
  704.  
  705.