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