Command Reference Guide

Platform LSF Command Reference 201
To use an advance reservation on a remote host, submit the job and specify the
remote advance reservation ID. For example:
bsub -U user1#01@cluster1
In this example, we assume the default queue is configured to forward jobs to the
remote cluster.
-u mail_user Sends mail to the specified email destination. To specify a Windows user account,
include the domain name in uppercase letters and use a single backslash
(DOMAIN_NAME\user_name) in a Windows command line or a double backslash
(DOMAIN_NAME\\user_name) in a UNIX command line.
-v swap_limit Set the total process virtual memory limit to swap_limit for the whole job. The
default is no limit. Exceeding the limit causes the job to terminate.
By default, the limit is specified in KB. Use LSF_UNIT_FOR_LIMITS in
lsf.conf
to specify a larger unit for the limit (MB, GB, TB, PB, or EB).
-W [hour:]minute[/host_name | /host_model]
Sets the runtime limit of the batch job. If a UNIX or Linux job runs longer than the
specified run limit, the job is sent a SIGUSR2 signal, and is killed if it does not
terminate within ten minutes. If a Windows job runs longer than the specified run
limit, it is killed immediately. (For a detailed description of how these jobs are
killed, see
bkill.)
In the queue definition, a TERMINATE action can be configured to override the
bkill default action (see the JOB_CONTROLS parameter in lsb.queues(5)).
In an application profile definition, a TERMINATE_CONTROL action can be
configured to override the
bkill default action (see the TERMINATE_CONTROL
parameter in
lsb.applications(5)).
If you want to provide LSF with an estimated run time without killing jobs that
exceed this value, submit the job with
-We, or define the RUNTIME parameter in
lsb.applications and submit the job to that application profile. LSF uses the
estimated runtime value for scheduling purposes only..
The run limit is in the form of [hour
:]minute. The minutes can be specified as a
number greater than 59. For example, three and a half hours can either be specified
as 3:30, or 210.
The run limit you specify is the normalized run time. This is done so that the job
does approximately the same amount of processing, even if it is sent to host with a
faster or slower CPU. Whenever a normalized run time is given, the actual time on
the execution host is the specified time multiplied by the CPU factor of the
normalization host then divided by the CPU factor of the execution host.
If ABS_RUNLIMIT=Y is defined in
lsb.params, the runtime limit and the
runtime estimate are not normalized by the host CPU factor. Absolute wall-clock
run time is used for all jobs submitted with a runtime limit or runtime estimate.
Optionally, you can supply a host name or a host model name defined in LSF. You
must insert ‘
/’ between the run limit and the host name or model name. (See
lsinfo(1) to get host model information.)