lsb_movejob

Changes the position of a pending job in a queue.

Use lsb_movejob to move a pending job to a new position that you specify in a queue. Position the job in a queue by first specifying the job ID. Next, count, beginning at 1, from either the top or the bottom of the queue, to the position you want to place the job.

To position a job at the top of a queue, choose the top of a queue parameter and a postion of 1.To position a job at the bottom of a queue, choose the bottom of the queue parameter and a position of 1.

By default, LSF dispatches jobs in a queue in order of their arrival (such as first-come-first-served), subject to the availability of suitable server hosts.

#include <lsf/lsbatch.h>

int lsb_movejob (LS_LONG_INT jobId, int *position, int opCode)

Parameters:

	jobId	The job ID that the LSF system assigns to the job. If a job in a job array is to be moved, use the array form jobID[ i ] where jobID is the job array name, and i is the index value.
	*position	The new position of the job in a queue. position must be a value of 1 or more.
	opCode	The top or bottom position of a queue. TO_TOP The top position of a queue. TO_BOTTOM The bottom position of a queue. If an opCode is not specified for the top or bottom position, the function fails.

Data Structures:

none

Define Statements:

movejob_options

Returns:

int:0
The function is successful.

int:-1
The function failed.

Errors:

If the function fails, lsberrno is set to indicate the error.

Equivalent line command:

btop
bbot
bjobs -q

Files:

${LSF_ENVDIR:-/etc}/lsf.conf

See also:

lsb_pendreason