miser_qinfo(1)

NAME
     miser_qinfo - query information on miser queues, queue resource status,
     and list of jobs scheduled against a queue

SYNOPSIS
     miser_qinfo -Q | -q qname [-j] | -a

DESCRIPTION
     The miser_qinfo command is used to retrieve information about the free
     resources of a queue, the names of all miser queues, and to query all
     jobs currently scheduled against a particular queue.

OPTIONS
     -Q   Returns a list of miser queue names currently configured.

     -q qname
          Returns the free resources associated with qname. A queue, as
          described in miser(1), has a resource vector of time and space.
          Each element of the vector represents a quantum of time that has an
          associated space against which a job can request resources.  The
          output of this option is a list of all the elements of the resource
          vector in tabular form.  At the top of the table is the name of the
          queue and the size of the quantum in seconds.  Each entry of the
          table either consists of a time/space tuple or of a '-'.  Since the
          size of a vector may be arbitrarily large, a '-' is a ditto mark for
          all quanta whose resources are identical in size to the last entry
          with a time/space tuple.

     -q qname -j
          Returns the list of jobs currently scheduled against qname.

     -a   Returns a list of all scheduled jobs in all configured miser queues
          ordered by job ID.  The job list produces a brief description of the
          job.  See miser_jinfo(1) for a description of the output fields.

RESTRICTIONS
     The information returned is a snapshot of the current resources and may
     be inaccurate by the time the information is displayed.

     To access information about a particular queue, the user must have read
     access to the queue definition file (see miser(4) for more information
     about queue definition files).

SEE ALSO
     miser(5), miser(4), miser(1), miser_submit(1), miser_jinfo(1),
     miser_move(1), miser_reset(1).