本页采用了机器翻译。点击此处可查看最新英文版本。

pctconfig

配置 Parallel Computing Toolbox 客户端会话或 MATLAB Parallel Server 工作单元的设置

全页折叠

语法

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

说明

pctconfig(Name,Value) 使用名称-值参量为客户端会话或工作单元设置配置属性。

名称-值参量可以采用 set 函数支持的任何格式，即字符向量、结构体和元胞数组。如果使用结构体提供名称-值参量，则结构体字段名称必须是属性名称，而字段值必须指定属性值。

示例

config = pctconfig(Name,Value,...) 还以结构体 config 的形式返回配置设置。config 的字段名称包含属性名称，而字段值包含属性值。

config = pctconfig() 以结构体 config 的形式返回当前配置设置。如果您未设置任何值，则这些是默认值。

示例

全部折叠

此示例显示如何配置 Parallel Computing Toolbox™ 客户端会话的设置。

查看主机名和端口的默认设置。

config = pctconfig()
config = 

  struct with fields:

           portrange: [27370 28370]
            hostname: 'machine-32'
    poolstarttimeout: 20 min

将当前客户端会话端口范围设置为 21000-22000，主机名为 fdm4。

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

将客户端主机名设置为完全限定域名。

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

自 R2023a 起

此示例显示如何指定 MATLAB® Parallel Server™ 工作单元必须打开哪些监听端口。

使用 poolStartup.m 文件设置工作单元在 27350 - 27424 范围内打开一个监听端口。

每次当工作单元成为并行池的一部分时，poolStartup.m 文件就会自动在工作单元上运行。有关 poolStartup.m 文件的信息，请参阅 poolStartup。在 poolStartup.m 文件中添加以下代码：

pctconfig(portrange=[27350 27424])

名称-值参数

全部折叠

将可选参量对指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是相应的值。名称-值参量必须出现在其他参量之后，但对的顺序并不重要。

在 R2021a 之前，使用逗号分隔每个名称和值，并将 Name 括在引号中。

示例: 'hostname','desktop24.subnet6.companydomain.com'

客户端会话的主机名称，指定为字符向量。

当客户端计算机有多个主机名时，此属性很有用。指定集群节点可以用来联系客户端计算机的主机名。Parallel Computing Toolbox 同时支持短主机名和完全限定域名。

打开监听端口时使用的端口范围，指定为下列之一：

  • 二元素向量 - 指定要使用的端口范围，格式为 [minport, maxport]

  • 0 - 指定临时端口

默认情况下，客户端会话会搜索可用端口来与 MATLAB Parallel Server 工作单元进行通信。

在 R2023a 中: 当您创建交互式并行池时，MATLAB Parallel Server 工作单元使用端口号范围来监听来自客户端会话的连接。要在工作单元上打开监听端口，请在 poolStartup 文件中指定 'portrange' 的值。有关示例，请参阅 配置工作单元上的设置。

输出参量

全部折叠

配置设置，以结构体形式返回。

提示

此函数设置的值不会在 MATLAB 客户端或工作单元会话之间持续存在。为了确保您的配置设置正确，请在调用任何其他 Parallel Computing Toolbox 函数之前使用 pctconfig。

版本历史记录

在 R2008a 中推出

全部展开