SYNOPSIS

       cqadm  [-d] [--hold] [--release] [--run=<location>] [--kill] [--delete]
       [--queue=newqueue] <jobid> <jobid>

       cqadm  [-d]  [-f]  [--addq]  [--delq]  [--getq]   [--setq   'prop=value
       prop=value'] [--unsetq 'property property'] <queue> <queue>

       cqadm [--version]

DESCRIPTION

       Administrative  interface  for  queue manager. Allows one to hold, run,
       kill, and set the queue for jobs in the queue manager. Can also add/del
       queues and set queue properties.

OPTIONS

       --version
              Display client revision and Cobalt version

       -d     Enable communication debugging

       -f     Force queue deletion

       --hold jobid
              Set  job  state  to  hold,  preventing  execution (only works on
              'queued' jobs)

       --release jobid
              Set job state to ready, allowing execution

       --run=<location> jobid
              Run the job immediately on the specified location

       --kill jobid
              Kill job(s) using normal mechanism

       --delete jobid
              Kill job(s) using forceable deletion. Job state will be deleted.
              This may leave processes dangling on computation resources.

       --queue=<queue> jobid
              Move  job  to  specified  queue (only works on jobs that are not
              'running')

       --time=<walltime> jobid
              Change job walltime to specified one

       -i index jobid
              Change the sorting index of the job, so that fifo  behaves  dif-
              ferently in scheduling.


       --stopq queue
              Stop  queue(s). Queue state is set to 'stopped'. New jobs can be
              submitted, but existing jobs will not be run.

       --drainq queue
              Drain queue(s). No new jobs can be submitted, and  jobs  already
              in  the  queue  will run normally. Queue state is set to 'drain-
              ing'.

       --killq queue
              Kill the queue(s). No new jobs can be submitted, and no jobs  in
              the queue will run. Queue state is set to 'dead'.

       --setq 'prop=value prop=value' queue
              Set  properties for one or more queues. The prop=value pairs are
              separated by whitespace.

       --unsetq 'property property' queue
              Move a property back to its unset state.  Used for  example,  to
              remove a queue restriction.


       Properties

              maxtime=mm
                     The  maximum  walltime (in minutes) allowed for jobs sub-
                     mitted to the queue.

              mintime=mm
                     The minimum walltime (in minutes) allowed for  jobs  sub-
                     mitted to the queue.

              maxqueued=x
                     The  maximum  number of jobs a user is allowed to have in
                     the queue, whether running or queued.

              users=user1:user2:user2
                     List of users allowed to submit  to  the  queue.  An  '*'
                     means any user can submit to the queue.

              state=running|stopped|draining|dead
                     Flag   determining  state  of  queue.  If  the  queue  is
                     'stopped', jobs can be submitted to  the  queue,  but  no
                     jobs  will  be  run  by  the  scheduler.  If the queue is
                     'draining', no new jobs will be allowed to  be  added  to
                     the queue, but jobs existing in the queue will be run. If
                     the queue is 'dead', no new jobs will  be  added  and  no
                     existing  jobs  will  be  run. (Also provided by --startq
                     --stopq --drainq --killq ).

              [email protected]:[email protected]

              priority=x
                     The priority that should  be  set  for  the  queue.   The
                     default  priority  for  a  queue is 0, and larger numbers
                     indicate higher priority.

EXAMPLE

       Set no minimum walltime, a max walltime of 30 minutes, and  only  users
       'mike, john, and george' can submit to someq:

              cqadm --unsetq mintime someq

              cqadm --setq 'maxtime=30 users=mike:john:george' someq

SEE ALSO

       cqm(8)

BUGS

                                                                      cqadm(8)

---

Man(1) output converted with man2html