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

CXIBOTRC.EXE - Message Trace (OS/2)

CXIBOTRC.EXE

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

Um die Ablaufverfolgung unter OS/2 zu aktivieren, öffnen Sie ein OS/2-Fenster und starten Sie das Programm CXIBOTRC.EXE. Zum Beenden des Trace drücken Sie STRG+C.

CXIBOTRC - The CXI message trace for OS/2 - Version 2.04

Starting trace...

 Filename=C:\cximsg.trc
  Ignores=
 Excludes=@Dummy;@WaitState;OLDACTION=@WaitState
 Includes=
  Options=AIRED
          [X] A Other actions
          [X] I Program and user infos
          [ ] N Notifications
          [X] R Received messages
          [X] E Errors
          [X] D System and driver messages

Trace is running, press Ctrl-C or Ctrl-Break to quit...
^C

Trace terminated.

Die Datei CXIBOTRC.INI (CXI-Format) oder der [MSGTRC]-Abschnitt der Standard-INI-Datei enthält Einstellungen für den Trace, der Standardwert ist jeweils angegeben.

Filename (Str) = "c:\cximsg.trc"
Geben Sie hier den Namen der Datei an, in die CXIBOTRC den Trace schreiben soll. Die Datei wird automatisch angelegt, wenn sie nicht existiert.

BrowseFilename (Str) = ""
Wenn Sie hier einen Dateinamen eingeben, schreibt CXIBOTRC Informationen für den Browser in diese Datei.

Ignores (Str) = "PROTOCOL;@TRACE"
Meldungen, die von einem in dieser Variablen angegebenen Handler verschickt oder empfangen werden, werden nicht in die Tracedatei aufgenommen. Trennen Sie mehrere Namen mit Semikolons.

Excludes (Str) = "@Dummy;@WaitState;OLDACTION=@WaitState"
Meldungen, die eine Variable ACTION enthalten, wobei ACTION einen der Werte in dieser Variablen besitzt, werden nicht in die Tracedatei aufgenommen. Trennen Sie mehrere Werte mit Semikolons.

Includes (Str) = ""
Meldungen, die eine Variable ACTION enthalten, wobei ACTION einen der Werte in dieser Variablen besitzt, werden auf jeden Fall in die Tracedatei aufgenommen. Trennen Sie mehrere Werte mit Semikolons.

Options (Str) = "AIRED"
Jeder Buchstabe in dieser Variablen hat eine eigene Bedeutung. Geben Sie den jeweiligen Buchstaben an, um die Option einzuschalten. Zum Ausschalten der Option entfernen Sie den Buchstaben:

Option 'A'
Geben Sie hier an, wie mit Meldungen verfahren werden soll, die nicht unter die Ein- und Ausschluss-Bedingungen in den Variablen 'Includes' und 'Excludes' fallen. Ist diese Option angegeben, werden solche Meldungen in den Trace aufgenommen, ansonsten nicht.

Option 'I'
Ist diese Option angegeben, können Sie während des Trace eigene Informationen in die Tracedatei einfügen. Diese Möglichkeit kann unter OS/2 nicht genutzt werden.

Option 'N'
Geben Sie diese Option an, um Systemmitteilungen (z.B. Konstruktor- und Destruktoraufrufe) in den Trace aufzunehmen.

Option 'R'
Benutzen Sie diese Option, um den Inhalt aller empfangenen Meldungen in die Tracedatei aufzunehmen.

Option 'E'
Benutzen Sie diese Option, um den Inhalt aller versendeten und nicht empfangenen Meldungen in die Tracedatei aufzunehmen (unzustellbare Meldungen).

Option 'D'
Benutzen Sie diese Option, 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.

Soll eine andere Datei als CXIBOTRC.INI für die Einstellungen benutzt werden, geben Sie diese (ggf. mit Pfadangabe) auf der Kommandozeile an:

CXIBOTRC C:\TRACE\CXIBOTRC.PRM

Um einzelne Einstellungen zu überschreiben, können Sie eine Zuweisung angeben:

CXIBOTRC "Filename=c:\trace\cximsg.trc;Options=AINRED"

Einen kurzen Hilfetext erhalten Sie mit dem Parameter /?:

CXIBOTRC - The CXI message trace for OS/2 - Version 2.04

Usage (visible):           CXIBOTRC [<settings>]

Usage (invisible)  Start:  DETACH CXIBOTRC [<settings>]
                   Stop:   CXIBOTRC /!

where <settings> is a single file name or a string containing
setting variables using the 'SetVarsFromStringOrFile' format.

Default settings:
 Filename=c:\cximsg.trc
  Ignores=
 Excludes=@Dummy;@WaitState;OLDACTION=@WaitState
 Includes=
  Options=AIRED
          [X] A Other actions
          [X] I Program and user infos
          [ ] N Notifications
          [X] R Received messages
          [X] E Errors
          [X] D System and driver messages

Geben Sie /?? an, um die interne Versionsnummer festzustellen. Sie erhalten eine Ausgabe in folgender oder ähnlicher Form:

*** Internal revision information ***

Address=0x00010000  Flag=0x00000000  Name=MAIN
Address=0x00020000  Size=0x00007E2C  Name=STACK
Address=0x15850000  Size=0x00018EAF  Name=CODE
Address=0x15870000  Size=0x0000FFFC  Name=GLOBAL
Address=0x15A20000  Size=0x00000090  Name=LOCAL

CMTOMAIN 2.04 05: ASM MF, 24/10/95, 19:43:22

CXIBOSYS 2.04 10: WCC MF ROA 5R, Oct 24 1995, 19:43:07
Compiled and linked with Watcom C/C++32 Version 10.5

Sollten Probleme mit CXI auftreten, notieren Sie bitte diese Revisionsdaten, die benutzte Systemkonfiguration und die OS/2-Version.

ACHTUNG: Um Platz zu sparen, enthalten die erstellten Dateien TAB-Zeichen. Es wird mit dem TAB-Abstand 8 gearbeitet (Standardeinstellung DOS/BIOS).

Portabilität:
Das Programm CXIBOTRC.EXE ist nur unter OS/2 einsetzbar und ab Version 2.02 verfügbar.

Siehe auch:
CXIBDTRC.CPP (DOS)
CXIBWTRC.EXE (Windows)
Funktion Handler2 mit Beispielprogramm