Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.3.3 - 日本語

Change language to:
English - Français - Português

Please note that the recommended version of Scilab is 2024.1.0. This page might be outdated.
However, this page did not exist in the previous stable version.

Scilab help >> PVM parallel Toolbox > pvm_spawn_independent


Starts new PVM processes.

Calling Sequence

[tids, numt] = pvm_spawn_independent(task, ntask, [where])



string, which is the executable file name of the PVM process to be started. The executable must already reside on the host on which it is to be started. The name may be a file in the PVM search path or an absolute path. The default PVM search path is $HOME/pvm3/bin/$PVM_ARCH/ .


integer, specifying the number of copies of the executable file to start.


string (optional), can be a host name such as ``'' or a PVM architecture class such as ``SUN4''.


integer, the actual number of tasks started. Values less than zero indicate a system error.


row of integers, array of the tids of the PVM processes started by this pvm_spawn_independent call.


pvm_spawn_independent starts ntask copies of the executable named task.

On systems that support environment variables, pvm_spawn_independent passes selected variables from parent environment to children tasks. If set, the envar PVM_EXPORT is passed. If PVM_EXPORT contains other names (separated by ':') they will be passed too. This is useful for e.g.:

setenv DISPLAY myworkstation:0.0
setenv MYSTERYVAR 13

The hosts on which the PVM processes are started are determined by the where arguments. On return the array tids contains the PVM task identifiers for each process started. If pvm_spawn_independent starts one or more tasks, numt will be the actual number of tasks started. If a system error occurs then numt will be < 0. If numt is les than ntask then some executables have failed to start. The last locations in the tids array will contain error codes (see below for meaning). Note that the first tids in the array are always valid.

When the argument where is omitted an heuristic (round-robin assignment) is used to distribute the ntask processes across the virtual machine.

In the special case where a multiprocessor is specified by where. pvm_spawn_independent will start all copies on this single machine using the vendor's underlying routines.

See Also

  • pvm — communications with other applications using Parallel Virutal Machine
  • pvm_spawn — Starts new Scilab processes.
<< pvm_spawn PVM parallel Toolbox pvm_start >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Wed Oct 05 12:13:00 CEST 2011