Command Reference Guide

Platform LSF Command Reference 183
In exclusive execution mode, your job runs by itself on a host. It is dispatched only
to a host with no other jobs running, and LSF does not send any other jobs to the
host until the job completes.
To submit a job in exclusive execution mode, the queue must be configured to allow
exclusive jobs.
When the job is dispatched,
bhosts(1) reports the host status as closed_Excl, and
lsload(1) reports the host status as lockU.
Until your job is complete, the host is not selected by LIM in response to placement
requests made by
lsplace(1), lsrun(1) or lsgrun(1) or any other load sharing
applications.
You can force other batch jobs to run on the host by using the
-m host_name option
of
brun(1) to explicitly specify the locked host.
You can force LIM to run other interactive jobs on the host by using the
-m
host_name option of lsrun(1) or lsgrun(1) to explicitly specify the locked host.
-a esub_application Specifies one or more application-specific esub executables that you want LSF to
associate with the job.
The value of
-a must correspond to the application name of an actual esub file. For
example, to use
bsub -a fluent, the file esub.fluent must exist in
LSF_SERVERDIR.
For example, to submit a job that invokes two application-specific
esub executables
named
esub.license and esub.fluent, enter:
bsub -a license fluent my_job
mesub
uses the method name license to invoke the esub named
LSF_SERVERDIR/esub.license, and the method name fluent to invoke the esub
named
LSF_SERVERDIR/esub.fluent.
The name of an application-specific
esub program is passed to the master esub.
The master
esub program (LSF_SERVERDIR/mesub) handles job submission
requirements of the application. Application-specific
esub programs can specify
their own job submission requirements. The value of
-a is set in the
LSB_SUB_ADDITIONAL option in the LSB_SUB_PARM file used by
esub.
If an LSF administrator specifies one or more mandatory
esub executables using
the parameter
LSB_ESUB_METHOD, LSF invokes the mandatory executables first,
followed by the executable named
esub (without .esub_application in the file name)
if it exists in
LSF_SERVERDIR, and then any application-specific esub executables
(with .esub_application in the file name) specified by
-a.esub_application.
The name of the
esub program must be a valid file name. It can contain only
alphanumeric characters, underscore (
_) and hyphen (-).
RESTRICTION: After LSF version 5.1, the value of -a and LSB_ESUB_METHOD must correspond to
an actual esub file in LSF_SERVERDIR. For example, to use bsub -a fluent, the file esub.fluent must
exist in LSF_SERVERDIR.
-app application_profile_name
Submits the job to the specified application profile. You must specify an existing
application profile. If the application profile does not exist in
lsb.applications,
the job is rejected.