Command Reference Guide

Platform LSF Command Reference 143
brequeue
kills and requeues a job
Synopsis
brequeue [-J job_name | -J "job_name[index_list]"] [ -u user_name |
-u all ] [ job_ID | "job_ID[index_list]"] [-d] [-e] [-r] [-a]
[-H]
brequeue [-h | -V]
Description
You can only use brequeue on a job you own, unless you are root or the LSF
administrator.
Kills a running (RUN), user-suspended (USUSP), or system-suspended (SSUSP)
job and returns it to the queue. A job that is killed and requeued retains its submit
time but is dispatched according to its requeue time. When the job is requeued, it is
assigned the PEND status or PSUSP if the
-H option is used. Once dispatched, the
job starts over from the beginning. The requeued job keeps the same job ID.
When JOB_INCLUDE_POSTPROC=Y is set in
lsb.params or in an application
profile in
lsb.applications, job requeue occurs only after post-execution
processing, not when the job finishes.
Use
brequeue to requeue job arrays or job array elements.
By default, kills and requeues your most recently submitted job when no job ID is
specified.
With MultiCluster, you can only use
brequeue on jobs in local queues. A job that is
killed and requeued is assigned a new job ID on the cluster in which it is executed,
but it retains the same job ID on the cluster from which it was submitted. For
example, a job from cluster A that is killed and requeued and then run on cluster B
is assigned a new job ID on cluster B. However, when the
bjobs command is used
from cluster A, the submitting cluster, the job is displayed with the original job ID.
When the
bjobs command is used from cluster B, the execution cluster, the job is
displayed with the new job ID.
When absolute job priority scheduling (APS) is configured in the queue, all
requeued jobs are treated as newly submitted jobs for APS calculation. The job
priority, system, and ADMIN APS factors are reset on requeue.
Options
-a Requeues all jobs including running jobs, suspending jobs, and jobs with EXIT or
DONE status.
-d Requeues jobs that have finished running with DONE job status.
-e Requeues jobs that have terminated abnormally with EXIT job status.
-H Requeues jobs to PSUSP job status.
-r Requeues jobs that are running.