wkldout command

Purpose

Provides post-processing of the recordings made by the Workload Manager Agent (wkldagent).

Syntax

wkldout [-report reportType] [ -interval MM] [-beg HHMM] [ -end HHMM] [ -fmt [ -mode modeType] ] [ -graph] [ -BinToAscii] -filename <xmwlm_recording_file>

Description

The wkldout command provides post-processing of recordings made by wkldagent. It can generate reports in ASCII or spreadsheet format. The output can be formatted by using the flags detailed, summary, disk or LAN. The time interval can be specified to process the xmwlm file for a particular interval.

Flags

-report report <type>	Generates the report based on the type specified. The report type can be detailed, summary, LAN, or disk. The detailed report type produces the comprehensive output of the xmwlm file and displays the report on the screen. The summary report tpye produces the abstract output of the xmwlm file and displays on the report on the screen. The LAN report type generates the summary output related to system LAN from the given xmwlm file and displays on the report on the screen. The disk report type generates I/O summary information and generates the xmwlm file and displays on the report on the screen.
-interval MM	Specifies how the recording reports are split into equal size time periods. Allowed Values (in minutes) are 5, 10, 15, 30, 60. If -i flag is not specified, a 5 minute interval is taken by default.
-beg HHMM	Indicates the beginning time in hours (HH) and minutes (MM). The range is between 0000 and 2400.
-end HHMM	Indicates the ending time in hours (HH) and minutes (MM). The range is between 0000 and 2400 and is greater than the begin time.
-fmt	Generates a spreadsheet format output in a file under /home/ios/perf/wlm in the format xmwlm.YYMMDD_01.
-mode <type>	Specifies the post-processor only output mean values by default. Other values and the full set are available via other options (min, max, mean, stdev, set).
-graph	Generates the csv file under /home/ios/perf/wlm in the format xmwlm.YYMMDD.csv, which can be sent to the Nmon analyzer to produce graphs to help analyze and write reports. The Nmon analyzer requires Excel 2002 or later.
-BinToAscii	Converts the recording data from binary to ASCII text format and stores the output in /var/perf/pm/daily/ directory.
-filename <name>	Name of the wkldagent recording file. These files will be generated by the wkldagent command and resides in /home/ios/perf/wlm in the format xmwlm.YYMMDD

Exit Status

0	The command completed successfully
>0	An error occurred.

Examples

To display the system summary from xmwlm.070731, type the following command :
```
wkldout  -report summary -filename /home/ios/perf/wlm/xmwlm.070731
```
To display the detailed report of the system from xmwlm.070731, type the following command:
```
wkldout  -report detailed -filename /home/ios/perf/wlm/xmwlm.070731
```
To display the disk I/O summary from xmwlm.070731, type the following command:
```
wkldout  -report disk -filename /home/ios/perf/wlm/xmwlm.070731
```
To display the system lan summary from xmwlm.070731, type the following command:
```
wkldout  -report lan -filename /home/ios/perf/wlm/xmwlm.070731
```
To produce the csv file from xmwlm.070731, type the following command:
```
wkldout  -graph  -filename /home/ios/perf/wlm/xmwlm.070731
```
To display the system summary from xmwlm.070731 with time interval 10 min, type the following command:
```
wkldout  -report summary -interval 10  -filename /home/ios/perf/wlm/xmwlm.070731
```
To display the detailed report from xmwlm.070731, starting at 01:00 Hr and ending 02:00 Hr, type
```
wkldout -report detailed -beg 0100 -end 0200 
-filename /home/ios/perf/wlm/xmwlm.070731
```
To convert the file xmwlm.090610 from binary to ASCII format, type:
```
wkldout -BinToAscii -filename /home/ios/perf/wlm/xmwlm.090610
```

Related Information

The topas command, the wkldmgr command, and the wkldagent command.