定制队列信息输出

缺省情况下, bqueues 命令显示一组预定义的队列信息。 虽然您可以根据需要使用各种 bqueues 选项来显示特定队列信息,但也可以定制 bqueues 显示的特定字段。 定制输出以创建显示所有必需信息的特定 bqueues 输出格式,以便您可以使用定制脚本轻松解析信息或以预定义格式显示信息。

使用 lsf.conf 中的 LSB_BQUEUES_FORMAT 参数或 LSB_BQUEUES_FORMAT 运行时环境变量来定义 LSF的缺省 bqueues 输出格式:

LSB_BQUEUES_FORMAT="field_name[:[-][output_width]] ... [delimiter='character']"

使用 bqueues -o 选项在命令级别定义定制输出:

bqueues ... -o "field_name[:[-][output_width]] ... [delimiter='character']"

对于 csh 环境中的特殊定界字符 (例如, $) ,建议使用以下替代方法来使用 bqueues -o :

bqueues ... -o 'field_name[:[-][output_width]] ... [delimiter="character"]'

  • 指定要显示的 bqueues 字段 (或别名,而不是完整字段名称) ,顺序和宽度。
  • 仅指定 bqueues 字段名称或别名,以将其输出设置为无限宽度和左对齐。
  • (从 FP14 开始可用) 指定 all 以显示所有字段。 指定具有应用于所有字段的输出宽度的冒号 (:)。
  • 指定不带宽度的冒号 (:) 以将输出宽度设置为该字段的受支持宽度。
  • 指定带有宽度的冒号 (:) ,以设置要为字段显示的最大字符数。 当其值超过此宽度时, bqueues 将截断结束字符。
  • 指定连字符 (-) 以在 bqueues 显示特定字段的输出时设置正确的对齐方式。 如果未指定,那么缺省值是在 bqueues 显示字段的输出时设置左对齐。
  • 使用 delimiter= 来设置要在不同标题和字段之间显示的定界字符。 此定界符必须是单个字符。 缺省情况下,定界符是空格。

bqueues -o 选项覆盖 LSB_BQUEUES_FORMAT 环境变量,这将覆盖 lsf.conf中的 LSB_BQUEUES_FORMAT 设置。

输出定制仅适用于某些 bqueues 选项的输出:
  • LSB_BQUEUES_FORMATbqueues -o 都适用于没有选项的 bqueues 命令的输出,以及具有过滤信息的输出的 bqueues 选项,包括以下选项: -alloc-m-u
  • LSB_BQUEUES_FORMATbqueues -o 不适用于使用已修改格式的 bqueues 选项的输出,包括以下选项: -l-r-w

下表概述了要显示的 bqueues 字段及其支持的宽度,别名 (而不是字段名称) 以及所显示字段的计量单位:

表 1. Bqueue 的输出字段
字段名称 宽度 别名 单位
queue_Name 15 日 qname  
描述 50 描述  
优先级 10 prio  
状态 12 个月 stat  
最大值 10    
吉勒乌 10 杰卢  
Jl_p 10 杰尔普  
Jl_h 10 杰尔赫  
Njobs 10    
暂挂 10    
运行 10    
SUSP 10    
Rsv 10    
乌苏普 10    
苏普 10    
良好 6    
最大前肢 8 前肢  
max_cpulimit 30 CPULIMIT  
default_cpulimit 30 Def_cpulimit  
max_datalimit 8 达塔利米特  
default_datalimit 8 def_datalimit  
最大文件限制 8 文件限制  
最大内存限制 8 内存限制  
default_memlimit 8 def_memlimit  
最大进程数限制 8 processlimit  
default_processlimit 8 def_processlimit  
最大运行限制 12 个月 运行限制  
default_runlimit 12 个月 def_runlimit  
最大堆栈限制 8 堆栈限制  
max_swaplimit 8 Swaplimit  
max_tasklimit 6 任务限制  
最小任务限制 6    
default_tasklimit 6 def_tasklimit  
max_threadlimit 6 线程限制  
default_threadlimit 6 def_threadlimit  
重新请求 20    
主机 50    
全部 (从 FP14 开始可用) 指定应用于所有字段的输出宽度    
注: 支持以下资源限制字段名称,但显示与其对应的最大资源限制字段相同的内容 (即,以下资源限制字段名称是别名): corelimitcpulimitdatalimitfilelimitmemlimitprocesslimitrunlimitstacklimitswaplimittasklimitthreadlimit

例如,corelimitmax_corelimit 是相同的。

字段名称和别名不区分大小写。 输出宽度的有效值是从 1 到 4096 的任何正整数。

从队列信息输出中除去列标题

使用 bqueues -noheader 选项从 bqueues 输出中除去列标题。 当指定了 bqueues -noheader 时, bqueues 将显示字段的值,而不显示字段的名称。 当不需要列标题时,此选项对于脚本解析很有用。

此选项适用于没有选项的 bqueues 命令的输出,以及具有使用列标题的输出的所有 bqueues 选项的输出,包括: -alloc-m-o-u-w

此选项不适用于不使用列标题的 bqueues 选项的输出,包括以下内容: -json-l-r

以 JSON 格式查看定制队列信息

使用 bqueues -json 选项以 JSON 格式查看定制的 bqueues 输出。 由于 JSON 是定制输出格式,因此必须将 bqueues -json 选项与 -o 选项一起使用。