bqueues

Overview

bqueues queries queue information in an FSCHED cluster, replacing LSF bqueues. It provides multiple formats and filters to help users quickly understand queue status, resource allocation, and scheduling policies.

---

Parameters

Available Options

Option	Description	Key Differences
-alloc	Show job slot statistics; exclusive and non-exclusive jobs show different slot counts.	No difference.
-h	Print command usage and exit.	Provides more detailed help information.
-l	Show queue information in long format, including description, features, scheduling parameters, and more.	Details listed in later sections.
-m	Show queue information for specified hosts, host groups, clusters, or all hosts.	Host group display is not supported.
-noheader	Remove column headers from output.	No difference.
-u	Show queue information for specified users, user groups, or all users.	User group display is not supported.
-V	Print LSF version information and exit.	No difference.
-w	Wide format output (no truncation).	RSV output not implemented; not all states are supported (such as Inact_Win, Inact_Adm).

Default Output Fields

Field	Description	Key Differences
QUEUE_NAME	Queue name.	No difference.
PRIO	Queue priority (higher value means higher priority).	No difference.
STATUS	Queue status, including Open, Closed, Active, Inactive.	No difference.
MAX	Maximum job slots available in the queue; - means unlimited.	No difference.
JL/U	Maximum job slots per user in the queue; - means unlimited.	No difference.
JL/P	Maximum job slots per processor in the queue; - means unlimited.	Per-processor max job slots configuration and display are not implemented.
JL/H	Maximum job slots per host in the queue; - means unlimited.	No difference.
NJOBS	Total job slots for all jobs in the queue, including pending, running, and suspended jobs.	No difference.
PEND	Total task count of pending jobs in the queue.	No difference.
RUN	Total task count of running jobs in the queue.	No difference.
SUSP	Total task count of suspended jobs in the queue.	No difference.

Output Fields for -l

Field	Description	Key Differences
Description	Typical usage description for the queue.	Description contains only the queue name, no additional details.
Default queue indication	Default queue indicator.	No difference.
PARAMETERS/STATISTICS	Nice value, status, max job count, per-user job limits, and more.	NICE not implemented; STATUS, JL/P, SSUSP, RSV for Inact_Win and Inact_Adm not implemented.
Schedule delay for a new job	Scheduling delay after a new job is submitted.	Fixed at 0 seconds; NEW_JOB_SCHED_DELAY not implemented.
Interval for a host to accept two jobs	Interval for a host to accept two jobs.	Fixed at 0 seconds; JOB_ACCEPT_INTERVAL not implemented.
SCHEDULING PARAMETERS	Scheduling parameters including r15s, r1m, r15m, ut, mem load metrics.	Implements r15s, r1m, r15m, ut, mem; does not implement pg, io, ls, it, tmp, swp.
SCHEDULING POLICIES	Scheduling policies such as FAIRSHARE.	Fixed output FAIRSHARE; policy configuration not implemented.
USER_SHARES	User share allocation.	Fixed output [default, 1]; fairshare configuration not implemented.
USERS	List of users allowed to use the queue.	No difference.
HOSTS	List of hosts where the queue can schedule jobs.	No difference.

---

Examples

1. Basic Queue List

bqueues

By default, shows basic information for all queues in short format, including name, priority, status, and job counts.

2. Wide Format

bqueues -w

Extends output width for more fields (such as resource limits and load thresholds).

3. Filter Queues by Host

bqueues -m compute-cluster01

Shows only queues that can run jobs on the cluster named compute-cluster01.

4. Show Queues Allowed for a User

bqueues -u developer_team

Lists queues that allow user developer_team to submit jobs. If you use -u all, it shows queues open to all users.

5. Long Format Details

bqueues -l

Shows detailed parameters for each queue (such as scheduling policy, load thresholds, and associated hosts).

6. Combined Options

bqueues -m all -l --noheader

Filters queues available on all nodes and shows detailed information in long format without headers.

---

Notes

1. LSF compatibility differences: The original LSF -o option (custom output format) is not supported yet. Contact customer support if needed.

2. Parameter validation: Invalid host, cluster, or user names cause an error (for example Bad host name or User cannot use the queue). Parameter values are case-sensitive and must match cluster configuration.

3. Special handling: Using -m all shows only queues whose node count equals the total cluster node count. If no queue name is specified and the filter does not match (for example the host does not exist), the command returns exit code 255 and prints the reason.