PROCESS SET PRIORITY statement

Purpose

Sets the Priority Value for the current process.

Syntax

PROCESS SET PRIORITY Priority&

Remarks

PROCESS SET PRIORITY assigns a new priority value to the current process.

The process priority value must be one of the following:

%IDLE_PRIORITY_CLASS     = &H00000040

Indicates a process whose threads run only when the system is idle and are preempted by the threads of any process running in a higher priority class. An example is a screen saver. The idle priority class is inherited by child processes.

%NORMAL_PRIORITY_CLASS   = &H00000020

Indicates a normal process with no special scheduling needs.

%HIGH_PRIORITY_CLASS     = &H00000080

Indicates a process that performs time-critical tasks that must be executed immediately for it to run correctly. The threads of a high-priority class process preempt the threads of normal or idle priority class processes. An example is Windows Task List, which must respond quickly when called by the user, regardless of the load on the operating system. Use extreme care when using the high-priority class, because a high-priority class CPU-bound application can use nearly all available cycles.

%REALTIME_PRIORITY_CLASS = &H00000100

Indicates a process that has the highest possible priority. The threads of a real-time priority class process preempt the threads of all other processes, including operating system processes performing important tasks. For example, a real-time process that executes for more than a very brief interval can cause disk caches not to flush or cause the mouse to be unresponsive.

See also

PROCESS GET PRIORITY, THREAD GET PRIORITY, THREAD SET PRIORITY