Command Reference Guide

Options
244 Platform LSF Command Reference
-S
Creates a pseudo-terminal with shell mode support on UNIX hosts.
Shell mode support is required for running interactive shells or applications which
redefine the
CTRL-C and CTRL-Z keys (such as jove).
This option is not supported on Windows.
-v Verbose mode. Displays the name of the host or hosts running the task.
-f host_file Either -f host_file, -m host_name or -n num_processors is required.
Executes the task on all hosts listed in the host_file.
Specify a file that contains a list of host names. Host names must be separated by
white space characters (for example, SPACE, TAB, and NEWLINE).
This option is exclusive of options
-n, -R, and -m.
-m host_name ... Either -f host_file, -m host_name or -n num_processors is required.
Executes the task on all specified hosts.
Specify hosts on which to execute the task. If multiple host names are specified, the
host names must be enclosed by " or ' and separated by white space.
This option is exclusive of options
-n, -R, and -f.
-n num_hosts Either -f host_file, -m host_name or -n num_hosts is required.
Executes the task in a cluster with the required number of available hosts.
One host may be used to start several tasks if the host is multiprocessor. This option
can be used together with option
-R to select desired hosts.
This option is exclusive of options
-m and -f.
-R "res_req" Executes the task on hosts with the required resource requirements.
Specify the resource requirement expression for host selection. The resource
requirement is used to choose from all hosts with the same host type as the local
host, unless a "
type == value" exists in res_req to specify otherwise.
This option can be used together with option
-n to choose a specified number of
processors to run the task.
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:
lsgrun -R "bigmem" myjob
or
lsgrun -R "defined(bigmem)" myjob
If the -m option is specified with a single host name, the -R option is ignored.
command [argument ...]
Specify the command to execute. This must be the last argument on the command
line.
-h Prints command usage to stderr and exits.
-V Prints LSF release version to stderr and exits.