qstat Manual Page

     NAME

          qstat - show status of batch jobs

     SYNOPSIS
          qstat [-f][-W site_specific] [job_identifier... |
          destination...]

          qstat -Q [-f][-W site_specific] [destination...]

          qstat -B [-f][-W site_specific] [server_name...]

     DESCRIPTION
          The qstat command is used to request the status of jobs,
          queues, or a batch server.  The requested status is written
          to standard out.

          When requesting job status, synopsis format 1, qstat will
          output information about each job_identifier or all jobs at
          each destination.  If no operand is specified, all jobs at
          the default destination, see the PBS ERS section , the
          "Default Server".  Jobs for which the user does not have
          status privilege are not displayed.

          When requesting queue status, synopsis format 2, qstat will
          output information about each destination.

     OPTIONS

          -f      Specifies that a full display be written to
                  standard out.  There is a default display for all
                  types of status information which shows all the
                  information available for the object being
                  displayed. If qstat is compiled with an option to
                  include a Tcl interpreter, this flag causes a
                  check to be made for a script file to use to
                  output the requested information.  The first
                  location checked is $HOME/.qstatrc.  If this does
                  not exist, the next location checked is
                  /etc/qstatrc.  If one of these is found, a Tcl
                  interpreter is started and the script file is
                  passed to it along with two global variables.  The
                  command line arguments are passed in a variable
                  named argv and the status information is passed in
                  a variable named objects . Both of these variables
                  are Tcl lists.  The first element in each object
                  in the objects list is the type of object given by
                  one of the following strings:  "server", "queue"
                  or "job".  The second element will be the object
                  name.  The third element will be a list of
                  attributes.  The forth element will be the object
                  text.  Each attribute in the third element list
                  will be a list with two elements.  The first will
                  be the attribute name and the second will be the
                  attribute value.

          -Q      Specifies that the request is for queue status and
                  that the operand is a destination identifier.

          -B      Specifies that the request is for batch server
                  status and that the operand is the name of a
                  server.

     OPERANDS

          If neither the -Q nor the -B option is given, the operands
          on the qstat command must be either job identifiers or
          destinations identifiers.

          If the operand is a job identifier, it must be in the
          following form:
               sequence_number[.server_name][@server]
          where sequence_number.server_name is the job identifier
          assigned at submittal time, see qsub.  If the .server_name

          is omitted, the name of the default server will be used.  If
          @server is supplied, the request will be for the job
          identifier currently at that Server.

          If the operand is a destination identifier, it is one of the
          following three forms:
               queue
               @server
               queue@server
          If queue is specified, the request is for status of all jobs
          in that queue at the default server. If the @server form is
          given, the request is for status of all jobs at that server.
          If a full destination identifier, queue@server, is given,
          the request is for status of all jobs in the named queue at
          the named server.

          If the -Q option is given, the operands are destination
          identifiers as specified above.  If queue is specified, the
          status of that queue at the default server will be given.
          If queue@server is specified, the status of the named queue
          at the named server will be given.  If @server is specified
          or there is no destination specified, the status of all
          queues at the named server will be given.

          If the -B option is given, the operand is the name of a
          server.

     STANDARD OUTPUT

          If job status is being displayed and the -f option is not
          specified, the following items are displayed on a single
          line, in the specified order, separated by white space:

               -  the job identifier assigned by PBS.
               -  the job name given by the submitter.
               -  the job owner
               -  the CPU time used
               -  the job state:
             E -  Job is exiting after having run.
             H -  Job is held.
             Q -  job is queued, eligable to run or routed.
             R -  job is running.
             T -  job is being moved to new location.
             W -  job is waiting for its execution time
                     (-a option) to be reached.
             S -  (Unicos only) job is suspend.
               -  the queue in which the job resides

          If job status is being displayed and the -f option is
          specified, the full display for each job consist of the
          header line:
              Job Id:  job identifier
          Followed by one line per job attribute of the form:
              attribute_name = value

          If queue status is being displayed and the -f option was not
          specified, the following items are displayed on a single
          line, in the specified order, separated by white space:

               -  the queue name
               -  the maximum number of jobs that may be run in the
                  queue concurrently
               -  the total number of jobs in the queue
               -  the enable or disabled status of the queue
               -  the started or stopped status of the queue
               -  for each job state, the name of the state and the
                  number of jobs in the queue in that state.
               -  the type of queue, execution or routing.

          If queue status is being displayed and the -f option was
          specified, the full display for each job consist of the
          header line:
              Queue:  queue_name
          Followed by one line per queue attribute of the form:
              attribute_name = value

          If batch server status is being displayed and the -f option
          is not specified, the following items are displayed on a
          single line, in the specified order, separated by white
          space:

               -  the server name
               -  the maximum number of jobs that the server may run
                  concurrently
               -  the total number of jobs currently managed by the
                  server
               -  the status of the server
               -  for each job state, the name of the state and the
                  number of jobs in the server in that state

          If server status is being displayed and the -f option is
          specified, the full display for the server consist of the
          header line:
              Server:  server name
          Followed by one line per server attribute of the form:
              attribute_name = value

     STANDARD ERROR
          The qstat command will write a diagnostic message to
          standard error for each error occurrence.

     EXIT STATUS
          Upon successful processing of all the operands presented to
          the qstat command, the exit status will be a value of zero.

          If the qstat command fails to process any operand, the
          command exits with a value greater than zero.

qsub | qstat | qdel | qalter | qhold | qmsg | qmove | qrls | qrerun | qselect | qsig