Command Reference Guide

Usage
276 Platform LSF Command Reference
With MultiCluster job forwarding model, the execution host can be a host in one of
the specified clusters, if the remote cluster accepts tasks from the local cluster. (See
RemoteClusters section in lsf.cluster(5).)
-R "res_req" Runs the task on a host that meets the specified resource requirement. The size of
the resource requirement string is limited to 512 bytes. For a complete explanation
of resource requirement expressions, see Administering Platform LSF. To find out
what resources are configured in your system, use
lsinfo and lshosts.
LSF supports ordering of resource requirements on all load indices, including
external load indices, either static or dynamic.
Exclusive resources need to be explicitly specified within the resource requirement
string. For example, you defined a resource called
bigmem in lsf.shared and
defined it as an exclusive resource for
hostE in lsf.cluster.mycluster. Use the
following command to submit a task to run on
hostE:
lsrun -R "bigmem" myjob
or
lsrun -R "defined(bigmem)" myjob
If the -m option is specified with a single host name, the -R option is ignored.
-h Prints command usage to stderr and exits.
-V Prints LSF release version to stderr and exits.
Usage
You can us e lsrun together with other utility commands such as lsplace, lsload,
lsloadadj, and lseligible to write load sharing applications in the form of
UNIX shell scripts.
lsrun supports interactive job control. Suspending lsrun suspends both the task
and
lsrun, and continuing lsrun continues the task.
If
LSB_DISABLE_LIMLOCK_EXCL=y (to enable preemption of exclusive jobs, for
example), you can use
lsrun to start a task on a host that is currently running an
exclusive job.
The
-n option of rsh can be simulated by redirecting input from /dev/null. For
example:
lsrun cat </dev/null &
Diagnostics
lsrun exits with status -10 and prints an error message to stderr if a problem is
detected in LSF and the task is not run.
The exit status is -1 and an error message is printed to
stderr if a system call fails
or incorrect arguments are specified.
Otherwise, the exit status is the exit status of the task.
See also
rsh, ls_rexecv, lsplace, lseligible, lsload, lshosts, lsrtasks, lsf.cluster