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 run 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

Platform LSF Command Reference 211