By default, the bjobs command displays a predefined set of job information. While you may use various bjobs options to display specific job information based on your needs, you may also customize the specific fields that bjobs displays. This allows you to create a specific bjobs output format that shows all the required information, which allows you to easily parse the information using custom scripts or to display the information in a predefined format.
Use the LSB_BJOBS_FORMAT parameter in lsf.conf or the LSB_BJOBS_FORMAT runtime environment variable to define the default bjobs output format for LSF:
LSB_BJOBS_FORMAT="field_name[:[-][output_width]] ... [delimiter='character']"
Use the bjobs -o option to define the custom output at the command level:
bjobs ... -o "field_name[:[-][output_width]] ... [delimiter='character']"
The following alternate method of using bjobs -o is recommended for special delimiter characters in a csh environment (for example, $):
bjobs ... -o 'field_name[:[-][output_width]] ... [delimiter="character"]'
- 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.
The bjobs -o option overrides the LSB_BJOBS_FORMAT environment variable, which overrides the LSB_BJOBS_FORMAT setting in lsf.conf.
- 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 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.
Remove column headings from the output
Use the bjobs -noheader option to remove column headings from the bjobs output. When bjobs -noheader is specified, bjobs displays the values of the fields without displaying the names of the fields. This is useful for script parsing, when column headings are not necessary.
This option applies to output for the bjobs command with no options, and to output for all bjobs options with short form output except for -aff, -l, -UF, -N, -h, and -V.