lsb_deletejob

Kills a job in a queue

Use lsb_deletejob to send a signal to kill a running, user-suspended, or system-suspended job. The job can be requeued or deleted from the batch system.If the job is requeued, it retains its submit time but it is dispatched according to its requeue time. When the job is requeued, it is assigned the PEND status and re-run.If the job is deleted from the batch system, it is no longer available to be requeued.

#include <lsf/lsbatch.h>

int lsb_deletejob (LS_LONG_INT jobId, int times, int options)

Parameters:

	jobId	The job to be killed. If an element of a job array is to be killed, use the array form jobID[i] where jobID is the job array name, and i is the index value.
	times	Original job submit time.
	options	If the preprocessor macro LSB_KILL_REQUEUE in lsbatch.h is compared with options and found true, then requeue the job using the same job ID. If the preprocessor macro LSB_KILL_REQUEUE in lsbatch.h is compared with options and found false, then the job is deleted from the batch system.

Data Structures:

none

Define Statements:

kill_requeue

Returns:

int:0
The function was successful.

int:-1
The function failed.

Note:

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

Errors:

On failure, lsberrno is set to indicate the error.

Equivalent line commands:

bkill
brequeue -J

Files:

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

See also:

lsb_signaljob

lsb_chkpntjob