TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-18
#ALTERPRIORITY Built-In Function
#ALTERPRIORITY Built-In Function
Use #ALTERPRIORITY to change the priority of a process or process pair. This
function invokes the ALTERPRIORITY operating system procedure.
\node-name
is the system where the process resides.
$process-name
is the name of the process or process pair.
cpu,pin
is the CPU number and process number for the process.
pri
is the new execution priority of the process. Specify pri as an integer in the range 1
to 199. (Processes with higher numbers are executed first.)
Result
#ALTERPRIORITY returns a nonzero integer if it is successful; otherwise, it returns
zero.
Considerations
•
If you do not specify a process, #ALTERPRIORITY changes the priority of the
process last started by the current TACL or for which TACL most recently paused,
if that process still exists. That process is called the default process. To retrieve the
default process, use the #PROCESS built-in function. If there is no default process,
you must include a process specification or an error will result.
•
The super ID can change the priority of any process in the system.
•
A group manager can alter the priority of any process whose process accessor ID
matches any user ID in the group.
•
Standard users can change the priority of only those processes whose process
accessor IDs match their user ID. (For a description of process accessor IDs and
creator accessor IDs, see the Guardian User’s Guide.)
•
Before increasing the priority of a process, carefully consider the effect the change
might have on system performance. For example, assigning a high priority to CPU-
bound processes, such as those involving lengthy arithmetic computations, can
significantly degrade system performance.
•
If a CMON process is running, it can affect the range of priorities you can specify.
For more information, see the RUN[D|V] Command
on page 8-156.
#ALTERPRIORITY [ [\node-name.]{$process-name | cpu,pin} ] pri