Knowledge Center Contents Previous Next |
lsb_signaljob()
Sends a signal to a job.
DESCRIPTION
Use lsb_signaljob() when migrating a job from one host to another. Use lsb_signaljob() to stop or kill a job on a host before using lsb_mig() to migrate the job. Next, use lsb_signaljob() to continue the stopped job at the specified host.
Generally, use lsb_signaljob() to apply any UNIX signal to a job or process.
Any program using this API must be setuid to root if LSF_AUTH is not defined in the lsf.conf file.
SYNOPSIS
#include <lsf/lsbatch.h> int lsb_signaljob (LS_LONG_INT jobId, int sigValue)PARAMETERS
jobId
The job to be signaled. If a job in a job array is to be signaled, use the array form
jobID[ i ] where jobID is the job array name, and i is the index value.sigValue
SIGSTOP, SIGCONT, SIGKILL or some other UNIX signal.
RETURN VALUES
integer:0
The function was successful.
integer:-1
The function failed.
ERRORS
If the function fails, lsberrno is set to indicate the error.
SEE ALSO
Related APIs
lsb_chkpntjob() - checkpoints a job
lsb_forcekilljob() - kills a job
lsb_mig() - migrates a job to another host
Equivalent line command
bkill - sends a signal to kill, suspend, or resume unfinished jobs
bstop - suspends unfinished jobs
bresume - resumes a suspended job
Files
${LSF_ENVDIR-/etc}/lsf.conf
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |