Guardian Procedure Calls Reference Manual

PRIORITY Procedure (Superseded by PROCESS_SETINFO_ Procedure or
PROCESS_GETINFOLIST_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The PRIORITY procedure enables a process to examine or change its initial priority. The current
priority is updated to the initial priority value when the process waits for an external event to occur.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
old-priority := PRIORITY ( [ new-priority ] ! i
,[ init-priority ] ); ! o
Parameters
new-priority
input
INT:value
specifies a new execution priority value in the range {1:199} for this process. If omitted, the
initial priority remains unchanged.
init-priority
output
INT:ref:1
returns the initial run priority of the process when it was started.
Returned Value
INT
The current priority of the process if new-priority is not specified, or the previous value of the
current priority when new-priority is specified.
If the specified new-priority value is out of range and that priority was not changed, a value
of 0 is returned.
980 Guardian Procedure Calls (P)