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

findJob

查找集群中的作业对象

全页折叠

    语法

    objArray = findJob(cluster)
    objArray = findJob(cluster,propertyName=Value)
    [pending,queued,running,completed] = findJob(___)

    说明

    objArray = findJob(cluster) 返回集群 cluster 中的所有作业对象的数组。数组中的作业按照其 ID 属性的顺序排列，表明它们的创建顺序。

    示例

    objArray = findJob(cluster,propertyName=Value) 使用一个或多个属性名称-值参量指定要查找的属性和值。有关作业属性的列表，请参阅 parallel.Job。

    对象属性值必须与指定的值完全匹配。例如，如果某个作业的 Name 属性值为 MyJob，则 findJob 在搜索 Name 属性值为 myjob 的作业时找不到该对象。

    示例

    [pending,queued,running,completed] = findJob(___) 对集群中存储的所有作业对象按状态进行排序。在 pending、running 和 completed 作业数组中，软件按照 ID 属性的顺序返回作业。queued 作业数组中的作业按照调度器对其进行排队的顺序执行，其中 queued(1) 对应的作业是下一个要执行的。已完成的作业包括失败的作业。此函数不会返回已删除或状态不可用的作业。

    示例

    示例

    全部折叠

    打开实时脚本

    使用默认配置文件创建一个集群，并使用batch向集群提交随机数量的作业。

    myCluster = parcluster;
numJobs = randi(50);
for idx = 1:numJobs
    job = batch(myCluster,@magic,1,{idx});
end

    查找提交给集群的作业数量。 

    objArray = findJob(myCluster);
whos objArray
      Name           Size            Bytes  Class                             Attributes

  objArray      10x1                80  parallel.job.CJSIndependentJob

    确定提交到集群的作业的 State 属性。

    [pending,queued,running,completed] = findJob(myCluster);

    列出 ID 状态的作业的 completed 属性。 

    completed.ID
    ans = 120

    ans = 121

    ans = 122

    ans = 123
    打开实时脚本

    使用默认配置文件创建一个集群，并使用createJob向集群提交作业。

    myCluster = parcluster;
job1 = createJob(myCluster,Tag="testing");
job2 = createJob(myCluster,Name="MonteCarlo",Tag="testing");
job3 = createJob(myCluster,Name="MonteCarlo2",Tag="testing");

    查找 Tag 属性值为 testing 的作业。

    objArray = findJob(myCluster,Tag="testing");
objArray.Name
    ans = 
'Job23'

    ans = 
'MonteCarlo'

    ans = 
'MonteCarlo2'

    最后，通过添加 Tag 属性值 testing 形式的另一个搜索条件，缩小 Name 属性值为 MonteCarlo 的作业列表。

    objArray = findJob(myCluster,Name="MonteCarlo",Tag="testing");
objArray.Name
    ans = 
'MonteCarlo'

    输入参数

    全部折叠

    在其中搜索作业的集群，指定为代表集群计算资源的 parallel.Cluster 对象。要创建集群对象，请使用 parcluster 函数。

    要查找的作业对象属性名称和值，指定为 parallel.job 属性名称-值参量。如果指定多个属性名称-值参量，findJob 将返回满足所有搜索条件的条目。有关作业对象属性的完整列表，请参阅 parallel.Job。

    示例: findJob(cluster,Username="jsmith") 查找 Username 属性值为 jsmith 的作业对象。

    输出参量

    全部折叠

    集群中符合搜索条件的作业，以 parallel.Job 对象数组的形式返回。

    集群上处于待处理状态的作业，以 parallel.Job 对象数组的形式返回。

    集群上处于排队状态的作业，以 parallel.Job 对象数组的形式返回。

    集群上处于运行状态的作业，以 parallel.Job 对象数组的形式返回。

    集群上处于完成或失败状态的作业，以 parallel.Job 对象数组的形式返回。

    版本历史记录

    在 R2006a 之前推出

    另请参阅

    |