bswitch - switch one or more unfinished jobs from one queue to another
bswitch [ -h ] [ -V ] [ -q queue_name ] [ -m host_name ] [ -u user_name
all ] [ -J job_name ]
dest_queue [ jobId ... ]
Switch one or more unfinished jobs to the queue dest_queue. This is useful for users to change the jobs' attributes inherited from the queue.
If a switched job has not been dispatched, then its behavior will be as if it were submitted to the queue dest_queue in the first place. If a switched job has been dispathed, then it will be controlled by the loadSched and loadStop vectors, PRIORITY, RUN_WINDOW and other configuration parameters of dest_queue, but its nice value and resource limits will remain the same except the RUNLIMIT which is reset to the value of dest_queues' (see lsbatch(5) ).
The switch operation can be done only if a specified job is acceptable to dest_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 dest_queue. If the switch operation is unsuccessful, the job stays where it is.
A user can only switch his or her own jobs. Only root and LSF administrator can switch jobs submitted by other users.
-h Print command usage to stderr and exit.
-V Print LSF release version to stderr and exit.
-q queue_name
Operate on the jobs in the queue specified by queue_name. If jobId is
not specified, then only the most recently submitted qualifying job is
operated upon. The -q option is ignored if a job ID other than 0 is
specified in the jobId option.
-m host_name
Operate on the jobs dispatched to the host or host group that is
specified by host_name (see bhosts(1)
and bmgroup(1)
). If jobId is
not specified, then only the most recently submitted qualifying job is
operated upon. The -q option is ignored if a job ID other than 0 is
specified in the jobId option.
-u user_name | all
Operate on the jobs submitted by the user or user group (see
bugroup(1)
) specified by user_name, or by all users if the reserved
user name all is given. If jobId is not specified, then only the most
recently submitted qualifying job is operated upon. The -q option is
ignored if a job ID other than 0 is specified in the jobId option.
-J job_name
Operate on the jobs that have the specified job_name. If jobId is not
specified, then only the most recently submitted qualifying job will
be operated upon. The -q option is ignored if a job ID other than 0
is specified in the jobId option.
dest_queue
The destination queue which jobs will be switched to.
jobId ...
Operate only on the jobs specified by jobId .... The options -q, -u,
-m and -J will have no effect if a job ID other than 0 is specified.
Jobs submitted by any user may be specified here without using the -u
option. If the reserved job ID 0 is used, the operation is applied to
all the unfinished jobs satisfying other options (that is, -q, -u, -m
and -J), and all other job IDs are ignored. If no jobId is specified,
the most recently submitted job satisfying other options is operated
upon. Job IDs are returned at job submission time (see bsub(1)
), and
may be obtained with the bjobs command (see bjobs(1)
).
bqueues(1) , bhosts(1) , bugroup(1) , bsub(1) , bjobs(1)