Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)

Guardian Procedure Calls Reference Manual—522629-013

2-33

ALTERPRIORITY Procedure

(Superseded by PROCESS_SETINFO_ Procedure )

.<8:15> PIN assigned by the operating system to identify the process in the

processor

process-id [0:2] references a process pair and process-id [3] is specified as

-1, then the call applies to both members of the process pair.

priority input

INT:value

is a new execution priority value in the range of {1:199} for

process-id.

Condition Code Settings

< (CCL) indicates that ALTERPRIORITY failed, or no process designated as

process-id exists.

= (CCE) indicates that the priority of the process is altered.

> (CCG) does not return from ALTERPRIORITY.

Considerations

When ALTERPRIORITY is called on a Guardian process, the caller must be either the

super ID (255,255), the group manager (n,255) of the process access ID, or a process

with the same process access ID as the process or process pair whose priority is being

changed. Refer to “Considerations” for the PROCESSACCESSID procedure and to

the

Guardian User’s Guide for further information about the process access ID.

When ALTERPRIORTY is called on an OSS process, the security rules that apply are

the same as those that apply to calling the OSS

kill() function. See the kill(2)

function reference pages either online or in the

Open System Services System Calls

Reference Manual for details.