timex Command

AIX Version 4.3 Commands Reference, Volume 5

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

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

/var/adm/pacct

Used to select record associated with the command.

Related Information

The acctcom command, sar command, time command.

Setting Up an Accounting System in AIX Version 4.3 System Management Guide: Operating System and Devices describes the steps you must take to establish an accounting system.

See the Accounting Commands in AIX Version 4.3 System Management Guide: Operating System and Devices for a list of accounting commands that can be run automatically or entered from the keyboard.

For more information about the Accounting System, the preparation of daily and monthly reports, and the accounting files, see the Accounting Overview in AIX Version 4.3 System Management Guide: Operating System and Devices.

AIX Performance Monitoring and Tuning Commands in AIX Versions 3.2 and 4 Performance Tuning Guide.