NAME
     qmod - modify a Grid Engine queue

SYNTAX
     qmod [ options ] [ job/task_id_list | queue_list ]

DESCRIPTION
     Qmod enables users classified as owners  (see  queue_conf(5)
     for  details)  of  a workstation to modify the state of Grid
     Engine queues for his/her machine as well as  the  state  of
     his/her  own  jobs.   A manager/operator or root can execute
     qmod for any queue and job in a cluster.

OPTIONS
     -c   Clears the error state of the specified queue(s).

     -d   Disables  the  queue(s),  i.e.  no  further  jobs   are
          dispatched  to  disabled queues while jobs already exe-
          cuting in these queues are allowed to finish.

          (Is the successor of the CODINE version 3 -soc option.)

     -e   Enables the queue(s).

          (Is  the  successor  of  the  CODINE  version  3  -xsoc
          option.)

     -f   Force the modification action for the queue despite the
          apparent  current  state of the queue. For example if a
          queue appears to be suspended  but  the  job  execution
          seems to be continuing the manager/operator can force a
          suspend operation which will  send  a  SIGSTOP  to  the
          jobs.  In any case, the queue or job status will be set
          even if the sge_execd(8)  controlling  the  queues/jobs
          cannot    be    reached.    Requires   manager/operator
          privileges.

     -help
          Prints a listing of all options.

     -r   If applied to queues, reschedules  all  jobs  currently
          running  in  this  queue.   If applied to running jobs,
          reschedules  the  jobs.  Requires   root   or   manager
          privileges.

     -s   If applied to queues, suspends the queues and any  jobs
          which  might  be  active.  If  applied to running jobs,
          suspends the jobs. If a job is  both  suspended  expli-
          citly  and  via  suspension  of  its queue, a following
          unsuspend of the queue will not release the  suspension
          state on the job.

     -us  If applied to queues, unsuspends  the  queues  and  any
          jobs  which  might  be  active.  If  applied  to  jobs,
          unsuspends the jobs. If a job is both suspended  expli-
          citly  and  via  suspension  of  its queue, a following
          unsuspend of the queue will not release the  suspension
          state on the job.

     -verify
          performs no modifications but just prints what would be
          done if -verify was not present.

     job/task_id_list | queue_list
          The jobs or queues  upon  which  qmod  is  supposed  to
          operate.  The  job/task_id_list  is specified by one of
          the following forms:

              job_id[.task_range][,job_id[.task_range],...]
              job_id[.task_range][ job_id[.task_range] ...]

          If present, the task_range restricts the effect of  the
          qmod operation to the array job task range specified as
          suffix to the job id (see the -t option to qsub(1)  for
          further details on array jobs).

          The task range specifier has  the  form  n[-m[:s]][,n[-
          m[:s]], ...] or n[-m[:s]][ n[-m[:s]] ...] and thus con-
          sists of a comma  or  blank  separated  list  of  range
          specifiers  n[-m[:s]].  The  ranges are concatenated to
          the complete task id range. Each range may be a  single
          number,  a simple range of the form n-m or a range with
          a step size.

          The queue_list is specified by  one  of  the  following
          forms:

              queuename[,queuename ...]
              queuename[ queuename ...]

          Alternatively a wildcard charcter "*" can be  used  for
          specifying  queues,   e.g.  "s*" will select all queues
          starting with "s".

ENVIRONMENTAL VARIABLES
     SGE_ROOT       Specifies the location  of  the  Grid  Engine
                    standard configuration files.

     SGE_CELL       If set, specifies  the  default  Grid  Engine
                    cell. To address a Grid Engine cell qmod uses
                    (in the order of precedence):

                         The name of the cell  specified  in  the
                         environment  variable SGE_CELL, if it is
                         set.

                         The  name  of  the  default  cell,  i.e.
                         default.


     SGE_DEBUG_LEVEL
                    If  set,  specifies  that  debug  information
                    should  be written to stderr. In addition the
                    level of detail in which debug information is
                    generated is defined.

     COMMD_PORT     If set,  specifies  the  tcp  port  on  which
                    sge_commd(8)  is  expected to listen for com-
                    munication requests.  Most installations will
                    use  a  services  map entry instead to define
                    that port.

     COMMD_HOST     If set, specifies the host on which the  par-
                    ticular  sge_commd(8)  to  be  used  for Grid
                    Engine  communication  of  the  qmod   client
                    resides.  Per default the local host is used.

FILES
     <sge_root>/<cell>/common/act_qmaster
                     Grid Engine master host file

SEE ALSO
     sge_intro(1),    sge_ckpt(1),    qstat(1),    queue_conf(5),
     sge_execd(8).

COPYRIGHT
     See sge_intro(1) for a full statement of rights and  permis-
     sions.



















Man(1) output converted with man2html