Commands Reference, Volume 6

wlmassign command

Purpose

Manually assigns processes to a Workload Management class or cancels prior manual assignments for processes.

Syntax

wlmassign [ -s | -S ] [ -u | Class_Name ] [ PID_List ] [ -g Pgid_List ]

Description

The wlmassign command:

• Assigns a set of processes specified by a list of process identifiers (pids) and/or process group identifiers (pgids) to a specified superclass or subclass or both, thus overriding the automatic class assignment or a prior manual assignment.
• Cancels a previous manual assignment for the processes specified in pid_list or pgid_list.

The wlmassign command allows to specify processes using a list of PIDs, a list of pgids, or both. The format of these lists is:

pid[,pid[,pid[...]]]

or

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 process terminates
• Workload Management (WLM) is stopped. When WLM is restarted, the manual assignments in effect when WLM was stopped are lost.
• The class the process has been assigned to is deleted
• A new manual assignment overrides a prior one.
• The manual assignment for the process is canceled using the -u flag.
• The process calls the exec() routine.

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 concept article in AIX 5L Version 5.2 System Management Concepts: Operating System and Devices.

For a manual assignment:

• If the Class_Name is the name of a superclass, the processes in the list are assigned to the superclass. The subclass is then determined, for each process, using the assignment rules for the subclasses of the target superclass.
• If the class name is a subclass name (supername.subname), the processes by default are assigned to both the superclass and the subclass. The processes can be assigned to the superclass only by specifying the -S flag or the subclass only by specifying the -s flag.

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:

• The root user can assign any process to any class.
• A user with administration privileges on the subclasses of a given superclass (that is, the user or group name matches the user or group names specified in the attributes adminuser and admingroup of the superclass) can manually reassign any process from one of the subclasses of this superclass to another subclass of the superclass.
• Users can manually assign their own processes (same real or effective user ID) to a class, for which they have manual assignment privileges (that is, the user or group name matches the user or group names specified in the attributes authuser and authgroup of the superclass or subclass).

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.

Flags

Related Information

The chclass command, lsclass command, mkclass command, and rmclass command.

The concept article about Worldload Management in AIX 5L Version 5.2 System Management Concepts: Operating System and Devices.