[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 6
wlmcheck command
Purpose
Check automatic assignment rules and/or determines
the Workload Management 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 Management (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
-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. |
-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. |
-q |
Suppresses the output of the status of the latest activation/update
of WLM and of messages logged by the WLM daemon (quiet mode). |
Files
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. |
Related Information
The chclass command, lsclass command, mkclass command, rmclass command.
The rules file.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]