Share via


ICluster::RequeueJob method

Queues the specified job again.

Syntax

HRESULT RequeueJob(
  [in] long jobId
);

Parameters

  • jobId [in]
    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 call the IJob::get_Id method to get the identifier.

Return value

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, call the ICluster::get_ErrorMessage method.

Remarks

Typically, you call this method if tasks in the job have failed, you fixed the cause of the failure, and you want to try running the tasks again. Note that to restart a job, all tasks in the job must have the IsRerunnable property set to true. 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.

Requirements

Product

Compute Cluster Pack Client Utilities

Type library

Ccpapi.tlb

See also

ICluster

ICluster::RequeueJobs

ICluster::RequeueTask