LSB_BQUEUES_FORMAT

Syntax

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

Description

Sets the customized output format for the bqueues command.

  • Specify which bqueues fields (or aliases instead of the full field names), in which order, and with what width to display.
  • Specify only the bqueues field name or alias to set its output to unlimited width and left justification.
  • (Available starting in Fix Pack 14) Specify all to display all fields. Specify the colon (:) with an output width that applies to all fields.
  • Specify the colon (:) without a width to set the output width to the supported width for that field.
  • Specify the colon (:) with a width to set the maximum number of characters to display for the field. When its value exceeds this width, bqueues truncates the ending characters.
  • Specify a hyphen (-) to set right justification when bqueues displays the output for the specific field. If not specified, the default is to set left justification when bqueues displays output for a field.
  • Use delimiter= to set the delimiting character to display between different headers and fields. This delimiter must be a single character. By default, the delimiter is a space.
Output customization applies only to the output for certain bqueues options:
  • LSB_BQUEUES_FORMAT and bqueues -o both apply to output for the bqueues command with no options, and for bqueues options with output that filter information, including the following options: -alloc, -m, -u.
  • LSB_BQUEUES_FORMAT and bqueues -o do not apply to output for bqueues options that use a modified format, including the following options: -l, -r, -w.

The bqueues -o option overrides the LSB_BQUEUES_FORMAT environment variable, which overrides the LSB_BQUEUES_FORMAT setting in lsf.conf.

Valid values

This table outlines the bqueues fields to display, and their supported width, aliases you can use instead of field names, and units of measurement for the displayed field:

Table 1. Output fields for bqueues
Field name Width Aliases Unit
queue_name 15 qname  
description 50 desc  
priority 10 prio  
status 12 stat  
max 10    
jl_u 10 jlu  
jl_p 10 jlp  
jl_h 10 jlh  
njobs 10    
pend 10    
run 10    
susp 10    
rsv 10    
ususp 10    
ssusp 10    
nice 6    
max_corelimit 8 corelimit  
max_cpulimit 30 cpulimit  
default_cpulimit 30 def_cpulimit  
max_datalimit 8 datalimit  
default_datalimit 8 def_datalimit  
max_filelimit 8 filelimit  
max_memlimit 8 memlimit  
default_memlimit 8 def_memlimit  
max_processlimit 8 processlimit  
default_processlimit 8 def_processlimit  
max_runlimit 12 runlimit  
default_runlimit 12 def_runlimit  
max_stacklimit 8 stacklimit  
max_swaplimit 8 swaplimit  
max_tasklimit 6 tasklimit  
min_tasklimit 6    
default_tasklimit 6 def_tasklimit  
max_threadlimit 6 threadlimit  
default_threadlimit 6 def_threadlimit  
res_req 20    
hosts 50    
all (Available starting in Fix Pack 14) Specify an output width that applies to all fields    
Note: The following resource limit field names are supported, but show the same content as their corresponding maximum resource limit fields (that is, the following resource limit field names are aliases): corelimit, cpulimit, datalimit, filelimit, memlimit, processlimit, runlimit, stacklimit, swaplimit, tasklimit, threadlimit.

For example, corelimit is the same as max_corelimit.

Field names and aliases are not case-sensitive. Valid values for the output width are any positive integer from 1 to 4096.

Example

LSB_BQUEUES_FORMAT="queue_name description:10 priority:- status: max:-6 delimiter='^'"

Running bqueues displays the following fields:

  • QUEUE_NAME with unlimited width and left-aligned.
  • DESCRIPTION with a maximum width of 10 characters and left-aligned.
  • PRIORITY with a maximum width of 10 characters (which is the maximum supported width) and right-aligned.
  • STATUS with a maximum width of 12 characters (which is the maximum supported width) and left-aligned.
  • MAX with a maximum width of 6 characters and right-aligned.
  • The ^ character is displayed between different headers and fields.

Default

Not defined. The current bqueues output is used.