Main Content

pctconfig

Configure settings forParallel Computing Toolboxclient session

所有的页面崩溃

Syntax

pctconfig(Name,Value)
config = pctconfig(Name,Value,...)
config = pctconfig()

Description

example

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 thesetfunction, 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 structureconfig. The field names of theconfigcontain the property names, while the field values contain the property values.

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

Examples

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 to21000-22000with hostnamefdm4.

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

Set the client hostname to a fully qualified domain name.

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

Input Arguments

collapse all

Name-Value Arguments

Specify optional pairs of arguments asName1=Value1,...,NameN=ValueN, whereNameis the argument name andValueis the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and encloseNamein quotes.

Example:'hostname','desktop24.subnet6.companydomain.com'

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 withMATLAB®Parallel Server™sessions.

Output Arguments

collapse all

Configuration settings, returned as a structure.

Tips

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

版本sion History

Introduced in R2008a