ICluster::RequeueJobs method
Queues one or more specified jobs again.
Syntax
HRESULT RequeueJobs(
[in] IClusterEnumerable *jobIds
);
Parameters
- jobIds [in]
An IClusterEnumerable interface that contains the identifiers of one or more jobs to queue again. The ICluster::AddJob method returns the identifier. 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. The variant type of each item in the collection is VT_I4. Set the lVal member of the variant to 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 jobs have failed for similar reasons, 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.
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.
Requirements
Product |
Compute Cluster Pack Client Utilities |
Type library |
Ccpapi.tlb |