===== Ablaufverfolgung =====
Der (c4p)-Konverter/Gateway-Service bietet für jeden Konverter und für jedes Gateway die Möglichkeit, im Bedarfsfall eine Ablaufverfolgung anzufordern, in der alle Schritte (Aufruf eines Prozesses, PJL-Abfragen, etc) dokumentiert sind. Bei unerwarteten Druckergebnissen kann aus dieser Ablaufverfolgung meist leicht die Ursache ermittelt werden. Der Umfang der Ablaufverfolgung wird durch den Protokollierungsmodus bestimmt.
Ablaufverfolgungen werden mit dem Starten des Konverters oder Gateways mit gestartet. Dabei wird eine eventuell bereits vorhandene, noch nicht abgespeicherte Ablaufverfolgung weggesichert, sodaß immer die aktuelle Ablaufverfolgung und die davor verfügbar sind. Die aktuelle Ablaufverfolgung endet mit dem Anhalten des Konverters oder des Gateways.
Bei angehaltenem (graue Flagge) oder wartendem (gelbe Flagge) Konverter oder Gateway erscheint im Kontextmenü des Konverters oder des Gateways der Menüpunkt **Ablaufverfolgung**. Bei Auswahl dieses Menüpunktes erscheint ein Dialog zur Sichtung der Ablaufverfolgung.
{{convert4print:tutorial:ablaufverfolgung.png}}
In der Anzeige erscheint in jeder einzelnen Zeile eine Meldung über den Ablauf innerhalb des Konverters oder Gateways. Die Zeile enthält von links nach rechts eine Wertung der Meldung in Form einer farbigen Flagge, das Datum und die Uhrzeit des Auftretens der Meldung, die IP-Adresse des druckenden Rechners, sowie die eigentliche Meldung.
{{convert4print:tutorial:flaggreen.gif}}
Die Meldung zeigt eine positive Bestätigung eines Bearbeitungsschrittes an. Dieser Typ Meldungen wird in den Protokollierungsstufen **Fehlersuche** und **Fehler und Warnungen** angezeigt. Die genaue Bezeichnung des Bearbeitungsschrittes ist dem Text am Ende der Meldung zu entnehmen.
{{convert4print:tutorial:flagwhite.gif}}
Die Meldung zeigt eine positive Bestätigung eines Bearbeitungsschrittes an. Dieser Typ Meldungen wird nur in der Protokollierungsstufe **Fehlersuche** angezeigt und beschreibt interne Zwischenschritte, die im Falle einer Problemanalyse hilfreich sein könnten. Die genaue Bezeichnung des Bearbeitungsschrittes ist dem Text am Ende der Meldung zu entnehmen.
{{convert4print:tutorial:flagred.gif}}
Die Meldung zeigt eine Fehlersituation an. Dieser Typ Meldungen wird in allen Protokollierungsstufen angezeigt. Die genaue Beschreibung des Problems ist dem Text am Ende der Meldung zu entnehmen.
Enthält die Ablaufverfolgung zu viele Meldungen erscheint vor dem Öffnen des Dialogs eine entsprechende Meldung und die Anzeige der Meldungen im Dialog wird ab einer bestimmten Stelle abgeschnitten. Für diesen Fall und für den Fall, daß die Ablaufverfolgung mit einem externen Programm analysiert werden soll, kann durch einen Klick auf die Schaltfläche mit der Bezeichnung **Sichern** die Übertragung der Ablaufverfolgung in eine Datei angefordert werden. Es erscheint der folgende Dialog (gekürzt):
{{convert4print:tutorial:ablaufverfolgung_sichern.png}}
Der vorgeschlagene Dateiname zum Speichern der Ablaufverfolgung besteht aus dem Namen des Konverters mit der Erweiterung '.log'. Wird dieser Name nicht akzeptiert, kann er beliebig überschrieben werden. Ein Klick auf die Schaltfläche **Speichern** überträgt die gesamte Ablaufverfolgung in die angegebene Datei.
Nachfolgend ein Ausschnitt aus einer abgespeicherten Ablaufverfolgung:
0 2010-02-16 13:42:29 0.0.0.0 1 IPDSEmuP 3.0.0.110
0 2010-02-16 13:42:30 10.1.15.53 IPDS PP started
0 2010-02-16 13:42:38 10.1.15.53 Host connect 10.1.15.53:1930
0 2010-02-16 13:42:38 10.1.15.53 Printer connect 192.168.1.124
6 2010-02-16 13:42:39 10.1.15.53 PJL job start 1 (0)
6 2010-02-16 13:42:39 10.1.15.53 PJL device 'TRUE' 'Belegt' (10023)
6 2010-02-16 13:42:40 10.1.15.53 PJL device 'TRUE' 'Wartet' (10024)
6 2010-02-16 13:42:42 10.1.15.53 PJL device 'TRUE' 'Wartet' (10024)
6 2010-02-16 13:42:43 10.1.15.53 PJL device 'TRUE' 'Belegt' (10023)
3 2010-02-16 13:42:45 10.1.15.53 AFP sense code 021C..01 (0)
6 2010-02-16 13:42:48 10.1.15.53 PJL device 'TRUE' 'Belegt' (10023)
6 2010-02-16 13:42:49 10.1.15.53 PJL device 'TRUE' 'Wartet' (10024)
6 2010-02-16 13:42:49 10.1.15.53 PJL device 'TRUE' 'Belegt' (10023)
6 2010-02-16 13:42:49 10.1.15.53 PJL device 'TRUE' 'Belegt' (10023)
6 2010-02-16 13:42:51 10.1.15.53 PJL device 'TRUE' 'Wartet' (10024)
6 2010-02-16 13:42:51 10.1.15.53 PJL device 'TRUE' 'Belegt' (10023)
6 2010-02-16 13:42:54 10.1.15.53 PJL device 'TRUE' 'Wartet' (10024)
6 2010-02-16 13:42:55 10.1.15.53 PJL page 2 (0)
3 2010-02-16 13:42:57 10.1.15.53 AFP sense code 021C..01 (2)
6 2010-02-16 13:42:59 10.1.15.53 PJL device 'TRUE' 'Belegt' (10023)
6 2010-02-16 13:43:02 10.1.15.53 PJL device 'TRUE' 'Wartet' (10024)
6 2010-02-16 13:43:05 10.1.15.53 PJL device 'TRUE' 'Belegt' (10023)
6 2010-02-16 13:43:05 10.1.15.53 PJL device 'TRUE' 'Belegt' (10023)
6 2010-02-16 13:43:08 10.1.15.53 PJL device 'TRUE' 'Belegt' (10023)
6 2010-02-16 13:43:17 10.1.15.53 PJL page 4 (0)
6 2010-02-16 13:43:17 10.1.15.53 PJL job end 1 (2)
0 2010-02-16 13:43:22 10.1.15.53 Printer disconnect 192.168.1.124 (130598)
0 2010-02-16 13:43:22 10.1.15.53 Host disconnect 1930 (4)
...
Der Aufbau der Datei entspricht weitestgehend dem der Anzeige, nur daß statt der farbigen Flaggen jetzt die Zahlen 0 - grün, 6 - weiss und 3 - rot angezeigt werden. Die Datei ist eine reine 8-bit ASCII-Datei und kann daher mit jedem beliebigen Texteditor geöffnet, bearbeitet und natürlich auch durchsucht werden.
Die Bedeutung der einzelnen Meldungen ergibt sich aus dem meist kurz gehaltenen englischen Text zusammen mit den sonstigen Angaben. Die Meldungen sind primär für den technischen Support bestimmt. Wird auf eine solche Meldung innerhalb der Anzeige doppelt geklickt, erscheint ein kleiner Dialog, in dem der vollständige Meldungstext und die eventuell via DNS in einen Namen übersetzte IP-Adresse des druckenden Rechners angezeigt werden.
{{convert4print:tutorial:meldung_im_detail.png}}
Handelt es sich bei der Meldung um eine Fehlermeldung (rote Flagge), ist die Schaltfläche mit der Bezeichnung **Info** aktiviert. Ein Klick auf diese Schaltfläche sucht in den Hilfetexten zum Konverter/Gateway-Service nach der entsprechenden Fehlernummer und zeigt sie im Klartext in einem weiteren Fenster an.
\\ Ist die angezeigte Ablaufverfolgung zu lang oder zu unübersichtlich, können durch die Nutzung der am unteren Rand des Fensters angezeigten Filter einzelne Nachrichtenklassen aus- und eingeblendet werden. Ist die Box neben der Flagge markiert, werden die Nachrichten der entsprechenden Flaggenfarbe angezeigt, andernfalls eben nicht.
{{convert4print:tutorial:ablaufverfolgung_gefiltert.png}}
\\
=== Hinweise ===
* Das in den Meldungen angebene Datum und die Uhrzeit sind in der lokalen Zeit des Rechners, auf dem der Konverter/Gateway-Service ausgeführt wird. Dies ist gegebenenfalls zu berücksichtigen, wenn Meldungen mit Einträgen in den Log-Dateien der Management-Konsole abgeglichen werden müssen.
* Ablaufverfolgungen in der Protokollierungsstufe **Fehlersuche** können recht schnell sehr große temporäre Dateien erzeugen. Vor Start der Ablaufverfolgung ist es daher ratsam, sicherzustellen, daß das Arbeitsverzeichnis des Konverter/Gateway-Services genügend Platz bietet. Auch sollte eine Ablaufverfolgung in der Protokollierungsstufe **Fehlersuche** nur über einen begrenzten Zeitraum aktiv bleiben, weil sie neben der schieren Menge der erzeugten Informationen auch einen negativen Einfluß auf den Durchsatz des jeweiligen Konverters oder Gateways hat.
* Im Einstellungsdialog des Konverter/Gateway-Services kann die Größe der Ablaufverfolgung limitiert werden. Wird das Limit erreicht, wird die aktuelle Ablaufverfolgung geschlossen, als alt markiert, und eine neue Ablaufverfolgung wird begonnen.