Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Force Cancel a Job or Task

Updated: January 13, 2014

Applies To: Microsoft HPC Pack 2008 R2, Microsoft HPC Pack 2012, Microsoft HPC Pack 2012 R2, Windows HPC Server 2008 R2

A cluster administrator or a job owner can force cancel a running job or task. When a job is force canceled, the Node Release is skipped and the tasks in the job are force canceled. When a task is force canceled, the task and its sub-tasks skip the grace period and are stopped immediately.

You cannot force cancel jobs or tasks in HPC Cluster Manager. The following sections show how to force cancel jobs or tasks using HPC PowerShell or a command prompt window.

noteNote
To complete this procedure, you must be the job owner or a cluster administrator.

Force canceling a job stops the job immediately. The tasks in the job do not use the Task Cancel Grace Period, and the Node Release task does not run.

To force cancel a job, use one of the following methods. Include the –force parameter, and specify the ID of your job.

  • In HPC PowerShell use the following cmdlet: Stop-HpcJob <yourJobID> -force

  • At a command prompt use the following command: job cancel <yourJobID> /force

Force canceling a task stops the task and its sub-tasks immediately and does not use the Task Cancel Grace Period.

To force cancel a task, use one of the following methods. Include the –force parameter and specify the ID of your job and task, and optionally, the sub-task.

  • In HPC PowerShell, use the following cmdlet: Stop-HpcTask –JobId <yourJobID> -TaskID <yourTaskID> [-subTaskID <yourSubTaskID>] -force

  • At a command prompt, use the following command: task cancel <yourJobID>.<yourTaskID>[.<yourSubTask>] /force

  • Tasks that are canceled while they are running are marked as Failed. Tasks that are canceled before they start are marked as Canceled.

  • When a job is canceled, Running tasks are marked as Failed, and Queued tasks remain in the Queued state.

  • In Microsoft® HPC Pack, canceled tasks can make use of the Task Cancel Grace Period to save state information and clean up before exiting. The default grace period is 15 seconds. To use the grace period, the application must process the CTRL_BREAK event. If the application does not process the event, the task exits immediately. For a service to use the grace period, it must process the ServiceContext.OnExiting event. Tasks that are force canceled skip the grace period. For information about configuring the grace period, see Understanding Error Handling.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.