lsplace

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

-LAttempts to place tasks on as few hosts as possible. This is useful for distributed parallel applications in order to minimize communication costs between tasks.

-nminimum -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.

-Rres_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.

-wmaximum -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.

-hPrints command usage to stderr and exits.

-VPrints 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

268Platform LSF Command Reference