Main Content

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 by parpool("threads") and backgroundPool.

Version History

Introduced in R2008a

See Also