 |
» |
|
|
|
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= ] { workgroup
NATURAL_WG }]
[{ ;TREE
;NOTREE }]
[{ ;USER
;ANYUSER }]
[;SYSTEM]
|
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 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 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: 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)
|
