qstat

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

---

参数介绍

可选参数列表

参数	是否需要值	取值范围	用途
-u	是	用户名列表或 *（逗号分隔）	过滤特定用户的作业。若用户名无效则忽略该用户
-f	否	无	显示全格式信息，包含更多详细字段
-j	是	整数	查看指定作业ID的详细状态
-xml	否	无	将输出转换为XML格式
-g	是	c/d/t	控制结果分组方式：集群级（c）、数组作业（d）或并行任务（t）
-s	可选	状态字符组合	过滤特定状态的作业，可省略参数值以显示所有状态

---

参数详细说明

-u <用户列表>

• 用途：限制显示指定用户的作业。支持逗号分隔的用户名列表（例如 user1,user2）或使用 * 表示所有用户。
• 注意事项：若输入的用户名不存在，该用户会被忽略。

-f

• 用途：启用全格式输出，显示作业的详细字段（如资源占用、队列名称等）。

-j <job_id>

• 用途：仅显示指定作业ID job_id 的信息。若作业不存在则无结果返回。

-xml

• 用途：将输出格式转换为XML，便于程序解析或自动化处理。

-g [c|d|t]

• 取值说明：
  • c: 按集群级分组（默认行为）。
  • d: 按数组作业分组（适用于批量任务）。
  • t: 按并行任务分组。
• 错误处理：输入非 c/d/t 的值将触发报错。

-s [状态过滤符]

• 用途：按作业状态筛选结果。若省略参数值，则不应用任何状态过滤（显示所有状态）。
• 可用过滤符及组合规则：
  • 单字符选项：
    • p: 待处理 (Pending)
    • r: 运行中 (Running)
    • s: 挂起 (Suspended)
    • z: 已完成 (Done)
  • 保留状态（Hold）的组合形式：
    • 单独使用 h → 匹配所有类型的保留作业。
    • 配合后缀指定具体类型：
      • hu: 用户保留
      • ho: 管理员保留
      • hs: 系统保留
      • hd: 数组任务保留
      • hj: 作业级保留
      • ha: 时间触发保留
    • 示例：-s huo 匹配管理员保留 (ho) 和用户保留 (hu) 的作业。
  • 特殊标记：
    • a: 覆盖其他条件，匹配所有状态。

---

使用示例

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

qstat -u userA,userB -f

• 效果：显示用户 userA 和 userB 的全格式作业信息。

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

qstat -s r

• 效果：仅列出当前处于运行状态的作业。

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

qstat -j 12345 -xml

• 效果：以XML格式显示作业 12345 的详细信息。

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

qstat -g d -s huo

• 效果：按数组作业分组，并筛选出处于用户或管理员保留状态的作业。

---

注意事项

1. 用户名必须存在，否则会被忽略（不影响其他参数）。
2. 状态过滤符 -s 的值需严格遵循字符规则（如 h 后接有效后缀）。
3. 若同时使用多个条件（例如 -u userA -j 12345），仅符合所有条件的作业会被显示。
4. 使用 -xml 格式时，输出包含技术性字段，具体结构可参考系统文档。