Provided by: gridengine-client_6.2~beta2-2_i386 bug

NAME

       qmod - modify a Grid Engine queue

SYNTAX

       qmod [ options ] [ wc_job_range_list | wc_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.  Find
       additional  information  concerning  wc_queue_list  and  wc_job_list in
       sge_types(1).

OPTIONS

       -c     Clears the error state of the  specified  jobs(s)/queue(s).   Do
              not use this switch anymore, use -cj / -cq instead.

       -cj    Clears the error state of the specified jobs(s).

       -cq    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 executing in these queues are
              allowed to finish.

       -e     Enables the queue(s).

       -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  ge_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.  Do not use this switch
              anymore.  Use -rj /-rq instead.   In  order  for  a  job  to  be
              rescheduled,  it or the queue in which it is executing must have
              the rerun flag activated.  (See -r option  in  the  qsub(1)  man
              page and the rerun option in the queue_conf(5) man page for more
              information.)  Additional restrictions apply  for  parallel  and
              checkpointing  jobs.  (See the reschedule_unknown description in
              the sge_conf(5) man page for details).

       -rj    If applied to running jobs, reschedules the jobs. Requires  root
              or manager privileges.

       -rq    If  applied to queues, reschedules all jobs currently running in
              this queue.  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.
              Use of this switch is now deprecated. -sj / -sq should  be  used
              instead.

       -sj    If  applied to running jobs, suspends the jobs. If a job is both
              suspended  explicitly  and  via  suspension  of  its  queue,   a
              following unsuspend of the queue will not release the suspension
              state on the job.

       -sq    If applied to queues, suspends the queues  and  any  jobs  which
              might be active.

       -us    If  applied  to queues, unsuspends the queues and any jobs which
              might be active. If applied to jobs, unsuspends the jobs. Do not
              use this switch anymore, use -usj / -usq instead.

       -usj   If  applied  to  jobs,  unsuspends  the  jobs.  If a job is both
              suspended  explicitly  and  via  suspension  of  its  queue,   a
              following unsuspend of the queue will not release the suspension
              state on the job.

       -usq   If applied to queues, unsuspends the queues and any  jobs  which
              might be active.

ENVIRONMENTAL VARIABLES

       GE_ROOT        Specifies  the  location  of  the  Grid  Engine standard
                      configuration files.

       GE_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 GE_CELL, if it is set.

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

       GE_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.

       GE_QMASTER_PORT
                      If set, specifies the tcp port on which ge_qmaster(8) is
                      expected to listen  for  communication  requests.   Most
                      installations  will  use  a  services  map entry for the
                      service "sge_qmaster" instead to define that port.

FILES

       <ge_root>/<cell>/common/act_qmaster
                      Grid Engine master host file

SEE ALSO

       ge_intro(1),   ge_ckpt(1),   qstat(1),   queue_conf(5),    ge_execd(8),
       ge_types(1).

COPYRIGHT

       See ge_intro(1) for a full statement of rights and permissions.