跳到主要内容

qstat

查看作业队列的状态和详细信息,支持过滤用户、状态及输出格式控制。


参数介绍

可选参数列表

参数是否需要值取值范围用途主要差异
-u用户名列表或 *(逗号分隔)过滤特定用户的作业。支持通配符无差异
-f显示全格式队列信息,包含队列摘要和作业列表无差异
-j作业ID查看指定作业ID的详细状态无差异
-xml将输出转换为XML格式无差异
-gc/d/t控制结果分组方式:集群级(c)、数组作业(d)或并行任务(t)-g t:所有任务显示相同队列,第一个为MASTER,其余为SLAVE
-s可选状态字符组合过滤特定状态的作业,可省略参数值以显示所有状态无差异
-q队列名称按队列过滤作业无差异
-t显示数组作业的任务信息(等同于 -g d无差异
-r显示作业的资源需求Soft Resources始终为空,Binding固定为 "NONE"
-pri显示作业优先级信息nurg/npprior/ntckts/ppri为dummy值(0.0)
-urg显示作业紧急度信息所有字段为dummy值(0.0)
-ext显示作业的扩展属性department为dummy值 "defaultdep",tickets/share为dummy值
-ncb抑制绑定参数(与 -r 配合使用)无差异
-explain状态字符(a/c/A/E)解释队列状态无差异
-F可选资源属性列表(逗号分隔)显示队列资源属性支持的属性:mem_total, num_proc, qname, slots
-U用户名显示用户可访问的队列简化实现
-ne隐藏空队列无差异
-qs队列状态字符按状态过滤队列无差异
-l资源表达式按资源需求过滤队列/作业支持 arch=, num_proc=, mem_total=

输出项说明

默认的输出项

输出项功能描述主要差异
job-ID作业ID
prior作业优先级(0-1)
name作业名称
user作业所属用户
state作业状态
submit/start at提交/开始时间
queue队列@主机
slots作业槽位数
ja-task-ID数组作业任务ID

-r 选项的输出项

显示作业的资源需求,在作业行下方添加资源信息:

输出项功能描述主要差异
Full jobname完整作业名称
Requested PE请求的并行环境从comment字段提取
Hard Resources硬资源需求资源优先级为dummy值(0.000000)
Soft Resources软资源需求始终为空(dummy值)
Binding核心绑定信息固定为dummy值 "NONE"

-pri 选项的额外列

输出项功能描述主要差异
nurg归一化紧急度固定为dummy值 0.0
npprior归一化优先级固定为dummy值 0.0
ntckts归一化tickets固定为dummy值 0.0
ppriPOSIX优先级固定为dummy值 0

-urg 选项的额外列

输出项功能描述主要差异
nurg归一化紧急度固定为dummy值 0.0
urg紧急度值固定为dummy值 0.0
rrcontr资源保留贡献固定为dummy值 0.0
wtcontr等待时间贡献固定为dummy值 0.0
dlcontr截止时间贡献固定为dummy值 0.0
deadline作业截止时间固定为dummy值(空字符串)

-ext 选项的额外列

输出项功能描述主要差异
ntckts归一化tickets固定为dummy值 0.0
project项目名称
department部门名称固定为dummy值 "defaultdep"
cpuCPU使用时间运行中作业为空
mem内存使用运行中作业为空
ioIO使用运行中作业为空
tckts总tickets固定为dummy值 0
ovrtsOverride tickets固定为dummy值 0
otckt其他tickets固定为dummy值 0
ftcktFunctional tickets固定为dummy值 0
stcktShare tree tickets固定为dummy值 0
shareShare tree值固定为dummy值 0.00

-f 选项的输出项

显示完整队列信息,包含队列摘要和作业列表:

输出项功能描述主要差异
queuename队列名称
qtype队列类型固定为dummy值 "BIP"
resv/used/tot保留/已用/总槽位数resv 固定为dummy值 0
load_avg平均负载
arch架构
states队列状态

-g c 选项的输出项

输出项功能描述主要差异
CLUSTER QUEUE集群队列名称
CQLOAD队列平均负载
USED已用槽位数
RES保留槽位数固定为dummy值 0
AVAIL可用槽位数
TOTAL总槽位数
aoACDS队列实例状态摘要
cdsuE队列状态详情

-j 选项的输出项

显示作业的详细信息,包含以下字段:

基本信息Job Number, Job Name, Owner, State, Submission Time, Start Time, Queue, Slots

资源信息(仅运行中或完成的作业):Requested Resources, Granted Resources

其他信息

  • Parallel Environment - 从comment字段提取,无则显示 "NONE"
  • Project - 从wckey获取
  • Department - 固定为dummy值 "defaultdep"

-g t 选项的输出项

显示并行作业的任务信息

输出项功能描述主要差异
masterMASTER/SLAVE标识所有任务显示相同队列,第一个为MASTER,其余为SLAVE

使用示例

示例1:查看特定用户的详细信息

qstat -u userA,userB -f
  • 效果:显示用户 userAuserB 的全格式作业信息。

示例2:筛选运行中的作业

qstat -s r
  • 效果:仅列出当前处于运行状态的作业。

示例3:查看特定作业的XML输出

qstat -j 12345 -xml
  • 效果:以XML格式显示作业 12345 的详细信息。

示例4:按数组任务分组并过滤保留状态

qstat -g d -s huo
  • 效果:按数组作业分组,并筛选出处于用户或管理员保留状态的作业。

示例5:显示作业的资源需求

qstat -r
  • 效果:显示作业的完整名称、并行环境和资源需求(Hard Resources, Soft Resources, Binding)。

示例6:显示作业扩展属性

qstat -ext
  • 效果:显示作业的项目、部门、CPU/内存/IO使用和tickets信息。

示例7:显示集群队列摘要

qstat -g c
  • 效果:显示所有队列的摘要信息,包括负载、槽位使用情况和状态。

示例8:按队列过滤并显示资源属性

qstat -F -q compute
  • 效果:显示指定队列的资源属性(内存、CPU数量、槽位等)。