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:
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.
Field names and aliases are not case-sensitive.
Valid values for the output width are any positive integer from 1 to 4096.For example, corelimit is the same as max_corelimit.
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.