bhosts - get information about server hosts in the lsbatch system
bhosts [ -h ] [ -V ] [ -w | -l ] [ host_name ... ]
Display the information about lsbatch server hosts. The default is to return information of all the server hosts in the lsbatch system. A listing of the hosts is displayed with the following fields:
HOSTNAME
The name of the host.
STATUS
The current status of the host. Only when a host is in ok status, can
batch jobs be dispatched to it. The possible values for host status
are as follows:
unavail
The host is down, or the Load Information Manager (LIM) and the
slave batch daemon (sbatchd) on the host are unreachable.
unreach
The LIM on the host is running but the slave batch daemon
(sbatchd) is unreachable.
closed
The host is not allowed to accept any remote batch job. There
are several reasons causing the host to be closed. The long format
shown by the -l option gives the possible reasons :
closed_Adm
The host is closed by the LSF administrator or root (see
badmin(8)
). No job can be dispatched to it but jobs that
are executing on it will not be affected.
closed_Lock
The host is locked by the LSF administrator or root (see
lsadmin(8)
). All batch jobs on the host are suspended by
the lsbatch system.
closed_Wind
The host is closed by its dispatch windows, which are
defined in the configuration file lsb.hosts (see
lsbatch(5)
). All batch jobs on the host are suspended by
the lsbatch system.
closed_Full
The configured maximum number of batch jobs on the host has
been reached (see MAX field below).
closed_Busy
The host is overloaded because some load indices go beyond
the configured thresholds (see lsbatch(5)
). The displayed
thresholds that cause the host to be busy are preceded by a
`*'.
closed_LIM
The LIM on the host is unreachable, but the sbatchd is ok.
JL/U
The maximum number of jobs per user that can be processed concurrently
on this host. For non-preemptive scheduling, the concurrently processed
jobs include both running and suspended jobs. For preemptive
scheduling, the concurrently processed jobs include only running jobs
(see the descrition of PREEMPTIVE in lsbatch(5)
). If the character
`-' is displayed, there is no limit.
MAX The maximum number of jobs that the host is allowed to process concurrently. For non-preemptive scheduling, the concurrently processed jobs include both running and suspended jobs. For preemptive scheduling, the concurrently processed jobs include only running jobs (see the descrition of PREEMPTIVE in lsbatch(5) ). If the character `-' is displayed, there is no limit.
NJOBS
The number of jobs currently running or suspended on the host.
RUN The number of jobs running on the host.
SSUSP
The number of jobs suspended by the slave daemon on the host.
USUSP
The number of jobs suspended by the job submitter or the LSF administrator.
DISPATCH_WINDOWS
One or more dispatch windows in a week during which batch jobs may be
dispatched to this host to run. Jobs already started on this host are
not affected by the dispatch windows. The default is no restriction,
or always open (that is, 24 hours a day, seven days a week). For
dispatch window specification, see the description for the
DISPATCH_WINDOWS keyword under the -l option in bqueues(1)
.
-h Print command usage to stderr and exit.
-V Print LSF release version to stderr and exit.
-w Display host information in a wide format. Fields are displayed without truncation.
-l Display host information in a (long) multi-line format. In addition to the display fields previously listed, the CPU normalization factor, CPUF, of the host is displayed (see lshosts(1) ). Also displayed are the host load threshold vectors, loadSched and loadStop, with the same format as those for batch job queues (see bqueues(1) and lsbatch(5) ). These thresholds are used to controll job dispatch, suspension and resumption. For the use of the loadSched and loadStop values and an explanation of the load indices, see the description for the «QUEUE SCHEDULING PARAMETERS» keyword under the -l option in bqueues(1) . If the MIG keyword is defined in lsb.hosts, the migration threshold is also displayed (see lsbatch(5) ). Additionally, the type of checkpoint support is also shown if the host supports checkpointing (see lsbatch(5) ).
host_name ...
Display information about the host or hosts that are specified by
host_name ... . host_name ... can be either one or more host or host
group names. If no host_name is specified, then the default is to
display information about all the hosts used by the lsbatch system.
lsbatch(1) , lsbatch(5) , bqueues(1) , lshosts(1) , badmin(8) , lsadmin(8)