ISchedulerJob::NodeGroups property

Retrieves or sets the names of the node groups that specify the nodes on which the job can run.

This property is read/write.

Syntax

HRESULT get_NodeGroups(
  [out] IStringCollection **pNodeGroups
);

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 ISchedulerJob::ErrorMessage job property.

Remarks

A node group is typically created to identify a group of nodes with a similar characteristic. For example, nodes that contain a specific software license. You can then use this property to identify the nodes instead of having to specify each node using the ISchedulerJob::RequestedNodes property.

If you specify multiple node groups, the resulting node list is the intersection of the groups. For example if group A contains nodes 1, 2, 3, and 4 and group B contains nodes 3, 4, 5, and 6, the resulting list is 3 and 4.

If you also specify nodes in the RequestedNodes property, the list of nodes on which the job may run is the intersection of the requested node list and the resulting node group list.

Requirements

Product

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

Type library

Microsoft.Hpc.Scheduler.tlb

See also

ISchedulerJob

IScheduler::GetNodeGroupList

IScheduler::GetNodesInNodeGroup