timex(1)                         DG/UX R4.11                        timex(1)


NAME
       timex - time a command; report process data and system activity

SYNOPSIS
       timex  [options] command

DESCRIPTION
       The given command is executed; the elapsed time, user time and system
       time spent in execution are reported in seconds.  Optionally, process
       accounting data for the command and all its children can be listed or
       summarized, and total system activity during the execution interval
       can be reported.

       The output of timex is written on standard error.

       Options are:

       -p  List process accounting records for command and all its children.
           Suboptions f, h, k, m, r, and t modify the data items reported,
           as defined in acctcom(1).  The suboptions are:


            -f    Print the fork/exec flag and system exit status columns in
                  the output.

            -h    Instead of mean memory size, show the fraction of total
                  available CPU time consumed by the process during its
                  execution.  This "hog factor" is computed as
                  (total CPU time)/(elapsed time).

            -k    Instead of memory size, show total kcore-minutes.

            -m    Show mean core size (the default).

            -r    Show CPU factor (user time/(system-time + user-time).

            -t    Show separate system and user CPU times.  The number of
                  blocks read or written and the number of characters
                  transferred are always reported.

       -o  Report the total number of blocks read or written and total
           characters transferred by command and all its children.

       -s  Report total system activity (not just that due to command) that
           occurred during the execution interval of command.  All the data
           items listed in sar(1) are reported.

EXAMPLES
       A simple example:

              timex -ops sleep 60

       A terminal session of arbitrary complexity can be measured by timing
       a sub-shell:

              timex -opskmt sh

                     session commands
              EOT

SEE ALSO
       acctcom(1), sar(1), time(1).

CAUTION
       Process records associated with command are selected from the
       accounting file /usr/adm/pacct by inference, since process genealogy
       is not available.  Background processes having the same user-id,
       terminal-id, and execution time window will be spuriously included.


Licensed material--property of copyright holder(s)