bjobs

---

Overview

bjobs is a job status query tool for FSCHED, compatible with LSF bjobs syntax. It lets users filter jobs and customize output format.

---

Parameters

Supported Options

Option	Description	Key Differences
-A	Show job array summary information	No difference
-a	Show jobs in all states (including recently completed jobs)	Default cleanup time for completed jobs differs: LSF 1 hour, FSCHED 900 seconds
-d	Show recently completed jobs	Default cleanup time for completed jobs differs: LSF 1 hour, FSCHED 900 seconds
-G	Show jobs for the specified user group	No difference
-J	Show jobs or job arrays with the specified name	No difference
-Jd	Show jobs with the specified description	No difference
-l	Long format with detailed job information (multi-line output)	Details listed in later sections
-m	Show jobs dispatched to the specified host	No difference
-noheader	Remove column headers from output	No difference
-o	Set a custom output format	Details listed in later sections
-P	Show jobs for the specified project	No difference, project maps to wckey
-p	Show pending jobs and reasons they are not dispatched	No difference
-q	Show jobs in the specified queue	No difference
-r	Show running jobs	No difference
-s	Show suspended jobs and suspension reasons	Can filter suspended jobs; suspension reason may show None
-UF	Show unformatted detailed job information	No difference
-u	Show jobs submitted by a specified user or all users	Supports specific users and all, not user groups
-w	Wide format (do not truncate fields)	No difference
-json	Show output in JSON format	No difference
job_id	Specify a job or job array to display	Default cleanup time for completed jobs differs: LSF 1 hour, FSCHED 900 seconds
-h	Show help information	Provides more detailed help information
-V	Print LSF version	No difference

Default Output Fields

Field	Description	Key Differences
JOBID	Job ID	No difference
USER	User who submitted the job	No difference
STAT	Job status	USUSP and SSUSP distinction may differ; no UNKWN, WAIT, ZOMBI states
QUEUE	Queue name	No difference
FROM_HOST	Submit host	No difference
EXEC_HOST	Execution host	No difference
JOB_NAME	Job name	No difference
SUBMIT_TIME	Submit time	No difference

Output Fields for -l

Field	Description	Key Differences
Job	Job ID assigned by LSF	No difference
User	User who submitted the job	No difference
Project	Project for the job	No difference, project maps to wckey
Command	Command executed by the job	No difference
CWD	Working directory on the submission host	No difference
Execution CWD	Actual working directory during job execution	No difference
Migration threshold	Migration threshold specified via bsub -mig	No difference
PENDING REASONS	Reasons the job is in PEND or PSUSP state	Shows simplified reasons
SUSPENDING REASONS	Reasons the job is in USUSP or SSUSP state	Shows simplified reasons
loadSched	Job load scheduling threshold	No difference
loadStop	Job load suspension threshold	No difference
JOB STATUS	Job status	USUSP and SSUSP distinction may differ; no UNKWN, WAIT, ZOMBI states
RESOURCE USAGE	Resource usage	CPU time, MEM, NTHREAD, PGID, PIDS implemented; SWAP not implemented
Requested resources	Resource requirement string specified in bsub	rusage[mem=xxx] implemented; others not implemented
JOB_DESCRIPTION	User-provided job description	No difference
MEMORY USAGE	Memory usage details	MAX MEM and AVG MEM implemented. MAX MEM is the max across nodes, AVG MEM averages node memory and task counts
RESOURCE REQUIREMENT DETAILS	Resource request details	rusage[mem=xxx] implemented; shows dummy select[type == local] order[r15s:pg]; others not implemented
SCHEDULING PARAMETERS	Load threshold information	Shows only queue thresholds, not host thresholds. Implements r15s, r1m, r15m, ut, mem; not implemented: pg, io, ls, it, tmp, swp

Output Fields for -A

Field	Description	Key Differences
JOBID	Job ID for the job array	No difference
ARRAY_SPEC	Job array description in name[index] format	No difference
OWNER	Job array owner	No difference
NJOBS	Total number of jobs in the array	No difference
PEND	Number of jobs in PEND state in the array	No difference
RUN	Number of jobs in RUN state in the array	No difference
DONE	Number of jobs successfully completed in the array	No difference
EXIT	Number of jobs that exited abnormally in the array	No difference
SSUSP	Number of system-suspended jobs in the array	Dummy value is 0
USUSP	Number of user-suspended jobs in the array	Counts all suspended jobs
PSUSP	Number of paused jobs in the array	Dummy value is 0

---

Custom Format (-o option)

With -o, you can customize fields, alignment, width, and delimiter. Syntax example:

Syntax:

[field_name[:[-]width][:unit_prefix]] [delimiter="delimiter"]

Examples:

1. Basic format:

   bjobs -o "jobid job_name stat"
2. Width and alignment:

   # Right alignment (default), left alignment (with `-`), and fixed width
   bjobs -o "jobid:10 stat:-5 user:8"
3. Custom delimiter:

   bjobs -o "jobid description delimiter=, submit_time"

Supported Fields and Aliases:

Field	Alias	Description
jobid	id	Unique job identifier.
job_description	description	Job description text (optional).
stat		Current state (such as RUN, PEND, EXIT).
user		Submitting user name.
exec_host		Allocated compute node list (suspended jobs show -).
job_name		Job name.
queue		Queue name.
from_host		Submission workstation host name.
command		Launched command (optional).
submit_time		Submit time (format: YYYY-MM-DD HH:MM).
start_time		Job start time (format: YYYY-MM-DD HH:MM).
finish_time		Job finish time (format: YYYY-MM-DD HH:MM).
run_time		Elapsed run time (seconds; completed jobs show 0).
nalloc_slot		Allocated CPU cores.
cpu_exec_host		Host and allocated core format (such as 2*hostA,1*hostB).
account		Job account information.
requeue		Whether the job can be requeued.
tmp_disk		Temporary disk space requirement (MB).
min_nodes		Minimum node count.
max_nodes		Maximum node count.
ntasks_per_node		Tasks per node.

Notes:

• Field name sensitivity: Field names are case-insensitive but must match the list.
• Wildcard handling: Only -J and -Jd support the * wildcard (automatically converted to regex).
• Unit prefix: Automatic unit conversion (such as KB/MB) is not implemented; values are shown as-is.

---

Unsupported LSF Features

The following parameters are not available in the FSCHED version:

Parameter	Reason
-N	Normalized CPU time cannot be calculated.
-W, -WF, -WL, -WP	Resource usage and progress estimation are not supported.

---

Examples

1. Show all jobs (including completed)

   bjobs -a

2. Filter jobs by user group

   bjobs -G developers

3. Custom output format (pipe delimiter)

   # Show ID, name, status, and submit time, separated by `|`:
   $ bjobs -o "jobid job_name stat submit_time delimiter='|'"

4. Filter by user and suppress headers

   bjobs -u alice -noheader

5. Show suspended jobs and reasons (wide format)

   bjobs -p -w

---

Notes

1. Parameter conflict rules: Format options -l, -o, -UF, and -w are mutually exclusive and cannot be used together. User filters -G and -u cannot be combined.

2. User and group validation: The specified user or group name must exist (except for -u all). Invalid names will result in an error.

3. Wildcard rules: In -J or -Jd, entering *test matches any job name/description containing test.

4. Alternatives for unimplemented features: For resource statistics, use FSCHED built-in commands (such as squeue --Format=...).