lsb_switchjob

Switches an unfinished job to another queue.

lsb_switchjob switches an unfinished job to another queue. Effectively, the job is removed from its current queue and re-queued in the new queue.

The switch operation can be performed only when the job is acceptable to the new queue. If the switch operation is unsuccessful, the job will stay where it is.A user can only switch his/her own unfinished jobs, but root and the LSF administrator can switch any unfinished job.

Any program using this API must be setuid to root if LSF_AUTH is not defined in the lsf.conf file.

#include <lsf/lsbatch.h>

int lsb_switchjob (LS_LONG_INT jobId, char *queue)

Parameters:

	jobId	The job to be switched. If an element of a job array is to be switched, use the array form jobID[i] where jobID is the job array name, and i is the index value.
	*queue	The new queue for the job.

Data Structures:

none

Define Statements:

none

Returns:

int:0
The function was successful.

int:-1
Function failed.

Errors:

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

Equivalent line commands:

bswitch

Files:

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

See also:

none