ISchedulerJob::Priority property

Retrieves or sets the job priority.

This property is read/write.


HRESULT put_Priority(
  [in]  JobPriority priority

HRESULT get_Priority(
  [out] JobPriority *pPriority

Property value

The job priority. For possible values, see the JobPriority enumeration.

Error codes

If the method succeeds, the return value is S_OK. Otherwise, the return value is an error value. To get a description of the error, access the ISchedulerJob::ErrorMessage property.


The Default job template sets the default value to JobPriority_Normal.

Server resources are allocated to jobs based on job priority, except for backfill jobs. Jobs can be preempted if the ISchedulerJob::CanPreempt property is VARIANT_TRUE; otherwise, jobs run until they finish, fail, or are canceled.

Within a job, tasks receive resources based on the order in which they were added to the job. If a resource is available, the task will run.

In Windows HPC Server 2008 R2, you can use the ISchedulerJob::ExpandedPriority property to set priority values over a scale of 4000 values instead of 5 values. If you set the values of both the ISchedulerJob::Priority and ISchedulerJob::ExpandedPriority properties, the property that you set last determines the priority of the job. When you set the value of one of these properties, the value of the other property is automatically updated to the equivalent value.



HPC Pack 2008 R2 Client Utilities, HPC Pack 2008 Client Utilities

Type library


See also