Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

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