Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

lsb_runjob()

Starts a batch job immediately on a set of specified host().

DESCRIPTION

lsb_runjob() starts a batch job immediately on a set of specified host(). The job must have been submitted and is in PEND or FINISHED status. Only the LSF administrator or the owner of the job can start the job. If the options is set to RUNJOB_OPT_NOSTOP, then the job will not be suspended by the queue's RUNWINDOW, loadStop and STOP_COND and the hosts' RUNWINDOW and loadStop conditions. By default, these conditions apply to the job as do to other normal jobs.

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

SYNOPSIS

truct runJobRequest { 
    LS_LONG_INT jobId;    /* jobid of the requested job */ 
    int     numHosts;     /* The number of hosts */ 
    char    **hostname;   /* Vector of hostnames */ 
#define RUNJOB_OPT_NORMAL     0x01 
#define RUNJOB_OPT_NOSTOP     0x02 
#define RUNJOB_OPT_PENDONLY   0x04 /* pending jobs only, no finished jobs */ 
#define RUNJOB_OPT_FROM_BEGIN 0x08 /* chkpnt job only, from beginning */ 
#define RUNJOB_OPT_FREE       0x10 /* brun to use free CPUs only */ 
#define RUNJOB_OPT_IGNORE_RUSAGE  0x20 /* brun ignoring rusage */ 
    int     options;      /* Run job request options */ 
 int     *slots;       /* Vector of number of slots per host */ 
}; 

PARAMETERS

*runReq

The job-starting request.

RETURN VALUES

integer:0

Function was successful.

integer:-1

Function failed.

ERRORS

If the function fails, lsberrno is set to indicate the error.

SEE ALSO

Related API

none

Equivalent line command

brun

Files

lsf.conf


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