Platform LSF Reference Version 6.2

bsub
Platform LSF Reference
152
To submit jobs from UNIX to display GUIs through Microsoft Terminal Services on
Windows, submit the job with bsub and define the environment variables
LSF_LOGON_DESKTOP=1 and LSB_TSJOB=1 on the UNIX host. Use
tssub to
submit a Terminal Services job from Windows hosts. See Using Platform LSF on
Windows for more details.
Use
bmod to modify jobs submitted with bsub. bmod takes similar options to bsub.
If the parameter LSB_STDOUT_DIRECT in
lsf.conf is set to Y or y, and you use
the
-o or -oo option, the standard output of a job is written to the file you specify as
the job runs. If LSB_STDOUT_DIRECT is not set, and you use
-o or -oo, the
standard output of a job is written to a temporary file and copied to the specified file
after the job finishes. LSB_STDOUT_DIRECT is not supported on Windows.
DEFAULT BEHAVIOR
LSF assumes that uniform user names and user ID spaces exist among all the hosts
in the cluster. That is, a job submitted by a given user will run under the same user’s
account on the execution host. For situations where nonuniform user names and
user ID spaces exist, account mapping must be used to determine the account used
to run a job.
bsub uses the command name as the job name. Quotation marks are significant.
If fairshare is defined and you belong to multiple user groups, the job will be
scheduled under the user group that allows the quickest dispatch.
The job is not checkpointable.
bsub automatically selects an appropriate queue. If you defined a default queue list
by setting LSB_DEFAULTQUEUE, the queue is selected from your list. If
LSB_DEFAULTQUEUE is not defined, the queue is selected from the system
default queue list specified by the LSF administrator (see the parameter
DEFAULT_QUEUE in
lsb.params(5)).
LSF tries to obtain resource requirement information for the job from the remote
task list that is maintained by the load sharing library (see
lsfintro(1)). If the
job is not listed in the remote task list, the default resource requirement is to run the
job on a host or hosts that are of the same host type (see
lshosts(1)) as the
submission host.
bsub assumes only one processor is requested.
bsub does not start a login shell but runs the job file under the execution
environment from which the job was submitted.
The input file for the batch job is
/dev/null (no input).
bsub sends mail to you when the job is done. The default destination is defined by
LSB_MAILTO in
lsf.conf. The mail message includes the job report, the job
output (if any), and the error message (if any).
bsub charges the job to the default project. The default project is the project you
define by setting the environment variable LSB_DEFAULTPROJECT. If you do
not set LSB_DEFAULTPROJECT, the default project is the project specified by
the LSF administrator in the
lsb.params configuration file (see the