table of contents
other versions
- wheezy 6.2u5-7.1
- jessie-backports 8.1.9+dfsg-1~bpo8+1
- testing 8.1.9+dfsg-4
- unstable 8.1.9+dfsg-4
other sections
conflicting packages
QSTAT(1) | Sun Grid Engine User Commands | QSTAT(1) |
NAME¶
qstat - show the status of Sun Grid Engine jobs and queuesSYNTAX¶
qstat [ -ext ] [ -cb ] [ -f ] [ -F [resource_name,...] ] [ -g {c|d|t}[+] ] [ -help ] [ -j [job_list] ] [ -l resource=val,... ] [ -ne ] [ -pe pe_name,... ] [ -pri ] [ -q wc_queue_list ] [ -qs {a|c|d|o|s|u|A|C|D|E|S} ] [ -r ] [ -s {r|p|s|z|hu|ho|hs|hd|hj|ha|h|a}[+] ] [ -t ] [ -U user,... ] [ -u user,... ] [ -urg ] [ -xml ]DESCRIPTION¶
qstat shows the current status of the available Sun Grid Engine queues and the jobs associated with the queues. Selection options allow you to get information about specific jobs, queues or users. If multiple selections are done a queue is only displayed if all selection criteria for a queue instance are met. Without any option qstat will display only a list of jobs with no queue status information. The administrator and the user may define files (see which can contain any of the options described below. A cluster-wide sge_qstat file may be placed under $SGE_ROOT/$SGE_CELL/common/sge_qstat The user private file is searched at the location $HOME/.sge_qstat. The home directory request file has the highest precedence over the cluster global file. Command line can be used to override the flags contained in the files.OPTIONS¶
- -cb
- In combination with -cb the output of this command
will additionally contain the information of a requested binding and the
changes that have been applied to the topology string (real binding) for
the host where this job is running. This additional information will
appear in combination with the parameters -r and -j.
- -explain a|A|c|E
- ´c' displays the reason for the c(onfiguration
ambiguous) state of a queue instance. 'a' shows the reason for the alarm
state. Suspend alarm state reasons will be displayed by 'A'. 'E' displays
the reason for a queue instance error state.
- -ext
- Displays additional information for each job related to the job ticket policy scheme (see OUTPUT FORMATS below).
- -f
- Specifies a "full" format display of information. The -f option causes summary information on all queues to be displayed along with the queued job list.
- -F [ resource_name,... ]
- Like in the case of -f information is displayed on all jobs as well as queues. In addition, qstat will present a detailed listing of the current resource availability per queue 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.
- -g {c|d|t}[+]
- The -g option allows for controlling grouping of
displayed objects.
- -help
- Prints a listing of all options.
- -j [job_list]
- Prints either for all pending jobs or the jobs contained in
job_list various information. The job_list can contain job_ids, job_names,
or wildcard expression
- -l resource[=value],...
- Defines the resources required by the jobs or granted by the queues on which information is requested. Matching is performed on queues 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"). Consumable utilization is also ignored. The pending jobs are restricted to jobs that might run in one of the above queues. In a similar fashion also the queue-job matching bases only on non-mutable resource availability information. If there are multiple -l resource requests they will be concatenated by a logical AND: a queue needs to match all resources to be displayed.
- -ne
- In combination with -f the option suppresses the display of empty queues. This means all queues where actually no jobs are running are not displayed.
- -pe pe_name,...
- Displays status information with respect to queues which
are attached to at least one of the parallel environments enlisted in the
comma separated option argument. Status information for jobs is displayed
either for those which execute in one of the selected queues or which are
pending and might get scheduled to those queues in principle.
- -pri
- Displays additional information for each job related to the job priorities in general. (see OUTPUT FORMATS below).
- -q wc_queue_list
- Specifies a wildcard expression queue list to which job information is to be displayed. Find the definition of wc_queue_list in
- -qs {a|c|d|o|s|u|A|C|D|E|S}
- Allows for the filtering of queue instances according to state.
- -r
- Prints extended information about the resource requirements
of the displayed jobs.
- -s {p|r|s|z|hu|ho|hs|hd|hj|ha|h|a}[+]
-
- -t
- Prints extended information about the controlled sub-tasks of the displayed parallel jobs. Please refer to the OUTPUT FORMATS sub-section Reduced Format below for detailed information. Sub-tasks of parallel jobs should not be confused with array job tasks (see -g option above and -t option to
- -U user,...
- Displays status information with respect to queues to which the specified users have access. Status information for jobs is displayed either for those which execute in one of the selected queues or which are pending and might get scheduled to those queues in principle.
- -u user,...
- Display information only on those jobs and queues being
associated with the users from the given user list. Queue status
information is displayed if the -f or -F options are
specified additionally and if the user runs jobs in those queues.
- -urg
- Displays additional information for each job related to the job urgency policy scheme (see OUTPUT FORMATS below).
- -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. For more detailed information, the schemas
for the qstat command can be found in
$SGE_ROOT/util/resources/schemas/qstat.
OUTPUT FORMATS¶
Depending on the presence or absence of the -explain, -f, -F, or -qs and -r and -t option three output formats need to be differentiated. The -ext and -urg options may be used to display additional information for each job.Cluster Queue Format (with -g c)¶
Following the header line a section for each cluster queue is provided. When queue instances selection are applied (-l -pe, -q, -U) the cluster format contains only cluster queues of the corresponding queue instances.- •
- the cluster queue name.
- •
- an average of the normalized load average of all queue hosts. In order to reflect each hosts different significance the number of configured slots is used as a weighting factor when determining cluster queue load. Please note that only hosts with a np_load_value are considered for this value. When queue selection is applied only data about selected queues is considered in this formula. If the load value is not available at any of the hosts '-NA-' is printed instead of the value from the complex attribute definition.
- •
- the number of currently used slots.
- •
- the number of slots reserved in advance.
- •
- the number of currently available slots.
- •
- the total number of slots.
- •
- the number of slots which is in at least one of the states 'aoACDS' and in none of the states 'cdsuE'
- •
- the number of slots which are in one of these states or in any combination of them: 'cdsuE'
- •
- the -g c option can be used in combination with -ext. In this case, additional columns are added to the output. Each column contains the slot count for one of the available queue states.
Reduced Format (without -f, -F, and -qs)¶
Following the header line a line is printed for each job consisting of- •
- the job ID.
- •
- the priority of the job determining its position in the pending jobs list. The priority value is determined dynamically based on ticket and urgency policy set-up (see also ).
- •
- the name of the job.
- •
- the user name of the job owner.
- •
- the status of the job - one of d(eletion), E(rror), h(old),
r(unning), R(estarted), s(uspended), S(uspended), t(ransfering),
T(hreshold) or w(aiting).
- •
- the submission or start time and date of the job.
- •
- the queue the job is assigned to (for running or suspended jobs only).
- •
- the number of job slots or the function of parallel job
tasks if -g t is specified.
- •
- the array job task id. Will be empty for non-array jobs. See the -t option to and the -g above for additional information.
- •
- the parallel task ID (do not confuse parallel tasks with array job tasks),
- •
- the status of the parallel task - one of r(unning), R(estarted), s(uspended), S(uspended), T(hreshold), w(aiting), h(old), or x(exited).
- •
- the cpu, memory, and I/O usage,
- •
- the exit status of the parallel task,
- •
- and the failure code and message for the parallel task.
Full Format (with -f and -F)¶
Following the header line a section for each queue separated by a horizontal line is provided. For each queue the information printed consists of- •
- the queue name,
- •
- the queue type - one of B(atch), I(nteractive), C(heckpointing), P(arallel), T(ransfer) or combinations thereof or N(one),
- •
- the number of used and available job slots,
- •
- the load average of the queue host,
- •
- the architecture of the queue host and
- •
- the state of the queue - one of u(nknown) if the corresponding cannot be contacted, a(larm), A(larm), C(alendar suspended), s(uspended), S(ubordinate), d(isabled), D(isabled), E(rror) or combinations thereof.
- •
- 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 line starts with the keyword `alarm'
- •
- appended to the resource value is the type and value of the appropriate threshold
- •
- the job ID,
- •
- the priority of the job determining its position in the pending jobs list. The priority value is determined dynamically based on ticket and urgency policy set-up (see also ).
- •
- 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 submission or start time and date of the job.
- •
- the number of job slots or the function of parallel job
tasks if -g t is specified.
- •
- the task ID,
- •
- the status of the task - one of r(unning), R(estarted), s(uspended), S(uspended), T(hreshold), w(aiting), h(old), or x(exited) (see the Reduced Format section for detailed information),
- •
- the cpu, memory, and I/O usage,
- •
- the exit status of the task,
- •
- and the failure code and message for the task.
Expanded Format (with -r)¶
If the -r option was specified together with qstat, the following information for each displayed job is printed (a single line for each of the following job characteristics):- •
- The job and master queue name.
- •
- The hard and soft resource requirements of the job as specified with the -l option. The per resource addend when determining the jobs urgency contribution value is printed (see also
- •
- The requested parallel environment including the desired queue slot range (see -pe option of
- •
- The requested checkpointing environment of the job (see the -ckpt option).
- •
- In case of running jobs, the granted parallel environment with the granted number of queue slots.
- •
- If -cb was specified the requested job binding parameters.
Enhanced Output (with -ext)¶
For each job the following additional items are displayed:- ntckts
- The total number of tickets in normalized fashion.
- project
- The project to which the job is assigned as specified in the -P option.
- department
- The department, to which the user belongs (use the -sul and -su options of to display the current department definitions).
- cpu
- The current accumulated CPU usage of the job in seconds.
- mem
- The current accumulated memory usage of the job in Gbytes seconds.
- io
- The current accumulated IO usage of the job.
- tckts
- The total number of tickets assigned to the job currently
- ovrts
- The override tickets as assigned by the -ot option of
- otckt
- The override portion of the total number of tickets assigned to the job currently
- ftckt
- The functional portion of the total number of tickets assigned to the job currently
- stckt
- The share portion of the total number of tickets assigned to the job currently
- share
- The share of the total system to which the job is entitled currently.
Enhanced Output (with -urg)¶
For each job the following additional urgency policy related items are displayed (see also- nurg
- The jobs total urgency value in normalized fashion.
- urg
- The jobs total urgency value.
- rrcontr
- The urgency value contribution that reflects the urgency that is related to the jobs overall resource requirement.
- wtcontr
- The urgency value contribution that reflects the urgency related to the jobs waiting time.
- dlcontr
- The urgency value contribution that reflects the urgency related to the jobs deadline initiation time.
- deadline
- The deadline initiation time of the job as specified with the -dl option.
Enhanced Output (with -pri)¶
For each job, the following additional job priority related items are displayed (see also- nurg
- The job's total urgency value in normalized fashion.
- npprior
- The job's -p priority in normalized fashion.
- ntckts
- The job's ticket amount in normalized fashion.
- ppri
- The job's -p priority as specified by the user.
ENVIRONMENTAL VARIABLES¶
- SGE_ROOT
- Specifies the location of the Sun Grid Engine standard configuration files.
- SGE_CELL
- If set, specifies the default Sun Grid Engine cell. To
address a Sun Grid Engine cell qstat 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.
- SGE_LONG_QNAMES
- Qstat does display queue names up to 30 characters. If that is to much or not enough, one can set a custom length with this variable. The minimum display length is 10 characters. If one does not know the best display length, one can set SGE_LONG_QNAMES to -1 and qstat will figure out the best length.
FILES¶
<sge_root>/<cell>/common/act_qmaster Sun Grid Engine master host file <sge_root>/<cell>/common/sge_qstat cluster qstat default options $HOME/.sge_qstat user qstat default options
SEE ALSO¶
COPYRIGHT¶
See for a full statement of rights and permissions.$Date$ | SGE 6.2u5 |