Knowledge Center Contents Previous Next |
lsb_movejob()
Changes the position of a pending job in a queue.
DESCRIPTION
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 (e.g., first-come-first-served), subject to the availability of suitable server hosts.
SYNOPSIS
#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.
RETURN VALUES
integer:0
The function is successful.
integer:-1
The function failed.
ERRORS
If the function fails, lsberrno is set to indicate the error.
SEE ALSO
Related APIs:
lsb_pendreason() - Explains why a job is pending
Equivalent line command
btop
bbot
bjobs -q
Files:
${LSF_ENVDIR-/etc}/lsf.conf
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |