Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

lsb_submitframe()

Submits a frame job to the batch system.

DESCRIPTION

lsb_submitframe() submits a frame job to the batch system according to the jobSubReq specification and frameExp.

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_submitframe (struct submit *jobSubReq, char *frameExp, 
    struct submitReply *jobSubReply) 
 
struct submit { 
    int     options; 
    int     options2; 
    char    *jobName; 
    char    *queue; 
    int     numAskedHosts; 
    char    **askedHosts; 
    char    *resReq; 
    int     rLimits[LSF_RLIM_NLIMITS]; 
    char    *hostSpec; 
    int     numProcessors; 
    char    *dependCond; 
    char    *timeEvent; 
    time_t  beginTime; 
    time_t  termTime; 
    int     sigValue; 
    char    *inFile; 
    char    *outFile; 
    char    *errFile; 
    char    *command; 
    char    *newCommand; 
    time_t  chkpntPeriod; 
    char    *chkpntDir; 
    int     nxf; 
    struct xFile *xf; 
    char    *preExecCmd; 
    char    *mailUser; 
    int     delOptions; 
    int     delOptions2; 
    char    *projectName; 
    int     maxNumProcessors; 
    char    *loginShell; 
    char    *userGroup; 
    char    *exceptList; 
    int     userPriority; 
    char    *rsvId; 
    char    *jobGroup; 
    char    *sla; 
    char    *extsched; 
    int     warningTimePeriod; 
    char    *warningAction; 
    char    *licenseProject; 
    int     options3; 
    int     delOptions3; 
    char    *app; 
    int     jsdlFlag; 
    char    *jsdlDoc; 
    void    *correlator; 
    char    *apsString; 
    char    *postExecCmd; 
    char    *cwd; 
    int     runtimeEstimation; 
    char    *requeueEValues; 
    int     initChkpntPeriod; 
    int     migThreshold; 
}; 
struct submitReply { 
    char *queue; 
    LS_LONG_INT badJobId; 
    char *badJobName; 
    int badReqIndx; 
}; 

PARAMETERS

*jobSubReq

Describes the requirements for job submission to the batch system. A job that does not meet these requirements is not submitted to the batch system and an error is returned.

See lsb_submit() for descriptions of the submit structure fields.

*frameExp

The syntax of frameExp is:

frame_name[indexlist]

frame_name is any name consisting of alphanumerics, periods, forward slashes, dashes or underscores. indexlist is a list of one or more frame indexes, separated by commas. These indexes can each be either a single integer or a range, specified in the following format:

start-end[xstep[:chunk]]

start, end, step, and chunk are integers, but chunk must be positive. If step and chunk are ommitted, the default value is 1.

An example of a valid expression for frameExp is:

Frame_job_1[5,10-15,20-30x2:3]

*jobSubReply

Describes the results of the job submission to the batch system.

See lsb_submit() for descriptions of the submitReply structure fields.

RETURN VALUES

char:Job ID

The function was successful, and sets the queue field of jobSubReply to the name of the queue that the job was submitted to.

int:-1

Function failed.

ERRORS

If the function fails, lsberrno is set to indicate the error and jobSubReply gives additional information about the error.

SEE ALSO

Related API

none

Equivalent line command

none

Files

${LSF_ENVDIR-/etc}/lsf.conf


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