topasrec command

Purpose

Generates a binary recording of local system statistics, central electronics process (CEC) statistics, and cluster statistics.

Syntax

topasrec { -local [ -trace trace_level] | -cec | -cluster} [ -count sample_count] [ -interval seconds] [ -out filename ]

Description

The topasrec command records the local system data and the cross-partition data (CEC statistics) in binary format.

When you run the topasrec command to record CEC statistics, the command collects a set of metrics from the AIX® logical partitions that are running on the same CEC. The command collects dedicated and shared logical partition data, as well as a set of aggregated values to provide an overview of the partition set on the same CEC.

When you run the command to record cluster statistics, the command collects a set of metrics for the list of hosts that are specified in the cluster configuration file.

Flags

-count	Specifies the number of records to generate.
-interval	Specifies the recording interval in seconds. The default is 2 seconds.
-out	Specifies the name of the output file.
-cec	Records the CEC statistics in binary format.
-local	Records local system statistics in binary format.
-cluster	Records cluster statistics in binary format.
-trace	Specifies a trace level. Trace data is stored under /home/padmin/.topasrec. You can specify a value from 1 - 9. More trace data is generated at higher trace levels. This data is useful for recording status and for debugging purposes. Trace data is collected only for local system recording.

Exit Status

Return Code	Description
0	Success
>0	An error occurred

Examples

To start recording local system statistics with a sample count of 5 and a sample interval of 60 seconds, type:
```
topasrec -local -count 5 -interval 60
```
To start recording CEC statistics with a sample count of 5 and a sample interval of 60 seconds, type:
```
topasrec -cec -count 5 -interval 60
```
To start recording cluster statistics with a sample count of 5 and a sample interval of 60, type:
```
topasrec -cluster -count 5 -interval 60
```

Related Information

The wkldout command.