Command Reference Guide

Platform LSF Command Reference 275
lsrun
runs an interactive task through LSF
Synopsis
lsrun [-l] [-L] [-P] [-S] [-v] [-m "host_name
..." | -m "cluster_name ..."] [-R "res_req"] command [argument
...]
lsrun [-h | -V]
Description
Submits a task to LSF for execution.
With MultiCluster job forwarding model, the default is to run the task on a host in
the local cluster.
By default,
lsrun first tries to obtain resource requirement information from the
remote task list to find an eligible host. (See
lseligible(1) and ls_task(3).)
Otherwise,
lsrun runs the task on a host that is of the same host type (or
architecture) as the submission host. If several hosts of the same architecture are
available, the host with the lowest CPU and memory load is selected.
By default, if execution fails and the local host satisfies resource requirements, LSF
runs the task locally.
By default,
lsrun does not create a pseudo-terminal when running the task.
Options
-l If execution on another host fails, runs the task locally.
-L Forces lsrun to go through RES to execute a task. By default, lsrun does not use
RES if the task is going to run on the current host.
-P Creates a pseudo-terminal when starting the task on UNIX hosts. This is necessary
in order to run programs that require a pseudo-terminal (for example,
vi).
This option is not supported on Windows.
-S Creates a pseudo-terminal with shell mode support when starting the task on a
UNIX host. Shell mode support is required for running interactive shells or
applications which redefine the
CTRL-C and CTRL-Z keys (for example, jove).
This option is not supported on Windows.
-v Displays the name of the host running the task.
-m "host_name ..." | -m "cluster_name ..."
The execution host must be one of the specified hosts. If a single host is specified,
all resource requirements are ignored.
If multiple hosts are specified and you do not use the
-R option, the execution host
must satisfy the resource requirements in the remote task list (see
lsrtasks(1)). If
none of the specified hosts satisfy the resource requirements, the task does not run.