lsb_submit_options

define statements used by lsb_submit. More...

Defines
#define	SUB_JOB_NAME   0x01
#define	SUB_QUEUE   0x02
#define	SUB_HOST   0x04
#define	SUB_IN_FILE   0x08
#define	SUB_OUT_FILE   0x10
#define	SUB_ERR_FILE   0x20
#define	SUB_EXCLUSIVE   0x40
#define	SUB_NOTIFY_END   0x80
#define	SUB_NOTIFY_BEGIN   0x100
#define	SUB_USER_GROUP   0x200
#define	SUB_CHKPNT_PERIOD   0x400
#define	SUB_CHKPNT_DIR   0x800
#define	SUB_CHKPNTABLE   SUB_CHKPNT_DIR
#define	SUB_RESTART_FORCE   0x1000
#define	SUB_RESTART   0x2000
#define	SUB_RERUNNABLE   0x4000
#define	SUB_WINDOW_SIG   0x8000
#define	SUB_HOST_SPEC   0x10000
#define	SUB_DEPEND_COND   0x20000
#define	SUB_RES_REQ   0x40000
#define	SUB_OTHER_FILES   0x80000
#define	SUB_PRE_EXEC   0x100000
#define	SUB_LOGIN_SHELL   0x200000
#define	SUB_MAIL_USER   0x400000
#define	SUB_MODIFY   0x800000
#define	SUB_MODIFY_ONCE   0x1000000
#define	SUB_PROJECT_NAME   0x2000000
#define	SUB_INTERACTIVE   0x4000000
#define	SUB_PTY   0x8000000
#define	SUB_PTY_SHELL   0x10000000
#define	SUB_EXCEPT   0x20000000
#define	SUB_TIME_EVENT   0x40000000

---

Detailed Description

define statements used by lsb_submit.

---

Define Documentation

#define SUB_JOB_NAME   0x01

Flag to indicate jobName parameter has data.

Equivalent to bsub -J command line option existence.

#define SUB_QUEUE   0x02

Flag to indicate queue parameter has data.

Equivalent to bsub -q command line option existence.

#define SUB_HOST   0x04

Flag to indicate numAskedHosts parameter has data.

Equivalent to bsub -m command line option existence.

#define SUB_IN_FILE   0x08

Flag to indicate inFile parameter has data.

Equivalent to bsub -i command line option existence.

#define SUB_OUT_FILE   0x10

Flag to indicate outFile parameter has data.

Equivalent to bsub -o command line option existence.

#define SUB_ERR_FILE   0x20

Flag to indicate errFile parameter has data.

Equivalent to bsub -e command line option existence.

#define SUB_EXCLUSIVE   0x40

Flag to indicate execution of a job on a host by itself requested.

Equivalent to bsub -x command line option existence.

#define SUB_NOTIFY_END   0x80

Flag to indicate whether to send mail to the user when the job finishes.

Equivalent to bsub -N command line option existence.

#define SUB_NOTIFY_BEGIN   0x100

Flag to indicate whether to send mail to the user when the job is dispatched.

Equivalent to bsub -B command line option existence.

#define SUB_USER_GROUP   0x200

Flag to indicate userGroup name parameter has data.

Equivalent to bsub -G command line option existence.

#define SUB_CHKPNT_PERIOD   0x400

Flag to indicatechkpntPeriod parameter has data .

Equivalent to bsub -k command line option existence.

#define SUB_CHKPNT_DIR   0x800

Flag to indicate chkpntDir parameter has data.

Equivalent to bsub -k command line option existence.

#define SUB_CHKPNTABLE   SUB_CHKPNT_DIR

Indicates the job is checkpointable.

Equivalent to bsub -k command line option.

#define SUB_RESTART_FORCE   0x1000

Flag to indicate whether to force the job to restart even if non-restartable conditions exist.

These conditions are operating system specific. Equivalent to brestart() -f command line option existence.

#define SUB_RESTART   0x2000

Flag to indicate restart of a checkpointed job.

Only jobs that have been successfully checkpointed can be restarted. Jobs are re-submitted and assigned a new job ID. By default, jobs are restarted with the same output file, file transfer specifications, job name, window signal value, checkpoint directory and period, and rerun options as the original job. To restart a job on another host, both hosts must be binary compatible, run the same OS version, have access to the executable, have access to all open files (LSF must locate them with an absolute path name), and have access to the checkpoint directory. Equivalent to bsub -k command line option existence.

#define SUB_RERUNNABLE   0x4000

Indicates the job is re-runnable.

If the execution host of the job is considered down, the batch system will re-queue this job in the same job queue, and re-run it from the beginning when a suitable host is found. Everything will be as if it were submitted as a new job, and a new job ID will be assigned. The user who submitted the failed job will receive a mail notice of the job failure, requeueing of the job, and the new job ID.

For a job that was checkpointed before the execution host went down, the job will be restarted from the last checkpoint. Equivalent to bsub -r command line option existence.

#define SUB_WINDOW_SIG   0x8000

Flag to indicate sigValue parameter has data.

Sends a signal as the queue window closes.

#define SUB_HOST_SPEC   0x10000

Flag to indicate hostSpec parameter has data.

#define SUB_DEPEND_COND   0x20000

Flag to indicate dependCond parameter has data.

Equivalent to bsub -w command line option existence.

#define SUB_RES_REQ   0x40000

Flag to indicate resReq parameter has data.

Equivalent to bsub -R command line option existence.

#define SUB_OTHER_FILES   0x80000

Flag to indicate nxf parameter and structure xf have data.

#define SUB_PRE_EXEC   0x100000

Flag to indicate preExecCmd parameter has data.

Equivalent to bsub -E command line option existence.

#define SUB_LOGIN_SHELL   0x200000

Equivalent to bsub -L command line option existence.

#define SUB_MAIL_USER   0x400000

Flag to indicate mailUser parameter has data.

#define SUB_MODIFY   0x800000

Flag to indicate newCommand parameter has data.

Equivalent to bmod bsub_options existence.

#define SUB_MODIFY_ONCE   0x1000000

Flag to indicate modify option once.

#define SUB_PROJECT_NAME   0x2000000

Flag to indicate ProjectName parameter has data .

Equivalent to bsub -P command line option existence.

#define SUB_INTERACTIVE   0x4000000

Indicates that the job is submitted as a batch interactive job.

When this flag is given, lsb_submit does not return unless an error occurs during the submission process. When the job is started, the user can interact with the job's standard input and output via the terminal. See the -I option in bsub for the description of a batch interactive job. Unless the SUB_PTY flag is specified, the job will run without a pseudo-terminal. Equivalent to bsub -I command line option.

#define SUB_PTY   0x8000000

Requests pseudo-terminal support for a job submitted with the SUB_INTERACTIVE flag.

This flag is ignored if SUB_INTERACTIVE is not specified. A pseudo-terminal is required to run some applications (such as: vi). Equivalent to bsub -Ip command line option.

#define SUB_PTY_SHELL   0x10000000

Requests pseudo-terminal shell mode support for a job submitted with the SUB_INTERACTIVE and SUB_PTY flags.

This flag is ignored if SUB_INTERACTIVE and SUB_PTY are not specified. This flag should be specified for submitting interactive shells, or applications which redefine the ctrl-C and ctrl-Z keys (such as: jove). Equivalent to bsub -Is command line option.

#define SUB_EXCEPT   0x20000000

Exception handler for job.

#define SUB_TIME_EVENT   0x40000000

Specifies time_event.