lsb_submit

Submits or restarts a job in the batch system.

lsb_submit submits or restarts a job in the batch system according to the jobSubReq specification.

#include <lsf/lsbatch.h>

LS_LONG_INT lsb_submit (struct submit *jobSubReq, 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.
	*jobSubReply	Describes the results of the job submission to the batch system.

Data Structures:

submit
submitReply

Define Statements:

lsb_submit_options
lsb_submit_options2
lsb_submit_options3

Returns:

LS_LONG_INT: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. If the environment variable BSUB_CHK_RESREQ is set, lsb_submit returns a jobid less than zero (0).
If SUB2_BSUB_BLOCK (bsub -K) or SUB_INTERACTIVE (bsub -I) option is given, lsb_submit does not return.

LS_LONG_INT:-1
Function failed.

Errors:

If the function fails, lsberrno is set to indicate the error. If the environment variable BSUB_CHK_RESREQ is set, the value of lsberrno is either LSBE_RESREQ_OK or LSBE_RESREQ_ERR, depending on the result of resource requirement string checking. The badJobName field in the submitReply structure contains the detailed error message.

Equivalent line commands:

bsub
brestart

Files:

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

See also:

lsb_modify

ls_info

lsb_queueinfo