trxchk(1M)                                                       trxchk(1M)

NAME
     trxchk - Konsistenzprüfung von binären tracex-Protokolldateien

SYNTAX
     /opt/SItracex/bin/trxchk rawtrace [-p] [-h] [-s] [-w] [-f skip]

BESCHREIBUNG
     Mit Hilfe des Kommandos trxchk kann eine mit txc(1M) erzeugte binäre
     Protokolldatei rawtrace auf Korrektheit und Vollständigkeit überprüft
     werden. Nähere Informationen zur Konvention der Dateinamen finden Sie
     unter tracex(5).

OPTIONEN
     -p   Die Meßpunkte werden ausgegeben.

     -h   Nur der Meßpunkt HEADER wird ausgegeben.

     -s   Es wird folgende Statistik zur Messung ausgegeben:

          measurement file              Name der binären Protokolldatei
                                        rawtrace.

          machine                       Maschinentyp.

          measured at                   Datum, Uhrzeit.

          measured for                  Meßdauer in Sekunden.

          blocks written                Anzahl geschriebener Blöcke.

          buffer length (per cpu)       Größe des Meßpuffers pro Prozessor
                                        (Anzahl Wörter).

          average buffer filling        Durchschnittlicher Füllungsgrad des
                                        Meßpuffers, Angaben in Wörtern und
                                        Prozent.

          maximal buffer filling        Maximaler Füllungsgrad des Meßpuf-
                                        fers, Angaben in Wörtern und Pro-
                                        zent.

          number of words               Anzahl der geschriebenen Wörter.

          words per measurement point   Anzahl geschriebener Wörter pro
                                        Meßpunkt.

          number of measurement points  Anzahl durchlaufener Meßpunkte,
                                        Angabe absolut und in Anzahl pro
                                        Sekunde.

          Sofern keine Fehler aufgetreten sind, meldet trxchk dies durch:
          "measurement file is syntactically correct !".



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

trxchk(1M)                                                       trxchk(1M)

     -w   Es kann vorkommen, daß aus irgendwelchen Gründen innerhalb der
          binären Protokolldatei rawtrace die Verkettungsstruktur der Meß-
          blöcke zerstört ist. Mit Hilfe dieses Schalters wird diese
          defekte Datei wieder korrigiert.

     -f skip
          Die ersten skip Meßpunkte werden übersprungen, alle weiteren wer-
          den ausgegeben.

DIAGNOSE
     Eine mögliche Fehlermeldung ist: "Overflow in CPU block x".

     Dies bedeutet, daß Daten wegen Pufferüberlaufs verloren wurden. Man
     hat nun folgende Möglichkeiten:

     -  Die Meldung wird ignoriert; dadurch können bei der späteren Auswer-
        tung der Messung Fehler verursacht werden.

     -  Der Puffer des Messsystems wird vergrössert. Dazu wird mit
        trxpatch(1M) bzw. trxsetbuf(1M) der neue Wert eingegeben, und die
        Messung muß wiederholt werden. (Beim Einsatz von trxpatch muß das
        System vorher neu gebootet werden.)

     -  Die Messung wird wiederholt, wobei weniger Meßpunkte eingeschaltet
        werden.

HINWEISE
     Eine ausführliche Anleitung, insbesondere eine Beschreibung sämtlicher
     tracex bekannter Meßpunkte (Ereignisse) sowie das Format der Dateien,
     ist der Datei /home/tracex/doc/trxman00 zu entnehmen.

SIEHE AUCH
     snap(1M), trxpatch(1M), trxsetbuf(1M), txc(1M), entab(4), tracex(5).





















Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98