Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

lsb_launch()

Launch commands on remote hosts in parallel.

DESCRIPTION

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

SYNOPSIS

#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); 

Valid options are:

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.

RETURN VALUES

> 0

Function was successful (the number of tasks launched).

< 0

Function failed.

ERRORS

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

SEE ALSO

Related API

none

Equivalent line command

blaunch

Files

none


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next