ISchedulerTask::RequiredNodes property

Retrieves or sets the list of required nodes for the task.

This property is read/write.

Syntax

HRESULT get_RequiredNodes(
  [out] IStringCollection **pNodes
);

Property value

Error codes

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

Remarks

The list specifies the nodes on which the task can run. The list of required nodes must be a subset of the nodes in the RequestedNodes job property, if set.

You cannot specify required nodes if the ISchedulerJob.AutoCalculateMax and ISchedulerJob.AutoCalculateMin properties are set to VARIANT_TRUE.

The number of nodes in the required nodes list cannot exceed the maximum resource usage specified for the job.

Requirements

Product

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

Type library

Microsoft.Hpc.Scheduler.tlb

See also

ISchedulerJob.RequestedNodes

ISchedulerTask

ISchedulerTask.AllocatedNodes