68 Chapter 2
Command Definitions A-B
ALTPROC
priority specified need not fall between the base and limit priorities of
the workgroup. To assign an absolute priority value, you must have SM
capability.
If you do not have SM capability, then your MAXPRI value represents the
highest priority that you can assign a process. A warning appears when
the specified priority exceeds MAXPRI. MAXPRI is ignored for System
Manager (SM) capability.
workgrp A workgroup value {workgrp} moves the target process(es) to the specified
workgroup. A process moved in this manner is considered an artificial
member of the workgroup (the process was placed in workgroup explicitly,
rather than naturally by meeting the membership criteria specified for the
workgroup).
A process remains an artificial member of its assigned workgroup until
either the workgroup is purged or the process' explicit assignment is
changed (via ALTPROC or an AIF call). An artificial member is not affected
by a system-wide scan or by the changing of its process attributes used
to determine workgroup membership. A workgroup specification requires
SM capability and can only be used to modify the workgroup assignment of
user processes.
You cannot specify both the ;WG= and ;PRI= in the ALTPROC command
line. Workload Manager users should use ;WG= instead of ;PRI=.
NATURAL_WG The natural workgroup specification {NATURAL_WG} releases one or more
process(es) from their explicit workgroup assignment, allowing them to
migrate to their natural workgroup. A natural workgroup specification
requires SM capability.
TREE This option alters each process specified as well as all of its descendants.
TREE is the default for all jobspec target processes. If you specify both TREE
and SYSTEM, you will see a warning that TREE will be ignored.
NOTREE This option alters only the processes specified. Descendant processes will
not be altered. NOTREE is the default for all pinspec target processes.
USER The USER option applies only when jobspec is wildcarded. It alters only
processes matching the user's name. USER is the default.
ANYUSER The ANYUSER option applies only when jobspec is wildcarded. It alters all
jobspec target processes, regardless of their owners.
SYSTEM Use the SYSTEM option if the target process specified in pinspec is a system
process. SM capability is required for the SYSTEM option. SYSTEM is
ignored for all jobspec processes and when you specify a workgroup or
natural workgroup. If you specify both SYSTEM and TREE, you see a
warning that TREE will be ignored.
CAUTION Exercise extreme care when altering system processes since doing so can
significantly degrade system efficiency.
