Visit Platform at http://www.platform.com

ls_rtask

Starts a remote task on a specified host.

This routine is for executing remote tasks. It is modeled after the UNIX fork and execv system calls.

ls_rtask starts a remote task on the specified host. This routine is basically a remote fork followed by an execv. The arguments are identical to those of ls_rexecv. ls_rtask is typically used by a parallel application to execute multiple remote tasks efficiently. When a remote task finishes, a SIGUSR1 signal is delivered back to the application, and its status can be collected by calling ls_rwait or ls_rwaittid. ls_rtask returns a unique task ID to be used by the application to differentiate outstanding remote tasks. It returns -1 on failure.

Any program using this routine must call ls_initrex first.

Any program using these routines must be setuid to root if LSF_AUTH is not defined in the lsf.conf file.

The remote file operations make use of a Remote File Server on the remote host. When this RFS shuts down, its status will be reported to its client. The client should ignore this status.

#include <lsf/lsf.h>

int ls_rtask(char *host, char **argv, int options)

Parameters:
*host The remote host where the program is executed.
**argv The program being used.
options options_rexec
Data Structures:
none
Define Statements:
options_rexec
Returns:
int:Unique TaskID
Function was successful.

int:-1
Function failed.

Errors:
Systems that conform to the Single UNIX specification are not required to detect error conditions for this function.
Equivalent line commands:
none
Files:
${LSF_ENVDIR:-/etc}/lsf.conf
See also:
ls_rexecv

ls_rexecve

ls_rtaske

ls_rfcontrol

ls_chdir

ls_conntaskport

ls_rsetenv

ls_initrex



     
Date Modified: 28 Jun 2011
Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Platform Computing. Accelerating Intelligence(TM).
Copyright © 1994-2011 Platform Computing Corporation. All rights reserved.