Cancel a Job or Task

  • Article

Applies To: Windows Compute Cluster Server 2003

You can cancel one or more active jobs or tasks at any time for any reason. Cancellation stops the job and frees its resources. A canceled job can be requeued. It can also be saved to a template and resubmitted from the template. To cancel a job or task, you must be the submitting user or have administrative rights. Cancellation does not affect the results of tasks that have already completed.

Note

To prevent the screen from freezing temporarily, canceling a task is performed as a background process. If errors occur in this processs, they will be reported by an alert message that appears in the in the lower left corner of the Job Manager screen. For example:
! 2 Alert(s)
To view the errors, click the message.

To cancel a job

  1. In the job queue, select the job or jobs that you want to cancel.

  2. Right-click your selection and click Cancel your job.

To cancel a job using the command-line interface (CLI), type:

Job cancel [/message:<msg_string>] <jobID>

Msg_string is an optional user-written log entry for session cancellation. The default log entry is cancelled by <invoking_user>.Messages containing white spaces should be entered in double quotes.

To cancel a task

  1. In the task list, select the task or tasks you want to cancel.

  2. Right-click your selection and click Cancel your task.

To cancel a task using the CLI, type:

task cancel [/message:<msg_string>] <jobID.taskID>

Msg_string is an optional user-written log entry for session cancellation. The default log entry is cancelled by <invoking_user>. Messages containing white spaces should be entered in double quotes.