ICluster.RequeueTasks Method

Article
04/17/2009

Queues one or more specified tasks again.

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

Usage

Syntax

'Declaration
Sub RequeueTasks ( _
    jobId As Integer, _
    taskIds As IClusterEnumerable _
)

void RequeueTasks (
    int jobId,
    IClusterEnumerable taskIds
)

void RequeueTasks (
    int jobId, 
    IClusterEnumerable^ taskIds
)

void RequeueTasks (
    int jobId, 
    IClusterEnumerable taskIds
)

function RequeueTasks (
    jobId : int, 
    taskIds : IClusterEnumerable
)

Parameters

jobId
The job identifier. The ICluster.AddJob method returns this value. If you have an instance of the job that has already been added to the cluster, you can access the IJob.Id property to get the identifier.

taskIds
A class that implements the IClusterEnumerable interface. The collection contains integers that identify one or more tasks to queue again. The Task.Id property contains the task identifier value.

Remarks

Typically, you call this method if the tasks failed for similar reasons, you fixed the cause of the failure, and you want to try running the tasks again.

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

If the method fails to queue a task, all subsequent tasks in the job are also not queued. Tasks 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