Main Content

pmode

(Removed) Interactive Parallel Command Window

pmode has been removed. Use spmd instead. For more information, see Version History.

Syntax

pmode start
pmode start numworkers
pmode start prof numworkers
pmode quit
pmode exit
pmode client2lab clientvar workers workervar
pmode lab2client workervar worker clientvar
pmode cleanup prof

Description

pmode allows the interactive parallel execution of MATLAB® commands. pmode achieves this by defining and submitting a communicating job, and opening a Parallel Command Window connected to the workers running the job. The workers then receive commands entered in the Parallel Command Window, process them, and send the command output back to the Parallel Command Window. Variables can be transferred between the MATLAB client and the workers.

pmode start starts pmode, using the default profile to define the cluster and number of workers. (The initial default profile is Processes; you can change it by using the function parallel.defaultProfile.) You can also specify the number of workers using pmode start numworkers.

pmode start prof numworkers starts pmode using the Parallel Computing Toolbox™ profile prof to locate the cluster, submits a communicating job with the number of workers identified by numworkers, and connects the Parallel Command Window with the workers. If the number of workers is specified, it overrides the minimum and maximum number of workers specified in the profile.

pmode quit or pmode exit stops the pmode job, deletes it, and closes the Parallel Command Window. You can enter this command at the MATLAB prompt or the pmode prompt.

pmode client2lab clientvar workers workervar copies the variable clientvar from the MATLAB client to the variable workervar on the workers identified by workers. If workervar is omitted, the copy is named clientvar. workers can be either a single index or a vector of indices. You can enter this command at the MATLAB prompt or the pmode prompt.

pmode lab2client workervar worker clientvar copies the variable workervar from the worker identified by worker, to the variable clientvar on the MATLAB client. If clientvar is omitted, the copy is named workervar. You can enter this command at the MATLAB prompt or the pmode prompt. Note: If you use this command in an attempt to transfer a codistributed array to the client, you get a warning, and only the local portion of the array on the specified worker is transferred. To transfer an entire codistributed array, first use the gather function to assemble the whole array into the worker workspaces.

pmode cleanup prof deletes all communicating jobs created by pmode for the current user running on the cluster specified in the profile prof, including jobs that are currently running. The profile is optional; the default profile is used if none is specified. You can enter this command at the MATLAB prompt or the pmode prompt.

You can invoke pmode as either a command or a function, so the following are equivalent. 

pmode start prof 4
pmode('start','prof',4)

Examples

In this example, the pmode prompt (P>>) indicates commands entered in the Parallel Command Window. Other commands are entered in the MATLAB Command Window.

Start pmode using the default profile to identify the cluster and number of workers.

pmode start

Version History

Introduced in R2006b

expand all

R2023a: pmode has been removed

The pmode function has been removed. To execute commands interactively on multiple workers, use spmd instead.

See Also