lsb_submit_option
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 #define SUB2_HOLD 0x01 #define SUB2_MODIFY_CMD 0x02 #define SUB2_BSUB_BLOCK 0x04 #define SUB2_HOST_NT 0x08 #define SUB2_HOST_UX 0x10 #define SUB2_QUEUE_CHKPNT 0x20 #define SUB2_QUEUE_RERUNNABLE 0x40 #define SUB2_IN_FILE_SPOOL 0x80 #define SUB2_JOB_CMD_SPOOL 0x100 #define SUB2_JOB_PRIORITY 0x200 #define SUB2_USE_DEF_PROCLIMIT 0x400 #define SUB2_MODIFY_RUN_JOB 0x800 #define SUB2_MODIFY_PEND_JOB 0x1000 #define SUB2_WARNING_TIME_PERIOD 0x2000 #define SUB2_WARNING_ACTION 0x4000 #define SUB2_USE_RSV 0x8000 #define SUB2_TSJOB 0x10000 #define SUB2_LSF2TP 0x20000 #define SUB2_JOB_GROUP 0x40000 #define SUB2_SLA 0x80000 #define SUB2_EXTSCHED 0x100000 #define SUB2_LICENSE_PROJECT 0x200000 #define SUB2_OVERWRITE_OUT_FILE 0x400000 #define SUB2_OVERWRITE_ERR_FILE 0x800000 #define SUB2_SSM_JOB 0x1000000 #define SUB2_SYM_JOB 0x2000000 #define SUB2_SRV_JOB 0x4000000 #define SUB2_SYM_GRP 0x8000000 #define SUB2_SYM_JOB_PARENT 0x10000000 #define SUB2_SYM_JOB_REALTIME 0x20000000 #define SUB2_SYM_JOB_PERSIST_SRV 0x40000000 #define SUB2_SSM_JOB_PERSIST 0x80000000 #define SUB3_APP 0x01 #define SUB3_APP_RERUNNABLE 0x02 #define SUB3_ABSOLUTE_PRIORITY 0x04 #define SUB3_DEFAULT_JOBGROUP 0x08 #define SUB3_POST_EXEC 0x10 #define SUB3_USER_SHELL_LIMITS 0x20 #define SUB3_CWD 0x40 #define SUB3_RUNTIME_ESTIMATION 0x80 #define SUB3_NOT_RERUNNABLE 0x100 #define SUB3_JOB_REQUEUE 0x200 #define SUB3_INIT_CHKPNT_PERIOD 0x400 #define SUB3_MIG_THRESHOLD 0x800 #define SUB3_APP_CHKPNT_DIR 0x1000 #define SUB3_BSUB_CHK_RESREQ 0x2000 #define SUB3_RUNTIME_ESTIMATION_ACC 0x4000 #define SUB3_RUNTIME_ESTIMATION_PERC 0x8000 #define SUB3_INTERACTIVE_SSH 0x10000 #define SUB3_XJOB_SSH 0x20000 #define SUB3_AUTO_RESIZE 0x40000 #define SUB3_RESIZE_NOTIFY_CMD 0x80000 #define SUB3_BULK_SUBMIT 0x100000 #define SUB3_INTERACTIVE_TTY 0x200000 #define SUB3_FLOATING_CLIENT 0x400000 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 Flat 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 (e.g., 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 (e.g., jove). Equivalent to bsub -Is command line option.
#define SUB_EXCEPT 0x20000000 Exception handler for job.
#define SUB_TIME_EVENT 0x40000000 Specifies time_event.
#define SUB2_HOLD 0x01 Hold the job after it is submitted.
The job will be in PSUSP status. Equivalent to bsub -H command line option.
#define SUB2_MODIFY_CMD 0x02 New cmd for bmod.
#define SUB2_BSUB_BLOCK 0x04 Submit a job in a synchronous mode so that submission does not return until the job terminates.
Note once this flag is set, the lsb_submit() will never return if the job is accepted by LSF. Programs that wishes to know the status of the submission needs to fork, with the child process invoking the API call in the blocking mode and the parent process wait on the child process (see wait() for details.
#define SUB2_HOST_NT 0x08 Submit from NT.
#define SUB2_HOST_UX 0x10 Submit fom UNIX.
#define SUB2_QUEUE_CHKPNT 0x20 Submit to a chkpntable queue.
#define SUB2_QUEUE_RERUNNABLE 0x40 Submit to a rerunnable queue.
#define SUB2_IN_FILE_SPOOL 0x80 Spool job command.
#define SUB2_JOB_CMD_SPOOL 0x100 Inputs the specified file with spooling.
#define SUB2_JOB_PRIORITY 0x200 Submits job with priority.
#define SUB2_USE_DEF_PROCLIMIT 0x400 Job submitted without -n, use queue's default proclimit.
#define SUB2_MODIFY_RUN_JOB 0x800 bmod -c/-M/-W/-o/-e
#define SUB2_MODIFY_PEND_JOB 0x1000 bmod options only to pending jobs
#define SUB2_WARNING_TIME_PERIOD 0x2000 Job action warning time.
Equivalent to bsub or bmod -wt.
#define SUB2_WARNING_ACTION 0x4000 Job action to be taken before a job control action occurs.
Equivalent to bsub or bmod -wa.
#define SUB2_USE_RSV 0x8000 Use an advance reservation created with the brsvadd command.
Equivalent to bsub -U.
#define SUB2_TSJOB 0x10000 Windows Terminal Services job.
#define SUB2_LSF2TP 0x20000 Parameter is deprecated.
#define SUB2_JOB_GROUP 0x40000 Submit into a job group.
#define SUB2_SLA 0x80000 Submit into a service class.
#define SUB2_EXTSCHED 0x100000 Submit with -extsched options.
#define SUB2_LICENSE_PROJECT 0x200000 License Scheduler project.
#define SUB2_OVERWRITE_OUT_FILE 0x400000 Overwrite the standard output of the job.
Equivalent to bsub -oo.
#define SUB2_OVERWRITE_ERR_FILE 0x800000 Overwrites the standard error output of the job.
Equivalent to bsub -eo.
#define SUB2_SSM_JOB 0x1000000 (symphony) session job
#define SUB2_SYM_JOB 0x2000000 (symphony) symphony job
#define SUB2_SRV_JOB 0x4000000 (symphony) service(LSF) job
#define SUB2_SYM_GRP 0x8000000 (symphony) "group" job
#define SUB2_SYM_JOB_PARENT 0x10000000 (symphony) symphony job has child symphony job
#define SUB2_SYM_JOB_REALTIME 0x20000000 (symphony) symphony job has real time feature
#define SUB2_SYM_JOB_PERSIST_SRV 0x40000000 (symphony) symphony job has dummy feature to hold all persistent service jobs.
#define SUB2_SSM_JOB_PERSIST 0x80000000 Persistent session job.
#define SUB3_APP 0x01 Application profile name.
Equivalent to bsub -app.
#define SUB3_APP_RERUNNABLE 0x02 Job rerunable because of application profile.
#define SUB3_ABSOLUTE_PRIORITY 0x04 Job modified with absolute priority.
Equivalent to bmod -aps.
#define SUB3_DEFAULT_JOBGROUP 0x08 Submit into a default job group.
Equivalent to bsub -g.
#define SUB3_POST_EXEC 0x10 Run the specified post-execution command on the execution host after the job finishes.
Equivalent to bsub -Ep.
#define SUB3_USER_SHELL_LIMITS 0x20 Pass user shell limits to execution host.
Equivalent to bsub -ul.
#define SUB3_CWD 0x40 Current working directory specified on the command line with bsub -cwd.
#define SUB3_RUNTIME_ESTIMATION 0x80 Runtime estimate.
Equivalent to bsub -We. Use in conjunction with SUB3_RUNTIME_ESTIMATION_ACC and SUB3_RUNTIME_ESTIMATION_PERC.
#define SUB3_NOT_RERUNNABLE 0x100 Job is not rerunnable.
Equivalent to bsub -rn.
#define SUB3_JOB_REQUEUE 0x200 Job level requeue exit values.
#define SUB3_INIT_CHKPNT_PERIOD 0x400 Initial checkpoint period.
Equivalent to bsub -k initial_checkpoint_period.
#define SUB3_MIG_THRESHOLD 0x800 Job migration threshold.
Equivalent to bsub -mig migration_threshold.
#define SUB3_APP_CHKPNT_DIR 0x1000 Checkpoint dir was set by application profile.
#define SUB3_BSUB_CHK_RESREQ 0x2000 Value of BSUB_CHK_RESREQ environment variable, used for select section resource requirement string syntax checking with bsub -R.
bsub only checks the resreq syntax.
#define SUB3_RUNTIME_ESTIMATION_ACC 0x4000 Runtime estimate that is the accumulated run time plus the runtime estimate.
Equivalent to bmod -We+. Use in conjunction with SUB3_RUNTIME_ESTIMATION.
#define SUB3_RUNTIME_ESTIMATION_PERC 0x8000 Runtime estimate in percentage of completion.
Equivalent to bmod -Wep. Two digits after the decimal point are suported. The highest eight bits of runtimeEstimation in the submit structure are used for the integer; the remaining bits are used for the fraction. Use in conjunction with SUB3_RUNTIME_ESTIMATION.
#define SUB3_INTERACTIVE_SSH 0x10000 Protects the sessions of interactive jobs with SSH encryption.
Equivalent to bsub -IS|-ISp|-ISs.
#define SUB3_XJOB_SSH 0x20000 Protect the sessions of interactive x-window job with SSH encryption.
Equivalent to bsub -IX.
#define SUB3_AUTO_RESIZE 0x40000 If set the submitted job is auto-resizable.
#define SUB3_RESIZE_NOTIFY_CMD 0x80000 If set, the resize notify cmd specified.
#define SUB3_BULK_SUBMIT 0x100000 Job broker bulk submit.
#define SUB3_INTERACTIVE_TTY 0x200000 tty mode for interactive job
#define SUB3_FLOATING_CLIENT 0x400000 Job submitted from floating client.
Date Modified: 9 Jun 2009
Platform Support: support@platform.com
Platform Information Development: doc@platform.com
Platform Computing. Accelerating Intelligence(TM).
Copyright © 1994-2009 Platform Computing Corporation. All rights reserved.