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
| Flag name | Description |
|---|---|
| -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 -interval flag is not specified, the default value is 5 minutes. |
| -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 the /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
| Return code | Description |
|---|---|
| 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
