Main Content

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

parallel.Task

访问任务属性和行为

构造函数

createTask, findTask

getCurrentTask(在 MATLAB 工作进程的工作区中)

容器层次结构

parallel.Job

描述

parallel.Task 对象提供对任务的访问,该工作进程作为作业上执行。

类型

下表描述了可用的任务对象类型,由集群的类型决定。

任务类型描述
parallel.task.MJSTaskMATLAB® 作业调度器集群上的任务
parallel.task.CJSTaskCJS 集群上的任务

方法

所有任务类型对象都有相同的方法,如下表所述。

cancelCancel job or task
deleteRemove job or task object from cluster and memory

属性

适用于所有任务类型

以下属性是所有任务对象类型所共有的。

属性描述
CaptureDiary指定是否返回日记输出
CreateDateTime任务创建的日期和时间
Diary执行任务对象的函数产生的文本
Error任务错误信息
ErrorIdentifier任务错误标识符
ErrorMessage任务错误信息
FinishDateTime任务完成的日期和时间
Function评估任务时调用的函数
ID任务的数值标识符
InputArguments任务函数的输入参量
Name此任务的名称
NumOutputArguments任务函数返回的参量数量
OutputArguments在工作进程上运行任务函数的输出参量
Parent包含此任务的作业对象
RunningDuration任务的当前持续时间,指定为 duration 对象。
StartDateTime任务开始的日期和时间
State任务的当前状态
UserData与此任务对象关联的信息
Warnings任务执行过程中发出的警告信息,被捕获在一个包含字段 messageidentifierstack 的结构数组中
Worker表示运行此任务的工作进程的对象

MATLAB 作业调度器任务

MATLAB 作业调度器任务对象除了具有公共属性外,还具有以下属性:

属性描述
FailureInfo失败任务返回的信息
FinishedFcn任务完成时在客户端执行回调
MaximumRetries重新运行失败任务的最大次数
NumFailures任务失败的次数
RunningFcn任务开始运行时在客户端执行的回调
Timeout完成任务的时间限制(以秒为单位)

CJS 任务

CJS 任务对象除了具有公共属性外,还具有以下属性:

属性描述
SchedulerID

如果您已将任务提交给第三方调度器,这是调度器在提交时为任务提供的 ID。例如,这对应于 SLURM 调度器上的 JOBID

帮助

要获得有关任一类型的 parallel.Task 对象的更多帮助,包括其属性的帮助链接列表,请输入:

help parallel.task.MJSTask
help parallel.task.CJSTask

版本历史记录

在 R2012a 中推出