Visit Platform at http://www.platform.com

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.