HP 3000 Manuals HP 3000 Manuals
ALTPROC
Changes characteristics of the specified processes. Currently, a
process' priority, queue attribute, and workgroup may be changed.
(Native Mode)
SYNTAX
[[PIN=]{pinspec } ]
[ {(pinspec [,pinspec]...)} ] [[;PRI=] pri ]
ALTPROC [ ] [[;WG=]{workgrp }]
[[;JOB=]{jobspec }] [ {NATURAL_WG}]
[ {(jobspec [,jobspec]...)}]
[{;TREE }] [{;USER }] [;SYSTEM]
[{;NOTREE}] [{;ANYUSER}]
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:
@S - all sessions
@J - all jobs
@ - 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.
:ALTPROC job=@j;pri=cs
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 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.
__________________________________________________________
__________________________________________________________
NOTE Avoid using the ;PRI= option to explicitly change a
process. If you have created user-defined workgroups
that have ;MEMB_QUEUE as membership criteria, use of
the ;PRI= option may change the workgroup. Instead,
use either the ;WG=workgrp or ;WG=NATURAL_WG option,
explained below, to move target processes into
existing workgroups.
Using ;WG= to explicitly change a workgroup should be
a temporary measure, and used rarely. Instead,
adjust workgroup membership criteria to ensure that
desired processes become natural members of the
workgroup.
If you specify both the ;WG= and ;PRI= in the ALTPROC
command line, you will get an error.
__________________________________________________________
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 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 its
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
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 specified membership attributes as well), 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:
:ALTPROC 0;pri=CM
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 (32650-90028)