Requeue a Job or Task

  • Article

Applies To: Windows Compute Cluster Server 2003

Requeuing a job causes the job to be reinserted in the job queue at the top of its priority class. You can requeue running, canceled, and, in some cases, failed jobs. Tasks that have been completed at the time of requeuing will not be rerun as part of the requeued job.

Requeuing a task causes the task to be reinserted at the top of the task queue. You can requeue running, canceled, and, in some cases, failed tasks. The job containing the task must be unfinished. Otherwise, the job itself must be requeued in order to rerun the task.

To requeue a job or task, you must be the submitting user or have administrative rights.

Requeuing a failed job

By default, a failed job is requeued automatically if the job fails because of system failure, such as a node reboot. If you do not want jobs to requeue automatically, set the task property Rerunnable to false.

A failed job or task can also be requeued manually if it fails because of any error that can be fixed without changing the task command line. For example, a task may call for an input file that is missing or contains errors. Such jobs are not requeued automatically, because the error must first be corrected.

Note

To prevent the screen from freezing temporarily, requeuing 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 requeue a job

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

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

To requeue a job using the Command Line Interface, type:

job requeue [/scheduler:<host>] <jobId>

To requeue a task

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

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

To requeue a task using the command-line interface (CLI), type:

task requeue [/scheduler:<host>] <jobId.taskID>