Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

lsb_deletejob()

Kills a job in a queue

DESCRIPTION

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.

SYNOPSIS

#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.

RETURN VALUES

integer:0

The function was successful.

integer:-1

The function failed.

NOTES

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.

SEE ALSO

Related API

lsb_signaljob() - Signals a job

lsb_chkpntjob() - Checkpoints a job

Equivalent line command

bkill

brequeue -J

Files

${LSF_ENVDIR-/etc}/lsf.conf


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next