SYNTAX
qhost [ -F [resource_name,...] ] [ -help ] [ -h host_list ] [ -j ] [
-l resource=val,... ] [ -ncb ] [ -u user,... ] [ -xml ].
DESCRIPTION
qhost shows the current status of the available Univa Grid Engine
hosts, queues and the jobs associated with the queues. Selection
options allow you to get information about specific hosts, queues, jobs
or users. If multiple selections are done a host is only displayed if
all selection criteria for a host are met. Without any options qhost
will display a list of all hosts without queue or job information.
OPTIONS
-F [ resource_name,... ]
qhost will present a detailed listing of the current resource
availability per host with respect to all resources (if the
option argument is omitted) or with respect to those resources
contained in the resource_name list. Please refer to the
description of the Full Format in section OUTPUT FORMATS below
for further detail.
-help Prints a listing of all options.
-h host_list
Prints a list of all hosts contained in host_list.
-j Prints all jobs running on the queues hosted by the shown hosts.
This switch calls -q implicitly.
-l resource[=value],...
Defines the resources to be granted by the hosts which should be
included in the host list output. Matching is performed on hosts
based on non-mutable resource availability information only.
That means load values are always ignored except the so-called
static load values (i.e. "arch", "num_proc", "mem_total",
"swap_total" and "virtual_total") ones. Also consumable utiliza-
tion is ignored. If there are multiple -l resource requests
they will be concatenated by a logical AND: a host needs to
match all resources to be displayed.
-ncb This command line switch can be used in order to get 6.2u5 com-
patible output with other qhost(1) command line switches. In
that case the output of the corresponding command will suppress
information concerning the execution host topology. Note that
this option will be removed in the next major version.
-q Show information about the queues instances hosted by the dis-
played hosts.
-u user,...
Display information only on those jobs and queues being associ-
For each host one line is printed. The output consists of consisting of
o the Hostname
o the Architecture.
o the Number of processors.
o the Load.
o the Total Memory.
o the Used Memory.
o the Total Swapspace.
o the Used Swapspace.
If the -q option is supplied, each host status line also contains extra
lines for every queue hosted by the host consisting of,
o the queue name.
o the queue type - one of B(atch), I(nteractive), C(heckpointing),
P(arallel) or combinations thereof,
o the number of reserved, used and available job slots,
o the state of the queue - one of u(nknown) if the corresponding
sge_execd(8) cannot be contacted, a(larm), A(larm), C(alendar sus-
pended), s(uspended), S(ubordinate), d(isabled), D(isabled), E(rror)
or combinations thereof.
If the state is a(alarm) at least one of the load thresholds defined in
the load_thresholds list of the queue configuration (see queue_conf(5))
is currently exceeded, which prevents from scheduling further jobs to
that queue.
As opposed to this, the state A(larm) indicates that at least one of
the suspend thresholds of the queue (see queue_conf(5)) is currently
exceeded. This will result in jobs running in that queue being succes-
sively suspended until no threshold is violated.
The states s(uspended) and d(isabled) can be assigned to queues and
released via the qmod(1) command. Suspending a queue will cause all
jobs executing in that queue to be suspended.
The states D(isabled) and C(alendar suspended) indicate that the queue
has been disabled or suspended automatically via the calendar facility
of Univa Grid Engine (see calendar_conf(5)), while the S(ubordinate)
state indicates, that the queue has been suspend via subordination to
another queue (see queue_conf(5) for details). When suspending a queue
o a one letter specifier indicating whether the current resource
availability value was dominated by either
`g' - a cluster global,
`h' - a host total or
o a second one letter specifier indicating the source for the current
resource availability value, being one of
`l' - a load value reported for the resource,
`L' - a load value for the resource after administrator defined load
scaling has been applied,
`c' - availability derived from the consumable resources facility
(see complexes(5)),
`f' - a fixed availability definition derived from a non-consumable
complex attribute or a fixed resource limit.
o after a colon the name of the resource on which information is dis-
played.
o after an equal sign the current resource availability value.
The displayed availability values and the sources from which they
derive are always the minimum values of all possible combinations.
Hence, for example, a line of the form "qf:h_vmem=4G" indicates that a
queue currently has a maximum availability in virtual memory of 4 Giga-
byte, where this value is a fixed value (e.g. a resource limit in the
queue configuration) and it is queue dominated, i.e. the host in total
may have more virtual memory available than this, but the queue doesn't
allow for more. Contrarily a line "hl:h_vmem=4G" would also indicate an
upper bound of 4 Gigabyte virtual memory availability, but the limit
would be derived from a load value currently reported for the host. So
while the queue might allow for jobs with higher virtual memory
requirements, the host on which this particular queue resides currently
only has 4 Gigabyte available.
After the queue status line (in case of -j) a single line is printed
for each job running currently in this queue. Each job status line con-
tains
o the job ID,
o the job name,
o the job owner name,
o the status of the job - one of t(ransfering), r(unning),
R(estarted), s(uspended), S(uspended) or T(hreshold) (see the
Reduced Format section for detailed information),
o the start date and time and the function of the job (MASTER or SLAVE
- only meaningful in case of a parallel job) and
o the priority of the jobs.
SGE_DEBUG_LEVEL
If set, specifies that debug information should be writ-
ten to stderr. In addition the level of detail in which
debug information is generated is defined.
SGE_QMASTER_PORT
If set, specifies the tcp port on which sge_qmaster(8)
is expected to listen for communication requests. Most
installations will use a services map entry for the ser-
vice "sge_qmaster" instead to define that port.
FILES
<sge_root>/<cell>/common/act_qmaster
Univa Grid Engine master host file
SEE ALSO
sge_intro(1), qalter(1), qconf(1), qhold(1), qmod(1), qstat(1),
qsub(1), queue_conf(5), sge_execd(8), sge_qmaster(8), sge_shepherd(8).
COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions.
UGE 8.0.0 $Date: 2009/11/05 13:18:36 $ QHOST(1)
Man(1) output converted with
man2html