CXI-Basis-Programmierreferenz / Version 2 / Datenaustausch / Ebene 2 / Message Trace /

CXIBWTRC.EXE - Message Trace (Windows)

CXIBWTRC.EXE

Hinweis: Bei Verwendung der CXI-SHELL sollte statt des hier vorgestellten Programms die dort integrierte Trace-Funktion benutzt werden.

Um die Ablaufverfolgung unter Windows zu aktivieren, starten Sie das Programm CXIBWTRC.EXE.

In einem Dialogfenster können Sie nun die Einstellungen für den Trace festlegen. Die Vorgaben für die Eingabefelder werden aus dem [MSGTRC]-Abschnitt der Standard-INI-Datei gelesen.

Trace file name
Geben Sie hier den Namen der Datei an, in die CXIBWTRC den Trace schreiben soll. Die Datei wird automatisch angelegt, wenn sie nicht existiert.

Browse file name
Wenn Sie hier einen Dateinamen eingeben, schreibt CXIBWTRC Informationen für den Browser in diese Datei.

Ignore handlers
Meldungen, die von einem in diesem Eingabefeld angegebenen Handler verschickt oder empfangen werden, werden nicht in die Tracedatei aufgenommen. Trennen Sie mehrere Namen mit Semikolons.

Exclude actions
Meldungen, die eine Variable ACTION enthalten, wobei ACTION einen der Werte in diesem Eingabefeld besitzt, werden nicht in die Tracedatei aufgenommen. Trennen Sie mehrere Werte mit Semikolons.

Include actions
Meldungen, die eine Variable ACTION enthalten, wobei ACTION einen der Werte in diesem Eingabefeld besitzt, werden auf jeden Fall in die Tracedatei aufgenommen. Trennen Sie mehrere Werte mit Semikolons.

Other actions
Geben Sie hier an, wie mit Meldungen verfahren werden soll, die nicht unter die Ein- und Ausschluss-Bedingungen in den beiden Eingabefeldern fallen. Ist dieses Feld markiert, werden solche Meldungen in den Trace aufgenommen, ansonsten nicht.

Program and user infos
Ist dieses Feld markiert, können Sie während des Trace eigene Informationen in die Tracedatei einfügen. Nach Betätigung des Info-Schalters können Sie bis zu 4 Textzeilen eingeben.

System notifications
Markieren Sie dieses Feld, um Systemmitteilungen (z.B. Konstruktor- und Destruktoraufrufe) in den Trace aufzunehmen.

Received messages
Markieren Sie dieses Feld, um den Inhalt aller empfangenen Meldungen in die Tracedatei aufzunehmen.

Errors
Markieren Sie dieses Feld, um den Inhalt aller versendeten und nicht empfangenen Meldungen in die Tracedatei aufzunehmen (unzustellbare Meldungen).

System messages
Markieren Sie dieses Feld, um die ab Version 2.02 vom CXI-System selbst generierten Meldungen in den Trace aufzunehmen, z.B. '@DRIVER'-Meldungen an Treiber. Die Version 2.01 ignoriert diese Einstellung.

Quit
Betätigen Sie den Quit-Schalter, um das Programm zu beenden. Ist der Trace gerade aktiv, erfolgt eine Sicherheitsabfrage.

Start
Mit dem Schalter 'Start' wird der Trace gestartet. Das Fenster wird automatisch auf Icon-Größe verkleinert, wenn dies im Menü "Window / Auto-minimize" markiert ist. Während der Trace läuft, sind alle Eingabefelder gesperrt.

Stop
Mit dem Schalter 'Stop' wird der Trace beendet.

Info
Während der Trace läuft, können Sie nach Betätigung dieses Schalters bis zu 4 Textzeilen eingeben, die in die Tracedatei eingefügt werden. Um diese Möglichkeit zu nutzen, muss das Feld 'Program and user infos' markiert sein. Auf diese Art und Weise können Sie Marken setzen, um bestimmte Situationen später in der Trace-Datei besser auffinden zu können.

List
Betätigen Sie den List-Schalter, um eine Liste aller aktiven Meldungsempfänger anzuzeigen. In dieser Liste haben Sie folgende Möglichkeiten:

ENDPRG: Senden einer ENDPRG-Meldung an den ausgewählen Empfänger
KILLTASK: Brutales Beenden des Programms mit dem ausgewählen Empfänger
DELETE: Löschen des ausgewählen Empfängers (ohne Destruktoraufruf)
REFRESH: Aktualisieren der Liste
CLOSE: Schließen des Fensters
INFO: Nähere Information zum ausgewählen Empfänger.

Hilfetexte zu den einzelnen Elementen des Dialogs können über das Menü "Help" jederzeit abgerufen werden. Die Texte werden in englischer und deutscher Sprache angezeigt.

Durch Auswahl von "About CXIBWTRC.EXE" erhalten Sie Informationen über die verwendeten Versionen von CXIBWTRC.EXE und CXIBWSYS.DLL.

Klicken Sie auf die entsprechende Schaltfläche, um die internen Revisionsdaten festzustellen. Sollten Probleme mit CXI auftreten, notieren Sie bitte die Daten in diesen Fenstern, die benutzte Systemkonfiguration und die Windows-Version.

ACHTUNG: Um Platz zu sparen, enthalten die erstellten Trace-Dateien Tabulatorzeichen (ASCII 9). Es wird mit dem TAB-Abstand 8 gearbeitet, dies ist die Standardeinstellung von DOS und BIOS. Stellen Sie den Editor auf diese Tabulatorweite ein oder konvertieren Sie die Datei vorher mit ANTITAB.

Portabilität:
Das Programm CXIBWTRC.EXE ist nur unter Windows einsetzbar und ab Version 2.00 verfügbar. Die Version dieses Programms muss mit der Version von CXIBWSYS.DLL zusammenpassen, eine Inkompatibilität wird ggf. vom Programm gemeldet:

Siehe auch:
CXIBDTRC.CPP (DOS)
CXIBOTRC.EXE (OS/2)
Funktion Handler2 mit Beispielprogramm