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
Flag name | Description |
---|---|
-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