wlmcntrl Command

Commands Reference, Volume 6

wlmcntrl Command

Purpose

Starts or stops Workload Management.

Syntax

wlmcntrl [ [-d Config_dir] [ -u | -o | -q ]

Description

The wlmcntrl command loads the WLM properties files and starts the workload management subsystem.

The classes, their limits and shares are described respectively in the files classes, limits and shares. The automatic assignment rules are taken from the rules file. These files are normally located in a subdirectory of /etc/wlm. The standard configuration shipped with AIX is in /etc/wlm/standard. The current configuration is the one in the directory pointed to by the symbolic link /etc/wlm/current.

When the -d Config_dir option is not used, wlmcntrl uses the configuration files in the directory pointed to by the symbolic link /etc/wlm/current.

When the -d Config_dir option is used, wlmcntrl uses the configuration files in /etc/wlm/Config_dir and updates the /etc/wlm/current symbolic link to point to /etc/wlm/Config_dir, making /etc/wlm/Config_dir the current configuration. This is the recommended way to make /etc/wlm/Config_dir the current configuration.

Flags

-d Config_dir	Use /etc/wlm/Config_dir as an alternate directory for the classes, limits, shares and rules files, and makes /etc/wlm/Config_dir the current configuration.
-u	Update: request to load more classes, or change the limits or shares of the running classes. Classes cannot be removed in this way.
-o	Stops workload management.
-q	Query WLM state: returns 0 if WLM is running, else returns 1.

Files

/etc/wlm/current/classes	Contains the names and definitions of the classes for the current workload management configuration.
/etc/wlm/current/limits	Contains the resource limits enforced on the classes for the current workload management configuration.
/etc/wlm/current/rules	Contains the automatic assignment rules for the current workload management configuration.
/etc/wlm/current/shares	Contains the resource shares allocated to the classes for the current workload management configuration.
/etc/wlm/current/description	Contains the class description text for each class.

Related Information

The chclass, lsclass, mkclass, rmclass commands.