Command Reference Guide

lsplace
268 Platform LSF Command Reference
lsplace
displays hosts available to execute tasks
Synopsis
lsplace [-L] [-n minimum | -n 0] [-R res_req] [-w maximum | -w 0]
[host_name ...]
lsplace [-h | -V]
Description
Displays hosts available for the execution of tasks, and temporarily increases the
load on these hosts (to avoid sending too many jobs to the same host in quick
succession). The inflated load decays slowly over time before the real load produced
by the dispatched task is reflected in the LIM’s load information. Host names may
be duplicated for multiprocessor hosts, to indicate that multiple tasks can be placed
on a single host.
By default, displays only one host name.
By default, uses LSF default resource requirements.
Options
-L Attempts to place tasks on as few hosts as possible. This is useful for distributed
parallel applications in order to minimize communication costs between tasks.
-n minimum | -n 0 Displays at least the specified number of hosts. Specify 0 to display as many hosts as
possible.
Prints
Not enough host(s) currently eligible and exits with status 1 if the
required number of hosts holding the required resources cannot be found.
-R res_req Displays only hosts with the specified resource requirements. When
LSF_STRICT_RESREQ=Y in
lsf.conf, LSF rejects resource requirement strings
where an rusage section contains a non-consumable resource.
-w maximum | -w 0 Displays no more than the specified number of hosts. Specify 0 to display as many
hosts as possible.
host_name ... Displays only hosts that are among the specified hosts.
-h Prints command usage to stderr and exits.
-V Prints LSF release version to stderr and exits.
Examples
lsplace is mostly used in backquotes to pick out a host name which is then passed
to other commands. The following example issues a command to display a lightly
loaded HPPA-RISC host for your program to run on:
lsrun -m ‘lsplace -R hppa‘ myprogram