trxeval(1M) trxeval(1M)
NAME
trxeval - logical evaluation of a tracex measurement
SYNOPSIS
/opt/SItracex/bin/trxeval [-f asciitrace] [-p pid] [-s starttime]
[-i timeinterval] [-e endtime] [-l] [-c]
[-E] [-v] [-h] [-w]
DESCRIPTION
The trxeval program evaluates the asciitrace and mnameps files
created by trxout(1M) and txc(1M). More detailed information on
filename conventions can be found under tracex(5).
General data relating to measurement and system behavior, such as
utilization of the CPU and disks, is logged. Statistics on the
processes and disk requests entered are also output. In addition, data
relevant to each process entered can be calculated and output.
OPTIONS
-f asciitrace
The asciitrace file created by trxout(1M) is used as input. Stan-
dard input is used if this is not specified.
-p pid
Only measurement points belonging to this process ID are
evaluated. All PIDs are evaluated if this is not specified.
Repeated use of this option is permitted.
-s starttime
Only those measurement points that occurred after the starttime
(in milliseconds from the start of measurement) are evaluated.
Evaluations are carried out from the time the measurement starts
if this is not specified.
-i timeinterval
In the case of some trxeval evaluations, events are added over
various time intervals. The length of such an interval can be
defined using this option. The default value is 1,000 mil-
liseconds.
-e endtime
Only those measurement points that occurred before the endtime
(in milliseconds from the start of measurement) are evaluated.
Evaluation is performed until the measurement is ended if this is
not specified.
-l The events are output in a process-oriented manner. A CPU
analysis, disk analysis, and terminal analysis are output for
each process. Analysis of the disks and the terminal is only per-
formed if the process actually accessed these function units.
Page 1 Reliant UNIX 5.44 Printed 11/98
trxeval(1M) trxeval(1M)
-c All system calls executed by the entered processes are evaluated.
A system call analysis for each process is output in the
mnameout file.
-E If system calls are evaluated (-c option), all error messages of
the evaluated system calls are, in addition, output to the
mnamesyserr file.
-v The current status of the evaluation can be followed on the
screen. A message is displayed at intervals of 10% of the size of
the ASCII log file. The number of data records read is output at
the end of the evaluation as well as a period (".") for each
evaluated process.
-h Headers are output to the mnameout file using this option. A
page feed is created before each header. Each header contains the
name of the evaluated ASCII log file and the page number.
-w Using this option warnings are output to the mnameerr file, in
addition to the error messages. These warnings occur frequently
during the evaluations and are used for debugging purposes only.
NOTES
trxeval also requires the asciitraceps file generated by txc(1M) to
perform evaluations.
There are two utilities, trxproc(1M) and do.lev2(1M), that further
process the output from trxeval.
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
do.lev2(1M), snap(1M), trxout(1M), trxproc(1M), txc(1M), entab(4),
tracex(5).
Page 2 Reliant UNIX 5.44 Printed 11/98