bhosts

Overview

bhosts is the FSCHED replacement for LSF bhosts, showing cluster node status. It supports multiple output formats and host filtering.

Parameters

Supported Options

Option	Description	Key Differences
`-a`	Show all hosts, including resource providers (such as EGO or OpenStack).	Resource providers (such as EGO or OpenStack) are not supported.
`-aff`	Show host topology information for CPU and memory affinity scheduling.	Detailed topology after enabling affinity is not implemented.
`-alloc`	Show slot counts; exclusive and non-exclusive jobs display different slot counts.	For exclusive jobs, `-alloc` or not both show all CPUs on the node.
`-e`	Show resources exported to other clusters.	Multi-cluster is not implemented, so it always shows no exports.
`-l`	Show host information in long format (multi-line output).	Details listed in later sections.
`-w`	Show host information in wide format (no truncation).	`STATUS` implements `closed_Busy`, `closed_Full`, and `closed_Excl`. Other states (such as `closed_Adm`, `closed_Cu_Excl`) are not implemented.
`-noheader`	Remove column headers from output.	No difference.
`-R`	Show only hosts that satisfy a resource requirement expression.	Selection via `mem`, `slots`, `status` is implemented. Other `select` options are not.
`-V`	Print version.	No difference.
`-x`	Show hosts with high job exit rate.	Exit-rate settings and statistics are not implemented, so it always shows none.
`-X`	Show uncompressed host group and compute unit output.	Host groups and compute units are not implemented, so output is uncompressed with or without `-X`.
`-h`	Show command usage.	Provides more detailed help information.

Default Output Fields

The following fields are for nodes only, without considering host groups or compute units.

Field	Description	Key Differences
`HOST_NAME`	Host name.	Host groups and `lost_and_found` nodes are not shown.
`STATUS`	Host status and `sbatchd` daemon status.	Supports `ok`, `unavail`, `unreach`, and `closed`. `closed_Cu_excl` is not implemented. `sbatchd` daemon status is not supported.
`JL/U`	Maximum number of slots per user on the host. `-` means unlimited.	Always shown as `-`.
`MAX`	Maximum available job slots on the host. `-` means unlimited.	The `MAX` field is implemented.
`NJOBS`	Number of tasks for all scheduled jobs on the host.	No difference.
`RUN`	Number of tasks for all running jobs on the host.	No difference.
`SSUSP`	Number of tasks for all system-suspended jobs on the host.	Always 0.
`USUSP`	Number of tasks for all user-suspended jobs on the host.	Suspended job count is implemented, but system vs user suspend is not distinguished.
`RSV`	Task count for pending jobs with reserved slots on the host.	LSF requires `SLOT_RESERVE` in `lsb.queues`. The current implementation uses reservations created by `scontrol create reservation`, which is different.

Output Fields for `-l`

Field	Description	Key Differences
`STATUS`	Shows reasons for host closure, including `closed_Adm`, `closed_Busy`, `closed_Full`, `closed_Excl`, etc.	Implements `closed_Busy`, `closed_Full`, and `closed_Excl`. Other states (such as `closed_Adm`, `closed_Cu_Excl`) are not implemented.
`CURRENT LOAD`	Shows total and reserved host load.	Output is based on total node resources and does not aggregate allocated and reserved resources across all jobs.
`LOAD THRESHOLD`	Shows scheduling thresholds (`loadSched`) and suspend thresholds (`loadStop`) at node level.	Node-level load thresholds are not implemented, so this shows `-`.
`CONFIGURED AFFINITY CPU LIST`	Shows configured CPU affinity information for the host.	Only outputs `AFFINITY: Disabled`, no detailed CPU list.

`host_name` Filters

Filter	Description	Key Differences
None (default)	Show all hosts	No difference
host_name ...	Show information for selected hosts	No difference
cluster_name	Show nodes for the selected cluster.	Multi-cluster is not supported; only the current cluster is shown.

Examples

Example 1: Default Output

$ bhosts
HOST_NAME            STATUS     JL/U MAX NJOBS RUN SSUSP USUSP RSV
host01               ok         -    4    2    2   0     0     0
host02               closed     -    8    3    1   2     0     0

Note: The default format shows core information like host name, status (such as ok), and running job counts.

Example 2: Long Format for a Specific Host

$ bhosts -l host01
HOST  host01
STATUS            CPUF JL/U MAX NJOBS RUN SSUSP USUSP RSV DISPATCH_WINDOW
ok                1.0   -    4     2   2      0     0     -

CURRENT LOAD USED FOR SCHEDULING:
r15s r1m r15m ut% pg io ls it tmp swp mem slots
Total        ... (detailed load data)

LOAD THRESHOLD USED FOR SCHEDULING:
... (threshold information)

Note: -l provides a multi-line detailed report including CPU load and scheduling thresholds.

Example 3: Wide Format Without Headers

$ bhosts -w -noheader
host01 ok         -    4   2    2   0     0     0
host02 closed     -    8   3    1   2     0     0

Notes

1. Option Conflicts

-l, -w, and custom format (not implemented yet) cannot be used together. For example:
```
$ bhosts -l -w
Error: conflicting output formats
```

2. Feature Differences vs LSF

Unsupported LSF options: -o (custom output), -a, and -m are not implemented in the current version. Contact customer support if needed.
LSF content not available: user quotas have no one-to-one support in FSCHED and are not shown. All SUSPEND states are treated as USER SUSPEND.

3. Other Notes

Host filtering: append host names to limit output (for example bhosts host01 host02).
Field meanings: STATUS is the node state identifier. NJOBS/RUN/SSUSP/USUSP/RSV represent total jobs, running jobs, system-suspended jobs, and so on.

Overview​

Parameters​

Supported Options​

Default Output Fields​

Output Fields for -l​

host_name Filters​

Examples​

Example 1: Default Output​

Example 2: Long Format for a Specific Host​

Example 3: Wide Format Without Headers​

Notes​

1. Option Conflicts​

2. Feature Differences vs LSF​

3. Other Notes​