主要内容

平行的。工作

访问作业属性和行为

构造函数

createCommunicatingJobcreateJobfindJob重新创建

getCurrentJob(在MATLAB worker的工作空间中)

容器层次结构

平行的。集群

孩子们

平行的。任务

描述

一个平行的。工作对象提供对作业的访问,您可以创建、定义和提交作业以供执行。

类型

下表描述了可用的作业对象类型。作业类型由集群类型以及任务在执行过程中是否必须相互通信决定。

工作类型 描述
parallel.job.MJSIndependentJob MATLAB中独立任务的工作®作业调度器集群
parallel.job.MJSCommunicatingJob 在MATLAB Job Scheduler集群上进行任务通信的工作
parallel.job.CJSIndependentJob CJS集群上独立任务的工作
parallel.job.CJSCommunicatingJob CJS集群上的任务通信工作

方法

所有工作类型通用

以下方法对于所有作业对象类型都是通用的。

取消 取消工作或任务
createTask 在作业中创建新任务
删除 从集群和内存中删除作业或任务对象
日记 显示或保存批处理作业的命令窗口文本
fetchOutputs 从作业中的所有任务检索输出参数
findTask 属于作业对象的任务对象
listAutoAttachedFiles 自动附加到作业、任务或并行池的文件列表
负载 从批处理作业加载工作区变量
重新创建 从现有作业创建新作业
提交 在调度程序中排队作业
等待 等待作业改变状态

cj工作

CJS作业对象除了常用方法外,还有以下方法:

getTaskSchedulerIDs 作业中任务的调度器id

属性

所有工作类型通用

以下属性对于所有作业对象类型都是通用的。

财产 描述
AdditionalPaths 文件夹中添加到MATLAB搜索路径的工作者,指定为字符向量、字符串或字符串数组、或单元格数组的字符向量
AttachedFiles 发送给工作者的文件和文件夹,指定为字符向量、字符串或字符串数组或字符向量的单元格数组
AutoAddClientPath 指定客户端路径上用户添加的条目是否自动添加到每个工作者的路径
AutoAttachFiles 指定是否自动将依赖代码文件发送给工作者
CreateDateTime 创建作业的日期和时间
EnvironmentVariables 发送给工作线程的环境变量的名称
FileStore 在作业仍在运行时也可访问的作业的文件存储,指定为FileStore对象
FinishDateTime 作业完成运行的日期和时间
ID 作业的数字标识符
JobData 所有工作人员都可以获得工作任务的信息
的名字 工作名称
包含此作业的集群对象
RunningDuration 作业的当前持续时间,指定为持续时间对象
StartDateTime 作业开始运行的日期和时间
状态 工作状态:“等待”“排队”“奔跑”“完成”,或“失败”
SubmitDateTime 作业提交到队列的日期和时间
标签 与工作相关的标签
任务 作业中包含的任务对象数组
类型 工作类型:“独立”“池”,或“spmd”
用户数据 与作业对象关联的信息
用户名 拥有作业的用户名
ValueStore 作业的数据存储,即使作业仍在运行时也可访问,指定为ValueStore对象

当您将计算卸载到worker时,客户机上计算所需的任何文件也必须在worker上可用。缺省情况下,客户端尝试自动检测并挂载这些文件。若要关闭自动检测,请设置AutoAttachFiles属性为false。如果自动检测无法找到所有文件,或者从客户端向工作人员发送文件很慢,请使用以下属性。

  • 如果文件位于工作者无法访问的文件夹中,请设置AttachedFiles财产。集群将您指定的每个文件从客户机复制到worker。

  • 如果文件位于工作线程上可访问的文件夹中,则可以设置AdditionalPaths财产。使用AdditionalPaths属性为每个worker的MATLAB搜索路径添加路径,并避免将不必要的文件从客户端复制到worker。

MATLABJob Scheduler Job

MATLAB Job Scheduler独立作业对象和MATLAB Job Scheduler通信作业对象除了常见属性外,还具有以下属性:

财产 描述
AuthorizedUsers 被授权访问作业的用户
FinishedFcn 当作业完成时在客户端执行的回调函数
NumWorkersRange 运行工作的工人数量的最小和最大限制
QueuedFcn 当作业提交到队列时,在客户端执行的回调函数
RestartWorker 如果在评估该作业的第一个任务之前重新启动工作,则为
RunningFcn 当此作业开始运行时,在客户端执行的回调函数
超时 时间限制,以秒为单位,完成工作

cj工作

CJS独立作业对象除了所有作业类型共有的属性外,没有其他属性。

CJS通信作业对象除了常见属性外,还具有以下属性:

财产 描述
NumWorkersRange 运行工作的工人数量的最小和最大限制

帮助

以获得关于特定类型的并行程序的进一步帮助。工作对象,including a list of links to help for its properties, type帮助parallel.job。<作业类型>.例如:

帮助parallel.job.MJSIndependentJob

版本历史

在R2012a中引入