qhost: show the status of xxQS_NAMExx hosts, queues, jobs - Linux Manuals (1) (2024)

qhost: show the status of xxQS_NAMExx hosts, queues, jobs

Command to display qhost manual in Linux: $ man 1 qhost

NAME

qhost - show the status of xxQS_NAMExx hosts, queues, jobs

SYNTAX

qhost[-F[resource_name,...]][-help][-hhost_list][-j][-lresource[=val],...][-ncb][-uuser,...][-xml]

DESCRIPTION

qhostshows the current status of the available xxQS_NAMExx hosts, queues and thejobs associated with the queues. Selection options allow youto get information about specific hosts, queues, jobs or users.If multiple selections are done a host is only displayed if allselection criteria for a host are met.Without any optionsqhostwill display a list of all hosts without queue or jobinformation.

OPTIONS

-F [resource_name,...]

qhostwill 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 theFull 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 inAlso consumable utilization is ignored.If there are multiple -l resource requests they will be concatenated bya 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 compatibleoutput with othercommand line switches. In that case the outputof the corresponding command will suppress information concerning theexecution host topology. Note that this option will be removed in thenext major version.

-q

Show information about the queues instances hosted by the displayed hosts.

-u user,...

Display information only on those jobs and queuesbeing 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 usedschemas are referenced in the XML output. The output is printed to stdout.

If the -xml parameter is combined with -ncb then the XML output willcontain 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 ofconsisting of

•

the Hostname

•

the Architecture.

•

the Number of processors.

•

the Load.

•

the Total Memory.

•

the Used Memory.

•

the Total Swapspace.

•

the Used Swapspace.

More details can be found in

If the -q option is supplied, each host status line also containsextra lines for every queue hosted by the host consisting of,

•

the queue name,

•

the queue type - one of B(atch), I(nteractive), or a combination thereof,

•

the number of reserved (by advance reservation, not resourcereservation), used and, available (according to the queue'sslotsparameter) job slots,

•

the state of the queue - one ofu(nknown), a(larm), A(larm), C(alendar suspended), s(uspended),S(ubordinate), d(isabled), D(isabled), E(rror), (c)configurationambiguous, (o)rphaned, (P)reempted, or some combinations thereof.See section "Full Format" infor explanation of the status flags.

If the -F option was used, resource availability information is printed following the host status line. For each resource (as selected in an option argument to -F or for all resources if the option argument wasomitted) a single line is displayed with the following format:

•

a one letter specifier indicating whether the current resource availability value was dominated by either
`g' - a cluster global,
`h' - a host total or

•

a second one letter specifier indicating the source for the current resource availability value, being one of
`l' - a load value reported for theresource,
`L' - a load value for the resource after administratordefined load scaling has been applied,
`c' - availability derived fromthe consumable resources facility (see
`f' - a fixedavailability definition derived from a non-consumable complex attribute or a fixed resource limit.

•

after a colon the name of the resource on which information is displayed.

•

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 Gigabyte, 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 printedfor each job running currently in this queue. Each job statusline contains

•

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 theReduced Format section for detailed information),

•

the start date and time and the function of the job (MASTERor SLAVE - only meaningful in case of a parallel job) and

•

the priority of the jobs.

ENVIRONMENT VARIABLES

xxQS_NAME_Sxx_ROOT

Specifies the location of the xxQS_NAMExx standard configurationfiles.

xxQS_NAME_Sxx_CELL

If set, specifies the default xxQS_NAMExx cell. To address a xxQS_NAMExxcellqhost uses (in the order of precedence):

The name of the cell specified in the environment variable xxQS_NAME_Sxx_CELL, if it is set.

The name of the default cell, i.e. default.

xxQS_NAME_Sxx_DEBUG_LEVEL

If set, specifies that debug informationshould be written to stderr. In addition the level ofdetail in which debug information is generated is defined.

xxQS_NAME_Sxx_QMASTER_PORT

If set, specifies the tcp port on whichis expected to listen for communication requests.Most installations will use a services map entry for theservice "sge_qmaster" instead to define that port.

FILES

<xxqs_name_sxx_root>/<cell>/common/act_qmaster xxQS_NAMExx master host file

COPYRIGHT

Seefor a full statement of rights and permissions.