lsb_launch

Launch commands on remote hosts in parallel.

lsb_launch is a synchronous API call to allow source level integration with vendor MPI implementations. This API will launch the specified command (argv) on the remote nodes in parallel.
LSF must be installed before integrating your MPI implementation with lsb_launch. The lsb_launch API requires the full set of liblsf.so, libbat.so (or liblsf.a, libbat.a).

#include <lsf/lsbatch.h>

int lsb_launch (char** where, char** argv, int userOptions, char** envp)

Parameters:

	**where	[IN] A NULL-terminated list of hosts. A task will be launched for each slot.If this parameter is NULL then the environment variable LSB_MCPU_HOSTS will be used.
	**argv	[IN] The command to be executed
	userOptions	[IN] Options to modify the behavior of lsb_launch Multiple option values can be specified. For example option values can be separated by OR (|): lsb_launch (where, argv, LSF_DJOB_REPLACE_ENV | LSF_DJOB_DISABLE_STDIN, envp);
	**envp	[IN] A NULL-terminated list of environment variables specifying the environment to set for each task.If envp is NULL, lsb_launch uses the same environment used to start the first task on the first execution host. If non-NULL, envp values are appended to the environment used for the first task.If the LSF_DJOB_REPLACE_ENV option is specified, envp entries will overwrite all existing environment values except those needed by LSF.

Data Structures:

none

Define Statements:

defs_lsb_launch

Returns:

> 0
Function was successful (the number of tasks launched).

< 0
Function failed.

Errors:

If the function fails, lsberrno is set to indicate the error.

Equivalent line command:

blaunch

Files:

none

See also:

none