pctRunOnAll
Run command on client and all workers in parallel pool
Syntax
pctRunOnAll command
Description
pctRunOnAll command
runs the specified
command
on all the workers of the parallel pool as well as
the client, and prints any command-line output back to the client Command Window.
The specified command
runs in the base workspace of the workers
and does not have any return variables. This is useful if there are setup changes
that need to be performed on all the workers and the client.
Note
If you use pctRunOnAll
to run a command such as
addpath
in a mixed-platform environment, it can generate
a warning on the client while executing properly on the workers. For example, if
your workers are all running on Linux® operating systems and your client is running on a Microsoft®
Windows® operating system, an addpath
argument with
Linux-based paths will warn on the Windows-based client.
Examples
Clear all loaded functions on all workers:
pctRunOnAll clear functions
Change the directory on all workers to the project directory:
pctRunOnAll cd /opt/projects/c1456
Add some directories to the paths of all the workers:
pctRunOnAll addpath({'/usr/share/path1' '/usr/share/path2'})
Limitations
pctRunOnAll
does not support thread-based pools, such as those created byparpool("threads")
andbackgroundPool
.
Version History
Introduced in R2008a