[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]
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 areroot
or an 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.Use brequeue to requeue job arrays or elements of them.
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 will be assigned a new job ID on cluster B. However, when the
bjobs
command is used from cluster A, the submitting cluster, the job will be displayed with the original job ID. When thebjobs
command is used from cluster B, the execution cluster, the job will be displayed with the new job ID.OPTIONS
-J job_name | -J "job_name[index_list]"
Operates on the specified job.
Since job names are not unique, multiple job arrays may have the same name with a different or same set of indices.
-u user_name | -u all
Operates on the specified user's jobs or all jobs.
Only
root
and an LSF administrator can requeue jobs submitted by other users.job_ID |"job_ID[index_list]"
Operates on the specified job or job array elements.
The value of 0 for job_ID is ignored.
-d
Requeues jobs that have finished running with DONE job status.
-e
Requeues jobs that have terminated abnormally with EXIT job status.
-r
Requeues jobs that are running.
-a
Requeues all jobs including running jobs, suspending jobs, and jobs with EXIT or DONE status.
-H
Requeues jobs to PSUSP job status.
-h
Prints command usage to
stderr
and exits.-V
Prints LSF release version to
stderr
and exits.LIMITATIONS
brequeue
cannot be used on interactive batch jobs;brequeue
only kills interactive batch jobs, it does not restart them.[ Top ]
[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]
Date Modified: February 24, 2004
Platform Computing: www.platform.com
Platform Support: support@platform.com
Platform Information Development: doc@platform.com
Copyright © 1994-2004 Platform Computing Corporation. All rights reserved.