Main Content


Configure settings for Parallel Computing Toolbox client session



pctconfig(Name,Value) sets client configuration properties for the client session using name-value arguments.

Name-value arguments can be in any format supported by the set function, i.e., character vectors, structures, and cell arrays. If you provide name-value arguments using a structure, the structure field names must be the property names and the field values must specify the property values.

config = pctconfig(Name,Value,...) also returns configuration settings as the structure config. The field names of the config contain the property names, while the field values contain the property values.

config = pctconfig() returns the current configuration settings as the structure config. If you have not set any values, these are the default values.


collapse all

This example shows how to configure the settings for a Parallel Computing Toolbox™ client session.

View the current settings for hostname and ports.

config = pctconfig()
config = 
    portrange: [27370 27470]
     hostname: 'machine32'

Set the current client session port range to 21000-22000 with hostname fdm4.

pctconfig('hostname','fdm4','portrange',[21000 22000]);

Set the client hostname to a fully qualified domain name.


Input Arguments

collapse all

Name-Value Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'hostname',''

Name of host of the client session, specified as a character vector.

This property is useful when the client computer is known by more than one hostname. Specify a hostname by which the cluster nodes can contact the client computer. Parallel Computing Toolbox supports both short hostnames and fully qualified domain names.

Range of ports for the client session specified as one of the following:

  • two-element vector — Specify the range of ports to use, in the form [minport, maxport]

  • 0 — Specify ephemeral ports

By default, the client session searches for available ports to communicate with MATLAB® Parallel Server™ sessions.

Output Arguments

collapse all

Configuration settings, returned as a structure.


The values set by this function do not persist between MATLAB sessions. To ensure your configuration settings are correct, use pctconfig before calling any other Parallel Computing Toolbox functions.

Introduced in R2008a