Command Reference Guide

Platform LSF Command Reference 209
bswitch
switches unfinished jobs from one queue to another
Synopsis
bswitch [ -J job_name] [-m host_name | -m host_group] [-q queue_name]
[-u user_name | -u user_group | -u all] destination_queue [0]
bswitch destination_queue [job_ID | "job_ID[index_list]"] ...
bswitch [-h | -V]
Description
Switches one or more of your unfinished jobs to the specified queue. LSF
administrators and
root can switch jobs submitted by other users.
By default, switches one job, the most recently submitted job, or the most recently
submitted job that also satisfies other specified options (
-m, -q, -u, or -J). Specify
-0 (zero) to switch multiple jobs.
The switch operation can be done only if a specified job is acceptable to the new
queue as if it were submitted to it, and, in case the job has been dispatched to a host,
if the host can be used by the new queue. If the switch operation is unsuccessful, the
job stays where it is.
If a switched job has not been dispatched, then its behavior is as if it were submitted
to the new queue in the first place.
If a switched job has been dispatched, then it is controlled by the
loadSched and
loadStop vectors and other configuration parameters of the new queue, but its nice
value and resource limits remain the same.
Also, if a switched job has been dispatched, it is controlled by the PRIORITY and
RUN_WINDOW configuration parameters of the new queue.
Members of a chunk job can be switched to another queue. Running chunk job
members are removed from the chunk and switched; all other WAIT jobs are
requeued to PEND. For chunk jobs in WAIT state, only the WAIT job is removed
from the chunk and switched, and requeued to PEND.
The
bswitch command is useful to change a job’s attributes inherited from the
queue.
Options
0 (Zero). Switches multiple jobs. Switches all the jobs that satisfy other specified
options (
-m, -q, -u and -J).
-J job_name Only switches jobs that have the specified job name.
-m host_name | -m host_group
Only switches jobs dispatched to the specified host or host group.
-q queue_name Only switches jobs in the specified queue.
-u user_name | -u user_group | -u all