table of contents
other versions
- jessie-backports 8.1.9+dfsg-1~bpo8+1
- stretch 8.1.9+dfsg-4+deb9u2
- testing 8.1.9+dfsg-9
- unstable 8.1.9+dfsg-9
QHOST(1) | Grid Engine User Commands | QHOST(1) |
NAME¶
qhost - show the status of Grid Engine hosts, queues, jobsSYNTAX¶
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 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 listed in Also consumable utilization 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 compatible output with other 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 displayed hosts.
- -u user,...
- Display information only on those jobs and queues being associated with the users from the given user list.
- -xml
- This option can be used with all other options and changes the output to
XML. The used schemas are referenced in the XML output. The output is
printed to stdout.
If the -xml parameter is combined with -ncb then the XML
output will contain 6.2u5 compatible output.
OUTPUT FORMATS¶
Depending on the presence or absence of the -q or -F and -j option three output formats need to be differentiated.Default Format (without -q, -F and -j)¶
For each host one line is printed. The output consists of consisting of- •
- the Hostname
- •
- the Architecture.
- •
- the Number of processors.
- •
- the Load.
- •
- the Total Memory.
- •
- the Used Memory.
- •
- the Total Swapspace.
- •
- the Used Swapspace.
- •
- the queue name,
- •
- the queue type - one of B(atch), I(nteractive), or a combination thereof,
- •
- the number of reserved (by advance reservation, not resource reservation), used and, available (according to the queue's slots parameter) job slots,
- •
- the state of the queue - one of u(nknown), a(larm), A(larm), C(alendar suspended), s(uspended), S(ubordinate), d(isabled), D(isabled), E(rror), (c)configuration ambiguous, (o)rphaned, (P)reempted, or some combinations thereof. See section "Full Format" in for explanation of the status flags.
- •
- a one letter specifier indicating whether the current resource
availability value was dominated by either
- •
- a second one letter specifier indicating the source for the current
resource availability value, being one of
- •
- after a colon the name of the resource on which information is displayed.
- •
- after an equal sign the current resource availability value.
- •
- the job ID,
- •
- the job name,
- •
- the job owner name,
- •
- 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),
- •
- the start date and time and the function of the job (MASTER or SLAVE - only meaningful in case of a parallel job) and
- •
- the priority of the jobs.
ENVIRONMENT VARIABLES¶
- SGE_ROOT
- Specifies the location of the Grid Engine standard configuration files.
- SGE_CELL
- If set, specifies the default Grid Engine cell. To address a Grid Engine cell qhost uses (in the order of precedence):
The name of the cell specified in the environment
variable SGE_CELL, if it is set.
The name of the default cell, i.e. default.
- SGE_DEBUG_LEVEL
- If set, specifies that debug information should be written 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 is expected to listen for communication requests. Most installations will use a services map entry for the service "sge_qmaster" instead to define that port.
FILES¶
<sge_root>/<cell>/common/act_qmaster Grid Engine master host file
SEE ALSO¶
COPYRIGHT¶
See for a full statement of rights and permissions.2011-12-04 | SGE 8.1.3pre |