Parallel Computing Toolbox™

pctconfig

Configure settings for Parallel Computing Toolbox™ client session

Syntax

pctconfig('p1', v1, ...)
config = pctconfig('p1', v1, ...)
config = pctconfig()

Arguments

Description

pctconfig('p1', v1, ...) sets the client configuration property p1 with the value v1.

Note that the property value pairs can be in any format supported by the set function, i.e., param-value string pairs, structures, and param-value cell array pairs. If a structure is used, the structure field names are the property names and the field values specify the property values.

If the property is 'port', the specified value is used to set the port for the client session of Parallel Computing Toolbox software. This is useful in environments where the choice of ports is limited. By default, the client session searches for an available port to communicate with the other sessions of MATLAB^® Distributed Computing Server™ software. In networks where you are required to use specific ports, you use pctconfig to set the client's port.

If the property is 'hostname', the specified value is used to set the hostname for the client session of Parallel Computing Toolbox software. This is useful when the client computer is known by more than one hostname. The value you should use is the hostname by which the cluster nodes can contact the client computer. The toolbox supports both short hostnames and fully qualified domain names.

If the property is 'pmodeport', the specified value is used to set the port for communications with the labs in a pmode session.

config = pctconfig('p1', v1, ...) returns a structure to config. The field names of the structure reflect the property names, while the field values are set to the property values.

config = pctconfig(), without any input arguments, returns all the current values as a structure to config. If you have not set any values, these are the defaults.

Examples

View the current settings for hostname and ports.

config = pctconfig()
config = 
        port: 27370
    hostname: 'machine32'
   pmodeport: 27371

Set the current client session port number to 21000 with hostname fdm4.

pctconfig('hostname', 'fdm4', 'port', 21000');

Set the client hostname to a fully qualified domain name.

pctconfig('hostname', 'desktop24.subnet6.mathworks.com');

pause

pctRunOnAll