lsb_submitframe

Submits a frame job to the batch system.

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.

#include <lsf/lsbatch.h>

int lsb_submitframe (struct submit *jobSubReq, char *frameExp, struct submitReply *jobSubReply)

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.

Data Structures:

submit
submitReply

Define Statements:

lsb_submit_options
lsb_submit_options2
lsb_submit_options3
lsb_submit_options4

Returns:

int:jobId
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.

Equivalent line commands:

none

Files:

${LSF_ENVDIR:-/etc}/lsf.conf

See also:

none