Command Reference Guide

Platform LSF Command Reference 211
btop
moves a pending job relative to the first job in the queue
Synopsis
btop job_ID | "job_ID[index_list]" [position]
btop [-h | -V]
Description
Changes the queue position of a pending job or a pending job array element, to
affect the order in which jobs are considered for dispatch.
By default, LSF dispatches jobs in a queue in the order of their arrival (that is, first
come, first served), subject to availability of suitable server hosts.
The
btop command allows users and the LSF administrator to manually change the
order in which jobs are considered for dispatch. Users can only operate on their
own jobs, whereas the LSF administrator can operate on any user’s jobs. Users can
only change the relative position of their own jobs.
If invoked by the LSF administrator,
btop moves the selected job before the first job
with the same priority submitted to the queue. The positions of all users’ jobs in the
queue can be changed by the LSF administrator.
If invoked by a regular user,
btop moves the selected job before the first job with the
same priority submitted by the user to the queue. Pending jobs are displayed by
bjobs in the order in which they are considered for dispatch.
A user may use
btop to change the dispatch order of his/her jobs scheduled using a
fairshare policy. However, if a job scheduled using a fairshare policy is moved by the
LSF administrator using
btop, the job is not subject to further fairshare scheduling
unless the same job is subsequently moved by the LSF administrator using
bbot; in
this case the job is scheduled again using the same fairshare policy (see the
FAIRSHARE keyword in lsb.queues(5) and HostPartition keyword in lsb.hosts
(5)).
To prevent users from changing the queue position of a pending job with
btop,
configure JOB_POSITION_CONTROL_BY_ADMIN=Y in
lsb.params.
You cannot r u n
btop on jobs pending in an absolute priority scheduling (APS)
queue.
Options
job_ID | "job_ID[index_list]"
Required. Job ID of the job or of the job array on which to operate.
For a job array, the index list, the square brackets, and the quotation marks are
required. An index list is used to operate on a job array. The index list is a comma
separated list whose elements have the syntax start_index[-end_index[:step] ]
where start_index, end_index and step are positive integers. If the step is omitted, a