xmwlm Command

Purpose

Provides recording of system performance or WLM metrics.

Syntax

xmwlm [ -d recording_dir ] [ -n recording_name ] [ -t trace_level ] [ -L ]

Description

The xmwlm agent provides recording capability for a limited set of local system performance metrics. These include common CPU, memory, network, disk, and partition metrics typically displayed by the topas command. Daily recordings are stored in the /etc/perf/daily directory. The topasout command is used to output these recordings in raw ASCII or speadsheet format. The xmwlm agent can also be used to provide recording data from Workload Management (WLM). This is the default format used when xmwlm is run without any flags. Daily recordings are stored in the /etc/perf/wlm directory. The wlmmon command can be used to process WLM-related recordings. The xmwlm agent can be started from the command line, from a user script, or can be placed near the end of the /etc/inittab file. All recordings cover 24-hour periods and are only retained for seven days by default. You can configure the retain value in the /usr/lpp/perfagent/daily.cf file to change the default recording duration.

Flags

Item Description
-d recording_dir Specifies the output directory for the recording files. The default location is /etc/perf/wlm when xmwlm is run without any flags and /etc/perf/daily when xmwlm is run with the -L flag.
-L Specifies the collection of topas-like metrics. The metric set is not user configurable.
-n recording_name Specifies the name for the recording file. By default, xmwlm creates recording files named in an xmwlm.YYMMDD format. For example, if -n myrecording is specified, the recording files will be named myrecording.YYMMDD.
-t trace_level Specifies a trace level. xmwlm prints various information to a log file in the appropriate /etc/perf subdirectory. The trace level can be set from 1 to 9. More trace data is generated at higher trace levels. This trace data is useful to determine xmwlm recording status and for debugging purposes. The log file name is xmwlm.log1 or xmwlm.log2. xmwlm cycles between these two files after a file reaches the maximum allowable size.

Session Recovery by xmwlm

If the xmwlm agent is terminated and restarted, xmwlm examines the recording files in the appropriate /etc/perf subdirectory or in the directory specified by the -d flag. If a recording file exists with the current date, xmwlm appends data to this file and continues to write to the recording file. Otherwise, a new recording file is created.

Location

/usr/bin/xmwlm

Files

Item Description
/usr/bin/xmwlm Contains the xmwlm agent. The agent is part of the perfagent.tools fileset.