跳到主要内容

bjobs

介绍​

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

参数说明​

支持参数列表​

选项功能描述主要差异
-A显示job arrays的摘要信息无差异
-a显示所有状态的作业（包括最近完成的作业）已完成job的默认清理时间不同：lsf 1小时，fsched 900秒
-d显示最近完成的作业信息已完成job的默认清理时间不同：lsf 1小时，fsched 900秒
-G显示指定用户组的作业无差异
-J显示指定名称的作业或作业阵列无差异
-Jd显示指定描述的作业无差异
-l长格式显示每个作业的详细信息（多行输出）细节在后面章节列出
-m显示分发到指定主机的作业无差异
-noheader移除输出的列标题无差异
-o设置自定义输出格式细节在后面章节列出
-P显示指定项目的作业无差异, project对应wckey
-p显示待处理作业及其未分发原因无差异
-q显示指定队列的作业无差异
-r显示运行中的作业无差异
-s显示挂起的作业及其挂起原因能筛选挂起的作业，挂起原因可能会显示None
-UF显示未格式化的作业详细信息无差异
-u显示指定用户或用户组提交的作业支持指定用户和all, 不支持指定用户组
-w宽格式显示（不截断字段）无差异
-json以JSON格式显示输出无差异
job_id指定要显示的作业或作业阵列已完成job的默认清理时间不同：lsf 1小时，fsched 900秒
-h显示帮助信息实现了更详细的帮助信息
-V打印LSF版本号无差异

默认的输出项​

输出项功能描述主要差异
JOBID作业ID无差异
USER提交作业的用户无差异
STAT作业状态USUSP和SSUSP的区分可能不一致，无UNKWN,WAIT,ZOMBI状态
QUEUE作业所属队列无差异
FROM_HOST作业提交主机无差异
EXEC_HOST作业执行主机无差异
JOB_NAME作业名称无差异
SUBMIT_TIME作业提交时间无差异

-l选项的输出项​

输出项功能描述主要差异
JobLSF分配的作业ID无差异
User提交作业的用户无差异
Project作业所属项目无差异, project对应wckey
Command作业执行的命令无差异
CWD提交主机上的工作目录无差异
Execution CWD作业运行时的实际工作目录无差异
Migration threshold通过bsub -mig指定的迁移阈值无差异
PENDING REASONS作业处于PEND或PSUSP状态的原因显示简化的原因
SUSPENDING REASONS作业处于USUSP或SSUSP状态的原因显示简化的原因
loadSched作业的负载调度阈值无差异
loadStop作业的负载挂起阈值无差异
JOB STATUS作业状态USUSP和SSUSP的区分可能不一致，无UNKWN,WAIT,ZOMBI状态
RESOURCE USAGE资源使用情况已实现CPU time,MEM,NTHREAD,PGID,PIDS, 未实现SWAP
Requested resourcesbsub命令中指定的资源需求字符串实现了rusage[mem=xxx]，未实现其它
JOB_DESCRIPTION用户分配的作业描述无差异
MEMORY USAGE内存使用详情实现了MAX MEM和AVG MEM，MAX MEM取各节点最大内存值，AVG MEM取各节点内存和对task数平均
RESOURCE REQUIREMENT DETAILS资源请求细节实现了rusage[mem=xxx]，并显示dummy的select[type == local] order[r15s:pg]，未实现其它
SCHEDULING PARAMETERS负载阈值信息只显示queue配置的负载阈值，不支持host配置的负载阈值。实现了r15s,r1m,r15m,ut,mem,未实现pg,io,ls,it,tmp,swp

-A选项的输出项​

输出项功能描述主要差异
JOBIDjob array的作业ID无差异
ARRAY_SPECname[index]格式的job array描述无差异
OWNERjob array的所有者无差异
NJOBSjob array中的作业总数无差异
PENDjob array中处于PEND状态的作业数量无差异
RUNjob array中处于RUN状态的作业数量无差异
DONEjob array中成功完成的作业数量无差异
EXITjob array中异常退出的作业数量无差异
SSUSPjob array中被系统挂起的作业数量dummy值，为0
USUSPjob array中被用户挂起的作业数量计入所有状态为suspended的作业数
PSUSPjob array中被暂停的作业数量dummy值，为0

自定义格式（-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"

支持字段与别名：​

字段名称别名内容描述
jobidid任务唯一标识符。
job_descriptiondescription任务提交时的注释内容（可空）。
stat当前状态（如 RUN, PEND, EXIT 等）。
user提交用户名称。
exec_host分配的计算节点列表（挂起任务显示为 -）。
job_name任务名称。
queue所属队列名。
from_host提交任务的工作站主机名。
command启动的命令（可空）。
submit_time提交时间（格式：YYYY-MM-DD HH:MM）。
start_time作业开始时间（格式：YYYY-MM-DD HH:MM）。
finish_time作业完成时间（格式：YYYY-MM-DD HH:MM）。
run_time已运行时间（秒，完成任务显示为 0）。
nalloc_slot分配的 CPU 核数。
cpu_exec_host主机及分配核数格式（如 2*hostA,1*hostB）。
account作业的账户信息。
requeue作业是否可重新排队。
tmp_disk临时磁盘空间需求（MB）。
min_nodes最小节点数要求。
max_nodes最大节点数要求。
ntasks_per_node每节点任务数。

注意事项：​

  • 字段名敏感度：字段名称不区分大小写，但需与列表一致。
  • 通配符处理：仅 -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