ISchedulerJob::Priority property

Retrieves or sets the job priority.

This property is read/write.

Syntax

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.

Remarks

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.

Requirements

See also

ISchedulerJob

ISchedulerJob::ExpandedPriority