MPE/iX Commands Reference Manual (32650-90877)

60 Chapter3
Command List I
Commands ABORT to BYE
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:
:ALTPROC 0;pri=CM
To alter all processes logged on as mgr.payroll to linear 155 (SM capability required),
enter: