LSB_BJOBS_FORMAT
Syntax
LSB_BJOBS_FORMAT="field_name[:[-][output_width]] ... [delimiter='character']"
Description
Sets the customized output format for the bjobs command.
- Specify which bjobs fields (or aliases instead of the full field names), in which order, and with what width to display.
- Specify only the bjobs field name or alias to set its output to unlimited width and left justification.
- Specify the colon (:) without a width to set the output width to the recommended 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, bjobs truncates the output
as follows:
- For the JOB_NAME field, bjobs removes the header characters and replaces them with an asterisk (*)
- For other fields, bjobs truncates the ending characters
- Specify a hyphen (-) to set right justification when displaying the output for the specific field. If not specified, the default is to set left justification when displaying output for a field.
- Use delimiter= to set the delimiting character to display between different headers and fields. This must be a single character. By default, the delimiter is a space.
Output customization
only applies to the output for certain bjobs options,
as follows:
- LSB_BJOBS_FORMAT and bjobs -o both apply to output for the bjobs command with no options, and for bjobs options with short form output that filter information, including the following: -a, -app, -cname, -d, -g, -G, -J, -Jd, -Lp, -m, -P, -q, -r, -sla, -u, -x, -X.
- LSB_BJOBS_FORMAT does not apply to output for bjobs options that use a modified format and filter information, but you can use bjobs -o to customize the output for these options. These options include the following: -fwd, -N, -p, -s.
- LSB_BJOBS_FORMAT and bjobs -o do not apply to output for bjobs options that use a modified format, including the following: -A, -aff, -aps, -l, -UF, -ss, -sum, -UF, -w, -W, -WF, -WL, -WP.
The bjobs -o option overrides the LSB_BJOBS_FORMAT environment variable, which overrides the LSB_BJOBS_FORMAT setting in lsf.conf.
Valid values
The following are the field names used to specify the bjobs fields to display, recommended width, aliases you can use instead of field names, and units of measurement for the displayed field:
| Field name | Width | Aliases | Unit | Category |
|---|---|---|---|---|
| jobid | 7 | id | Common | |
| stat | 5 | |||
| user | 7 | |||
 user_group  |
15 |
ugroup |
|
|
| queue | 10 | |||
| job_name | 10 | name | ||
| job_description | 17 | description | ||
| proj_name | 11 | proj, project | ||
| application | 13 | app | ||
| service_class | 13 | sla | ||
| job_group | 10 | group | ||
| job_priority | 12 | priority | ||
| dependency | 15 | |||
| command | 15 | cmd | Command | |
| pre_exec_command | 16 | pre_cmd | ||
| post_exec_command | 17 | post_cmd | ||
| resize_notification_command | 27 | resize_cmd | ||
| pids | 20 | |||
| exit_code | 10 | |||
| exit_reason | 50 | |||
| from_host | 11 | Host | ||
| first_host | 11 | |||
| exec_host | 11 | |||
| nexec_host Note: If the allocated host group
or compute unit is condensed, this field does not display the real
number of hosts. Use bjobs -X -o to view the real
number of hosts in these situations.
|
10 | |||
| alloc_slot |
20 | |||
| nalloc_slot |
10 | |||
| host_file |
10 | |||
| submit_time | 15 | Time | ||
| start_time | 15 | |||
| estimated_start_time | 20 | estart_time | ||
| specified_start_time | 20 | sstart_time | ||
| specified_terminate_time | 24 | sterminate_time | ||
| time_left | 11 | seconds | ||
| finish_time | 16 | |||
| %complete | 11 | |||
| warning_action | 15 | warn_act | ||
| action_warning_time | 19 | warn_time | ||
| cpu_used | 10 | CPU | ||
| run_time | 15 | seconds | ||
| idle_factor | 11 | |||
| exception_status | 16 | except_stat | ||
| slots | 5 | |||
| mem | 10 | LSF_UNIT_FOR_LIMITS in lsf.conf (KB by default) | ||
| max_mem | 10 | LSF_UNIT_FOR_LIMITS in lsf.conf (KB by default) | ||
| avg_mem | 10 | LSF_UNIT_FOR_LIMITS in lsf.conf (KB by default) | ||
| memlimit | 10 | LSF_UNIT_FOR_LIMITS in lsf.conf (KB by default) | ||
| swap | 10 | LSF_UNIT_FOR_LIMITS in lsf.conf (KB by default) | ||
| swaplimit | 10 | LSF_UNIT_FOR_LIMITS in lsf.conf (KB by default) | ||
| min_req_proc | 12 | Resource requirement | ||
| max_req_proc | 12 | |||
| effective_resreq | 17 | eresreq | ||
| network_req | 15 | |||
| filelimit | 10 | Resource limits | ||
| corelimit | 10 | |||
| stacklimit | 10 | |||
| processlimit | 12 | |||
| input_file | 10 | File | ||
| output_file | 11 | |||
| error_file | 10 | |||
| output_dir | 15 | Directory | ||
| sub_cwd | 10 | |||
| exec_home | 10 | |||
| exec_cwd | 10 | |||
| forward_cluster | 15 | fwd_cluster | MultiCluster | |
| forward_time | 15 | fwd_time |
Field names and aliases are not case sensitive. Valid values for the output width are any positive integer between 1 and 4096. If the jobid field is defined with no output width and LSB_JOBID_DISP_LENGTH is defined in lsf.conf, the LSB_JOBID_DISP_LENGTH value is used for the output width. If jobid is defined with a specified output width, the specified output width overrides the LSB_JOBID_DISP_LENGTH value.
Example
LSB_BJOBS_FORMAT="jobid stat: queue:- project:10 application:-6 delimiter='^'"Running bjobs displays the following fields:
- JOBID with unlimited width and left justified. If LSB_JOBID_DISP_LENGTH is specified, that value is used for the output width instead.
- STAT with a maximum width of five characters (which is the recommended width) and left justified.
- QUEUE with a maximum width of ten characters (which is the recommended width) and right justified.
- PROJECT with a maximum width of ten characters and left justified.
- APPLICATION with a maximum width of six characters and right justified.
- The ^ character is displayed between different headers and fields.
Default
Not defined. The current bjobs output is used.