Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

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