bjobs

---

介绍

bjobs 是用于 FSCHED 集群的任务状态查询工具，兼容 LSF 的 bjobs 命令语法。用户可通过此命令筛选、过滤任务，并自定义输出格式。

---

参数说明

支持参数列表

参数名称	是否需要值	描述	注意事项
-a	否	显示所有状态（包括最近完成）的任务。	无
-A	否	显示任务数组的汇总信息。	无
-d	否	显示最近完成或已终止的任务。	无
-G	是	按用户组筛选任务（需指定组名）。	不支持值为 all；不可与 -u 共用。
-J	是	按任务名称过滤，支持通配符 *（自动转义为正则表达式 .*）。	无
-Jd	是	按任务描述字段（注释）筛选，支持通配符 *。	自动将 * 替换为正则表达式 .*。
-l	否	长格式输出，每条任务信息多行显示。	不可与其他输出格式（如 -o, -UF, -w）共用。
-m	是	显示分配到指定主机的任务。	无
-noheader	否	移除输出的列标题。	无
-o	是	自定义输出格式（需配合语法使用）。	不可与其他输出格式共用；详细语法见下文。
-p	否	显示挂起任务及未被调度的原因。	无
-P	是	按项目名称筛选任务。	无
-q	是	按队列名称筛选任务。	无
-r	否	显示正在运行的任务。	无
-s	否	显示已挂起任务及暂停原因。	无
-u	是	按提交用户筛选（值为 all 表示所有用户）。	非 all 值需有效用户名；不可与 -G 共用。
-UF	否	显示未格式化的原始任务详细信息。	输出字段可能包含非结构化数据。
-w	否	宽格式输出，不截断字段内容（默认分隔符为 space）。	不可与其他输出格式共用。
-V	否	显示工具版本号。	无

---

自定义格式（-o 参数）

通过 -o 可自定义字段、对齐方式和宽度，并设置分隔符。语法示例：

语法结构：

[field_name[:[-]width][:unit_prefix]] [delimiter="分隔符"]

示例：

1. 基本格式：

   bjobs -o "jobid job_name stat"
2. 指定宽度与对齐：

   # 右对齐（默认）、左对齐（带 `-`）及固定宽度
   bjobs -o "jobid:10 stat:-5 user:8"
3. 自定义分隔符：

   bjobs -o "jobid description delimiter=, submit_time"

支持字段与别名：

字段名称	别名	内容描述
jobid	id	任务唯一标识符。
job_description	description	任务提交时的注释内容（可空）。
stat		当前状态（如 RUN, PEND, EXIT 等）。
user		提交用户名称。
exec_host		分配的计算节点列表（挂起任务显示为 -）。
job_name		任务名称。
queue		所属队列名。
from_host		提交任务的工作站主机名。
command		启动的命令（可空）。
submit_time		提交时间（格式：YYYY-MM-DD HH:MM）。
run_time		已运行时间（秒，完成任务显示为 0）。
nalloc_slot		分配的 CPU 核数。
cpu_exec_host		主机及分配核数格式（如 2*hostA,1*hostB）。

注意事项：

• 字段名敏感度：字段名称不区分大小写，但需与列表一致。
• 通配符处理：仅 -J, -Jd 支持通配符 *（自动转为正则表达式）。
• 单位前缀：当前暂未实现自动单位转换（如 KB/MB），字段值直接显示原始数值。

---

不支持的 LSF 功能

以下参数在 FSCHED 版本中不可用：

参数名称	原因
-N	无法统计归一化 CPU 时间。
-W, -WF, -WL, -WP	资源使用与进度估算不支持。

---

使用示例

1. 显示所有任务（包括已完成）

   bjobs -a

2. 按用户组筛选任务

   bjobs -G developers

3. 自定义输出格式（以逗号分隔）

   # 显示 ID、名称、状态及提交时间，用 `|` 分隔符：
   $ bjobs -o "jobid job_name stat submit_time delimiter='|'"

4. 过滤特定用户任务并禁用标题

   bjobs -u alice -noheader

5. 显示挂起任务及原因（宽格式）

   bjobs -p -w

---

注意事项

1. 参数冲突规则：

   • 格式选项 -l, -o, -UF, -w 互斥，不可同时使用。
   • 用户筛选 -G 和 -u 不可共用。

2. 用户与组验证：

   • 指定的用户名或组名需存在（除非 -u all）；无效名称将导致报错。

3. 通配符规则：
   在 -J 或 -Jd 中，输入 *test 会匹配所有包含 test 的任务名称/描述字段。

4. 未实现功能替代方案：

   • 需要资源统计时，建议改用 FSCHED 内置命令（如 squeue --Format=...）。

---

版本信息

执行以下命令查看工具版本：

bjobs -V