trxchk(1M)                                                       trxchk(1M)

NAME
     trxchk - consistency checking of binary tracex log files

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

DESCRIPTION
     A rawtrace binary log file created using txc(1M) can be checked for
     correctness and completeness using the trxchk command. More detailed
     information on filename conventions can be found under tracex(5).

OPTIONS
     -p   Outputs the measurement points.

     -h   Outputs the HEADER measurement point only.

     -s   The following measurement statistics are output:

          measurement file              Name of the rawtrace binary log
                                        file.

          machine                       Machine type.

          measured at                   Date, time.

          measured for                  Measurement period in seconds.

          blocks written                Number of blocks written.

          buffer length (per cpu)       Size of the measurement buffer per
                                        processor (number of words).

          average buffer filling        Average degree to which the meas-
                                        urement buffer is filled, specified
                                        in words and as a percentage.

          maximal buffer filling        Maximum degree to which the meas-
                                        urement buffer is filled, specified
                                        in words and as a percentage.

          number of words               Number of words written.

          words per measurement point   Number of words written per meas-
                                        urement point.

          number of measurement points  Number of executed measurement
                                        points, specified absolutely and as
                                        number per second.

          If no errors have occurred, trxchk reports this as: "measurement
          file is syntactically correct !".




Page 1                       Reliant UNIX 5.44                Printed 11/98

trxchk(1M)                                                       trxchk(1M)

     -w   It can happen that the chaining structure of the measurement
          blocks within the rawtrace binary log file becomes corrupt for
          some reason. This defective file is corrected using this option.

     -f skip
          The first skip measurement points are skipped, all others are
          output.

ERROR MESSAGES
     A possible error message is: "Overflow in CPU block x".

     This means that data was lost due to a buffer overflow. You now have
     the following options:

     -  Ignore the message; this may cause errors during later evaluation
        of the measurement.

     -  Increase the size of the measurement system buffer. To do this, the
        new value is entered using trxpatch(1M) or trxsetbuf(1M) and the
        measurement must be repeated. (The system must first be rebooted
        when using trxpatch.)

     -  The measurement is repeated with fewer measurement points enabled.

NOTES
     Detailed instructions and, in particular, a description of all meas-
     urement points (events) known to tracex, as well as the format of the
     files, can be found in the /home/tracex/doc/trxman00 file.

SEE ALSO
     snap(1M), trxpatch(1M), trxsetbuf(1M), txc(1M), entab(4), tracex(5).























Page 2                       Reliant UNIX 5.44                Printed 11/98