-o

Displays information about jobs with CPU and memory affinity resource requirements for each task in the job.

Categories

format

Synopsis

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

Description

Sets the customized output format.

  • 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.

To specify special delimiter characters in a csh environment (for example, $), use double quotation marks (") in the delimiter specification and single quotation marks (') in the -o statement:

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

The -o option only applies to output for certain bjobs options, as follows:
  • This option applies 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.
  • This option applies to output for bjobs options that use a modified format and filter information, including the following: -fwd, -N, -p, -s.
  • This option does 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.

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:

Table 1. Output fields for bjobs
Field name Width Aliases Unit Category
jobid 7 id   Common
stat 5    
user 7    
Start of change user_group End of change Start of change 15 End of change Start of change ugroup End of change Start of change   End of change
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    
Start of change alloc_slot End of change 20    
Start of change nalloc_slot End of change 10    
Start of change host_file End of change 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.

For example,

Examples

bjobs -o "jobid stat: queue:- project:10 application:-6 delimiter='^'" 123

This command (used to illustrate the different subcommands for -o) displays the following fields for a job with the job ID 123:

  • 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.
Parent topic: Options