Platform LSF Reference Version 6.2

bsub
Platform LSF Reference
155
-a esub_parameters
String format parameter containing the name of an application-specific esub program
to be passed to the master
esub. The master esub program
(LSF_SERVERDIR/
mesub) handles job submission requirements of the applications.
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.
Use the
-a option to specify which application-specific esub is invoked by mesub.
For example, to submit a job to
hostA that invokes two application-specific esub
programs named
esub.license: and esub.fluent:
% bsub -a license fluent -m hostA 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 value of
-a is passed to esub, but it does not directly affect the other bsub
parameters or behavior. The value of
-a must correspond to an actual esub file. For
example, to use
bsub -a fluent, the file esub.fluent must exist in
LSF_SERVERDIR.
Mandatory
esub methods specified by LSB_ESUB_METHOD (environment variable
or set in
lsf.conf), are invoked before any esub programs specified by -a.
The name of the
esub program must be a valid file name. It can contain only
alphanumeric characters, underscore (
_) and hyphen (-).
Compatibility note
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.
-b [[month:]day:]hour:minute
Dispatches the job for execution on or after the specified date and time. The date and
time are in the form of [[month
:]day:]hour:minute where the number ranges are as
follows: month 1-12, day 1-31, hour 0-23, minute 0-59.
At least two fields must be specified. These fields are assumed to be hour:minute. If three
fields are given, they are assumed to be day:hour:minute, and four fields are assumed to be
month:day:hour:minute.
-c [hour:]minute[/host_name | /host_model]
Limits the total CPU time the job can use. This option is useful for preventing runaway
jobs or jobs that use up too many resources. When the total CPU time for the whole job
has reached the limit, a SIGXCPU signal is first sent to the job, then SIGINT,
SIGTERM, and SIGKILL.
If LSB_JOB_CPULIMIT in
lsf.conf is set to n, LSF-enforced CPU limit is disabled
and LSF passes the limit to the operating system. When one process in the job exceeds
the CPU limit, the limit is enforced by the operating system.