Manually assigns processes to a workload management class or cancels prior manual assignments for processes.
wlmassign [ -s | -S ] [ -u | Class_Name ] [ pid_list ] [ -g pgid_list ]
wlmassign [ -t { tag [ -i inheritance ] | -r } [ pid_list ] [ -g pgid_list ]
The wlmassign command:
In addition to the tag, additional inheritance suboptions can be specified and these suboptions indicates to the WLM if a child process must inherit the tag from its parent after fork or exec subroutine.
The process requires at least the SIGPRIV privileges or higher for tagging another process.
The WLM tag assignment remains in effect until one or more of the following conditions are true:
When a WLM tag is assigned to a process that belongs to a class that has the inheritance property turned off, it is automatically reclassified according to the current assignment rules and the new tag is taken into account during reclassification. The WLM tag is effective if class inheritance attribute is not specified for the current process class. To override the class inheritance attribute in favor of reclassification based on tag rules, the /usr/samples/kernel/wlmtune command available in the bos.adt.samples PTF, can be used to modify the behavior of WLM. The related tunables follow:
For the tag assignment rules-based classification to be effective, the tunable values must be set prior to a WLM reclassification update.
The interactions between automatic assignment (inheritance and rules), inheritance, and manual assignment are detailed in the Workload management in AIX® Version 7.1 Operating system and device management.
pid[,pid[,pid[...]]]
pgid[,pgid[,pgid[...]]]
The name of a valid superclass or subclass must be specified to manually assign the target processes to a class. If the target class is a superclass, each process is assigned to one of the subclasses of the specified superclass according to the assignment rules for the subclasses of this superclass.
A manual assignment remains in effect (and a process remains in its manually assigned class) until:
The name of a valid superclass or subclass must be specified to manually assign the target processes to a class. The assignment can be done or canceled at the superclass level, the subclass level or both. When a manual assignment is canceled for a process, or the process calls exec(), the process is then subject to automatic classification; if inheritance is enabled for the class that the process is in, it will remain in that class, otherwise the process will be reclassified according to the assignment rules. The interactions between automatic assignment (inheritance and rules), inheritance and manual assignment are detailed in the Workload management in AIX Version 7.1 Operating system and device management.
For a manual assignment:
wlmassign super1.sub2 -S pid1
is equivalent to:
wlmassign super1 pid1
To assign a process to a class or cancel a prior manual assignment, the user must have authority both on the process and on the target class. These constraints translate into the following:
This defines 3 levels of privilege among the persons who can manually assign processes to classes, root being the highest. For a user to modify or terminate a manual assignment, they must have at least the same level of privilege as the person who issued the last manual assignment.
Item | Description |
---|---|
-g pgid_list | Indicates that the following list is a list of PGID. |
-S | Specifies that the assignment is to be done or canceled at the superclass level only. This flag is used with a subclass name of the form supername.subname. |
-s | Specifies that the assignment is to be done or canceled at the subclass level only. This flag is used with a subclass name of the form supername.subname. |
-u | Cancel any manual assignment in effect for the processes in the pid_list or the pgid_list. If none of the -s or -S flags are used, this cancels the manual assignments for both the superclass and the subclass level. |
-r | Removes a WLM tag from the specified process or the process group list. |
-t tag | Sets a WLM tag for the specified process or the process group list. |
-i inheritance | Specifies one or both tag inheritance sub-options in a comma-separated list. The following tag inheritance sub-options can be specified:
|