bhist

信息

该命令从fsched-10.87以后版本开始支持。

介绍

bhist用于查看作业的历史信息。

参数说明

选项	功能描述	主要差异
-a	显示已完成和未完成作业信息	无差异
-b	简要格式	无差异
-C	显示指定时间间隔内完成/退出的作业	无差异
-d	显示已完成作业信息	无差异
-D	显示指定时间间隔内调度的作业	无差异
-e	显示已退出作业信息	无差异
-h	打印帮助信息	实现了更详细的帮助信息
-J	显示指定作业名的作业	无差异
-Jd	按作业描述过滤	无差异
-l	长格式显示详细作业信息	细节在后面章节列出
-m	显示调度到指定主机的作业	无差异
-p	显示待处理作业信息	无差异
-P	显示属于指定项目的作业	无差异, project对应wckey
-q	显示提交到指定队列的作业	无差异
-r	显示运行中作业信息	无差异
-s	显示挂起作业信息	无差异
-S	显示指定时间间隔内提交的作业	无差异
-u	显示指定用户提交的作业	无差异
-V	打印版本信息	无差异
-w	宽格式显示	无差异

默认的输出项

输出项	功能描述	主要差异
Time Summary	统计作业在不同状态下花费的时间
- PEND	作业的总等待时间（不包括用户挂起时间）	无差异
- PSUSP	待处理作业的用户挂起总时间	不支持挂起pending job
- RUN	作业的总运行时间	无差异
- USUSP	作业被调度后的用户挂起总时间	显示挂起时间，不区分用户还是系统挂起
- SSUSP	作业被调度后的系统挂起总时间	dummy值为0
- UNKWN	作业的未知状态总时间	dummy值为0
- TOTAL	作业在所有状态下的总时间	显示PEND+RUN+USUSP

-l选项的输出项

输出项	功能描述	主要差异
Project	作业提交所属项目	无差异, project对应wckey
Command	作业命令	作业完成一段时间后Command无法显示
Requested Resources	bsub命令中指定的所有资源需求字符串	只显示rusage[mem=xxx]
Execution CWD	作业运行时的实际工作目录	无差异
Effective RES_REQ	调度器解析OR构造后看到的实际资源需求	select和order为dummy值，rusage显示mem值
Terminated jobs	显示终止作业的退出原因	退出的原因是dummy值
Interactive jobs	交互式作业的特殊信息显示	输出还包括CWD,home
Dispatched Tasks	显示分配的任务数和主机	无差异
Allocated Slots	当LSB_ENABLE_HPC_ALLOCATION=Y时显示分配的槽位数和主机	无差异
Pid	作业进程ID	作业完成后Pid无法显示
Suspend event time	作业挂起的时刻	拿不到作业挂起的时刻，按照只有一次挂起估算
Memory usage information	显示峰值内存使用量和平均内存使用	无差异
Submit host	提交节点	作业完成一段时间后Submit host无法显示
Queue	队列名称	无差异
Job Description	作业描述	无差异

job_id过滤条件

过滤项	功能描述	主要差异
默认无	显示所有历史任务	为了防止任务太多导致数据库压力，限制默认查询过去一周的任务，也可以通过筛选选项中的-C参数设定查询范围，-D和-S仍会查询过去一周的任务，再在结果中筛选
job_ID...	恢复指定id的一个或多个任务。	无差别
job_ID[index_list]...	恢复指定id和index_list的一个或多个任务。	无差别

使用示例

1. 显示指定任务

   bhist 11301

2. 按用户筛选任务

   bhist -u test

3. 显示过去一天内的任务

   bhist -C .-1, -a

注意事项

• wrapper中为了防止任务太多导致数据库压力，限制默认查询过去一周的任务，也可以通过筛选选项中的-C参数设定查询范围
• 如果查询范围内任务很多，仍然有可能导致数据库压力。