 |
» |
|
|
|
Changes characteristics of the specified processes. Currently,
a process' priority, queue attribute, and workgroup may be changed.
(Native Mode) Syntax | |
ALTPROC[ [ PIN=] { pinspec (pinspec [ ,pinspec ] ...) } [ ;JOB=] { jobspec (jobspec [ ,jobspec ] ...) } ] |
[ [ ;PRI=] pri [ ;WG= ] { workgrp NATURAL_WG } ] |
Parameters | |
- pinspec
The process(es) you want to alter. This is a required
parameter, unless you specify jobspec.
If you omit both, you will get an error. The pinspec, expressed [#p ]pin,
is a Process Identification Number (PIN). If pinspec
is 0, then the caller's pin is used. To alter system processes,
you must have SM capability and specify the SYSTEM
option. NOTREE
is the default for all pinspec target
processes, and can be overridden with the TREE
option. The USER
and ANYUSER options
do not apply to pinspec. - jobspec
The name of the job or session whose processes are
to be altered. A jobspec can be any of
the following, jobnumber, username, @S, @J, or @. The jobnumber must be in the form
of either #Jnnn or #Snnn. The username must be in the form user[.account].
If there is more than one job/session matching the same username,
they will all be altered. Wildcards have the following meanings: @ - all sessions and jobs
The USER
and ANYUSER options
apply only to jobspec and only if jobspec
is wildcarded. The USER
option, which is the default, alters only processes matching the
user's name, while the ANYUSER
option alters all processes matching the wildcarded jobspec.
For example, if the user's name is STEVE.UI and you enter the command
shown below, then only job processes logged on as STEVE.UI are altered. However, if you add anyuser
to the same command as shown below, then all job processes are altered. :ALTPROC job=@j;pri=cs;anyuser |
TREE is
the default for all jobspec target processes,
and can be overridden with the NOTREE
option. The SYSTEM
option is ignored for all jobspec target
processes. The jobspec is optional as long
as a pinspec is supplied. If both are
omitted, an error is reported. - pri
The queue or absolute priority for the process.
If omitted, the priority is unchanged. | | | |  | CAUTION: Exercise extreme caution when altering a process's
priority, scheduling queue attribute, or workgroup membership. Such
a change can significantly impact system performance. | | | | |
The pri value may be one of the
following: A scheduling queue value {BS,CS,DS,ES}
sets the queue attribute of the target process(es). If a user-defined
workgroup does not capture the process, then the process will fall
into to the corresponding system-defined default workgroup at the
base priority (subject to decay as it consumes CPU). To assign a
scheduling queue value, you must have OP capability. A queue manager value {BM,CM,DM,EM} sets the queue
attribute of the target process(es). If a user-defined workgroup
does not capture the process, then the process will fall into the
corresponding system-defined default workgroup at the base priority
(non-decayable). To assign a queue manager value, you must have
SM capability. An absolute priority {nnn}
sets the priority of the process to the specified value that will
not decay. The workgroup of the process will not be changed (the
process will have the same timeslice value). Note that the 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. | | | | |
Operation Notes | |
To execute the ALTPROC
command, you must have System Supervisor (OP) or System Manager
(SM) capability. SM capability is necessary to alter system processes,
for the WG= option,
for certain specifications to the PRI
option, and to increase a process' priority above MAXPRI.
You may issue the ALTPROC
command from a session, job, program, or while in BREAK. Pressing
Break aborts the execution of
this command. Example | |
To alter process 605, and its current descendants, so that
their priorities execute within the DS_Default workgroup, enter: :ALTPROC #p605; tree; wg=DS_Default |
To alter process 605, and its current descendants, so that
their scheduling queue attribute is DS, enter: :ALTPROC #p605; tree; pri=DS |
The outcome of this command is not necessarily identical to
the outcome achieved with the previous command. If the system was
configured with a user-defined workgroup that captured the processes
(MEMB_QUEUE=DS
and a match on other membership attributes, if specified), then
the processes would be a member of the user-defined workgroup rather
than the DS_Default workgroup. To alter all job processes to the CS_Default workgroup, enter: :ALTPROC job=@j; wg=CS_Default; anyuser |
To return the processes modified by the previous example to
their natural workgroup(s), enter: :ALTPROC job=@j; wg=NATURAL_WG; anyuser |
To alter all job processes matching the user's name to the
CS_Default workgroup, enter: :ALTPROC job=@j; wg=CS_Default; user |
To alter the current process' priority so that it behaves
like a CS queue manager (SM capability required), enter: To alter all processes logged on as mgr.payroll to linear
155 (SM capability required), enter: :ALTPROC job=mgr.payroll; pri=155 |
To alter the queue attribute of pins 150, 247, 211 to be ES,
enter: :ALTPROC (150,#p247,211); pri=ES |
Related Information | |
- Commands
SHOWPROC,
TUNE, SHOWQ,
NEWWG, ALTWG,
PURGEWG, SHOWWG - Manuals
MPE/iX Intrinsics Reference Manual Using the HP 3000 Workload Manager
|
