timex(1)          (System Performance Analysis Utilities)          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.

         The options are:

         -p  List process accounting records for command and all its children.
             This option works only if the process accounting software is
             installed.  Suboptions f, h, k, m, r, and t modify the data items
             reported.  The options are as follows:

                   -f    Print the fork(2)/ exec(2) 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.  This
             option works only if the process accounting software is
             installed.

         -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.





   8/91                                                                 Page 1

   timex(1)          (System Performance Analysis Utilities)          timex(1)


   SEE ALSO
         time(1), sar(1).
         times(2) in the Programmer's Reference Manual.

   NOTES
         Process records associated with command are selected from the
         accounting file /var/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.

   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































   Page 2                                                                 8/91