wlmcheck command

Purpose

Check automatic assignment rules and/or determines the Workload Manager class a process with a specified set of attributes would be classified in.

Syntax

wlmcheck [ -d Config] [ -a Attributes ] [ -q ]

Description

The wlmcheck command with no arguments, gives the status of Workload Manager (WLM) and makes some coherency checks:

  • Displays the current status of WLM (running/non running, active/passive, rsets bindings active, total limits enabled).
  • Displays the status files that report the last loading errors, if any. If 'current' configuration is a set, this applies to all configurations in the set, and messages logged by the WLM daemon are reported.
  • Checks the coherency of the attributes and assignment rules file(s) (such as, the existence of the classes, validity of user and group names, existence of application file names, etc).

If the -d Config flag is not specified, the checks are performed on the 'current' configuration.

The wlmcheck command can apply to a configuration set. In this case, the checks mentioned above are performed on all configurations of the set, after checking the set itself. Superclass names are reported in the form 'config/superclass' to indicate the regular configuration which they belong to.

Specifying a configuration with -d Config performs the checks on the Config configuration or set instead of 'current'. This does not change the reporting of status files and of the WLM daemon log, which only applies to the active configuration.

With the -a flag, wlmcheck displays the class that the process with attributes specified by Attributes would be assigned to, according to the rules for the current or specified configuration or configuration set. The format of the Attributes string is similar to an entry in the rules file, with the following differences:

  • The class field is omitted (it is actually an output of wlmcheck)
  • Each field can have at most one value. Exclusion (!), attribute groupings ($), comma separated lists, and wild cards are not allowed. For the type field, the AND operator "+" is allowed, since a process can have several of the possible values for the type attribute at the same time. For instance a process can be a 32 bit process and call plock, or be a 64 bit fixed priority process.
  • At least one field must be specified (have a value different from a hyphen (-).

In addition, the first 2 fields are mandatory. The other fields, if not present default to a hyphen (-) which mean that any value in the corresponding field of an assignment rule is a match. When one or more of the fields in the attribute string are either not present or specified as a hyphen (-), the string is likely to match more than one rule. In this case, wlmcheck displays all the classes corresponding to all the possible matches.

Example of valid attribute strings:

$ wlmcheck -a "- root system /usr/lib/frame/framemaker - -"
$ wlmcheck -a "- - staff - 32bit+fixed"
$ wlmcheck -a "- bob"

Flags

Item Description
-a Attributes Passes a set of values for the classification attributes of the process in order to determine which class the process would be put into. This is a way to check that the assignment rules are correct and classify processes as expected.
-d Config Uses the WLM property files in /etc/wlm/Config (which may indicate a set of time-based configurations) instead of /etc/wlm/current.
-q Suppresses the output of the status of the latest activation/update of WLM and of messages logged by the WLM daemon (quiet mode).

Security

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Files

Item Description
classes Contains the names and definitions of the classes.
limits Contains the resource limits enforced on the classes.
rules Contains the automatic assignment rules.
shares Contains the resource shares allocated to the classes.