wiki:qstat.1.html
Last modified 9 years ago Last modified on 08/30/13 17:31:31

SYNOPSIS

       qstat [--version] [-d] [-f] [-l] <jobid> <jobid>

       qstat  [-d] -q <queue> <queue>


DESCRIPTION

       qstat query the queue manager for all queued and active jobs.


OPTIONS

       -d --debug
              Turn on communication debugging

       -h --help
              Displays the usage and a brief descriptions of the options

       --version
              Displays client revision and Cobalt version

       -f --full
              Show more verbose information.

       --header <header fields>
              Specify  custom  header   with  a colon-separated list for qstat
              display. (See qstat -lf for the  possible  fields.)  The  custom
              header  may  also be specified setting QSTAT_HEADER in the envi‐
              ronment   or   a   cqstat_header   entry    under    [cqm]    in
              /etc/cobalt.conf.  The  header  is  taken  from /etc/cobalt.conf
              first, then $QSTAT_HEADER, and finally qstat --header.

              Example:

              qstat --header JobId:State:RunTime

       -l --long
              Show job info in vertical format. Use with '-f' to get  all  job
              info.

       -Q     Show queues and properties.

              Properties:

              MaxTime
                     The  maximum  walltime (in minutes) allowed for jobs sub‐
                     mitted to the queue.

              MinTime
                     The minimum walltime (in minutes) allowed for  jobs  sub‐
                     mitted to the queue.

              MaxQueued
                     The  maximum  number of jobs a user is allowed to have in
                     the queue, whether running or queued.
                     The maximum number of jobs a user is allowed to have run‐
                     ning in the queue.

              MaxUsernodes
                     The maximum number of nodes a user  is  allowed  to  have
                     allocated with running jobs in the queue.

              TotalNodes
                     The  maximum  number  of  nodes any jobs in the queue are
                     allowed to have allocated with running jobs.

              Priority
                     The priority of the queue.  Higher  numbers  have  higher
                     priority.

       --reverse
              Reverse ouput

       --sort <sort fields>
              Specify  sort fields  with a colon-separated list for qstat dis‐
              play.

       -u --user <user name>
              Specify user name.


ENIRONMENT VARIABLES

       The following environment variables affect qstat:

       QSTAT_HEADER
              Specifies custom header for job queries (See --header).


SEE ALSO

       qdel(1), qsub(1), cqm(1)


BUGS

       None are currently known.

                                                                      qstat(1)