ICluster.RequeueJobs Method

Article
04/17/2009

Queues one or more specified jobs again.

Namespace: Microsoft.ComputeCluster
Assembly: CcpAPI (in ccpapi.dll)

Usage

Syntax

'Declaration
Sub RequeueJobs ( _
    jobIds As IClusterEnumerable _
)

void RequeueJobs (
    IClusterEnumerable jobIds
)

void RequeueJobs (
    IClusterEnumerable^ jobIds
)

void RequeueJobs (
    IClusterEnumerable jobIds
)

function RequeueJobs (
    jobIds : IClusterEnumerable
)

Parameters

jobIds
A class that implements the IClusterEnumerable interface. The collection contains integers that identify one or more jobs to queue again. The Cluster.AddJob method returns the identifier. If you have a job object that has already been added to the cluster, you can access the Job.Id property to get the identifier.

Remarks

Typically, you call this method if tasks in the jobs have failed for similar reasons, you fixed the cause of the failure, and you want to try running the tasks again. Canceled tasks are not rerun; only failed tasks are rerun. To rerun canceled tasks, you must call the ICluster.RequeueTask method.

If you call this method while tasks are running, the tasks are canceled. You cannot call this method for a completed job.

If this method fails to queue a job, all subsequent jobs in the collection are also not queued. Jobs that were queued before the failure remain queued.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Microsoft Windows Compute Cluster Server 2003, Windows Server 2003, Windows XP

Target Platforms

Microsoft Windows Compute Cluster Server 2003, Windows Server 2003 with Compute Cluster Pack Client Utilities, Windows XP with Compute Cluster Pack Client Utilities