timex Command

Purpose

Reports, in seconds, the elapsed time, user time, and system execution time for a command.

Syntax

timex [ -o ] [ -p ] [ -s ] Command

Description

The timex command reports, in seconds, the elapsed time, user time, and system execution time for a command. With specified flags, the timex command lists or summarizes process accounting data for a command and all of its children. Command is the name of any executable file on the system. It also reports total system activity during the execution interval. Output is written to standard error. The system uses the /var/adm/pacct file to select process records associated with the command and includes background processes with the same user ID, workstation ID, and execution time window.

Flags

Item	Description
-o	Reports the total number of blocks read or written and total characters transferred by a command and all its children.
-p	Lists process accounting records for a command and all its children. The number of blocks read or written and the number of characters transferred are reported. The -p flag takes the f, h, k, m, r, and t arguments defined in the acctcom command to modify other data items. -f Print the fork/ exec flag and system exit status columns in the output. -h Instead of mean memory size, shows the fraction of total available CPU time consumed by the process (hogfactor). -k Instead of memory size, shows total kcore minutes (memory measurement in kilobyte segments used per minute of run time). -m Shows mean main-memory size. This is the default. The -h flag or -k flag turn off the -m flag. -r Shows CPU factor. -t Shows separate system and user CPU times.
-s	Reports total system activity during the execution of the command. All the data items listed in the sar command are reported.

Note: Accounting must be turned on to use the -o or -p flags.

Examples

To report the total number of blocks read and total characters transferred by the ls command, enter:
```
timex -o ls
```
To list the process accounting records for the ps command, enter:
```
timex -p ps -fe
```
To report total system activity for the execution of the ls command, enter:
```
timex -s ls
```

Files

Item	Description
/var/adm/pacct	Used to select record associated with the command.