Knowledge Center Contents Previous Next |
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 |