timex(1)                                                 timex(1)



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

     SYNOPSIS
          timex [-o] [-p[fhkmrt]] [-s] command

     DESCRIPTION
          timex sends the given command to the shell for execution;
          timex then reports (in seconds) the elapsed time, user time,
          and system time spent in execution.  Optionally, timex may
          list or summarize process accounting data for the command
          and all its children, or report total system activity during
          the execution interval.

          The output of timex is written on the standard error output.

     FLAG OPTIONS
          The flag options interpreted by timex 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(1M).  timex
               always reports the number of blocks read or written and
               the number of characters transferred.

          -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 com-
               mand) that occurred during the execution interval of
               command.  timex reports all the data items listed in
               sar(1).

     EXAMPLES
               timex ps -el

          runs the ps command (with the correct flag options), then
          produces statistics concerning the command and system ac-
          tivity during the command to the standard error output.

     FILES
          /usr/bin/timex
          /usr/lib/sa/timex

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

     WARNINGS
          Process records associated with command are selected from
          the accounting file /usr/adm/pacct by inference, since pro-



     April, 1990                                                     1

     timex(1)                                                 timex(1)



          cess genealogy is not available.  Background processes hav-
          ing the same user ID, terminal ID, and execution time window
          will be included spuriously.




















































     2                                                     April, 1990