bionic (1) qstatus.1.gz

NAME

       qstatus - Grid Engine qstatus script

SYNOPSIS

       qstatus [-acghjlmnot] [-s SORT_FIELD_LIST] [USER]

DESCRIPTION

       This manual page documents qstatus, a script to reformat the output of the Grid Engine command qstat(1).

       The  reformatted  list is by default limited to the actual user account. This can be changed to request a
       job list of any user by supplying the username USER as the last argument, or requesting an output for all
       users by the -a switch (see below).

   Options
       -a     Display the jobs of all users. May not be used when there is a dedicated user specified. This also
              implies the output of the owner of the jobs.

       -c     Calculate a statistic of the listed jobs.

       -g     Group output by owner. Only applicable if the owner is listed, either by the -o switch or  implied
              by -a. This is a short form of ‘-s owner,running’. Can't be used together with the -s option.

       -h     Print help.

       -j     Include jobs which are suspended.

       -l     Suppress  the  output  of  the  list  of jobs. Maybe useful in case you are only interested in the
              statistic with the -c switch.

       -m     Display the machine instead of the name of the queue the  job  is  running  in  under  the  column
              ‘running in’. Only meaningful for SGE 6.0 or above.

       -n     Suppress  the  listing  of  the  individual  owner,  mostly useful when all jobs are listed. Takes
              precedence over any other implied options.  If used together  with  -o,  only  the  later  one  is
              relevant.

       -o     List  the  owner  of  the  individual job. Takes precedence over any other implied option. If used
              together with -n, only the later one is relevant.

       -r     Display times relative to submit- or start-times, as appropriate.

       -s SORT_FIELD_LIST
              Sort  the  output  according  to  the  given  columns.  The   SORT_FIELD_LIST   has   the   format
              SORT_FIELD_LIST=SORT_FIELD[,SORT_FIELD]*  where  SORT_FIELD  can be one of job, name, none, owner,
              running, slots, time.

              The option none will supersede any other column names and set the complete sort order to none.

              The column owner can only be used if the owner of the job is displayed at all. Otherwise  it  will
              be ignored.

              The sort by running will only be used for the running jobs, not for the waiting ones.

              This will overwrite the default sort order, which is:

                     running jobs:  running
                     waiting jobs:  none

              If the option -g is specified, the default sort order is changed to:

                     running jobs:  owner,running
                     waiting jobs:  owner

       -t     Append task ID to the jobname for array tasks. This option has no meaning for non-array jobs.

AUTHOR

       Written by Reuti.

REPORTING BUGS

       Report bugs to <reuti@staff.uni-marburg.de>.

COPYRIGHT

       Copyright © 2010 Philipps-University of Marburg.
       This is free software.  You may redistribute copies of it under the terms of the GNU General Public
       License ⟨http://www.gnu.org/licenses/gpl.html⟩.  There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

       qstat(1) of Grid Engine.

BUGS

       Does not support the PBS or Torque resource manager.  The Awk script used probably isn't portable and may
       require GNU Awk version 3 or higher.