lsplace

Displays hosts available to run 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 that is produced by the dispatched task is reflected in the LIM’s load information. Host names might 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. Use the -L option for distributed parallel applications 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 with the required resources cannot be found.
-R res_req: Displays only hosts with the specified resource requirements. 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

The lsplace command is mostly used in backward quotation marks (‘) to pick out a host name that 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

In order for a job to land on a host with an exclusive resource, you need to explicitly specify that resource for the resource requirements. The following example issues a command to display the host with the bigmem exclusive resource for your program to run on:

lsrun -m ‘lsplace -R "bigmem"‘ myprogram

The -w (upper bound) and -n (lower bound) options can be combined to specify the range of processors to be returned. For example, the following command returns at least 3 and not more than 5 host names.

lsplace -n 3 -w 5

Diagnostics

The lsplace command returns 1 if not enough hosts are available. The exit status is -10 if a problem is detected in LSF. Exit status is -1 for other errors. Normal exit status is 0.