NAME

       qmod - modify a Sun Grid Engine queue and running job

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 Sun 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 but only  from  administrative  hosts.   Find  additional  information  concerning
       wc_queue_list and wc_job_list in sge_types(1).

OPTIONS

       -c     Note:  Deprecated,  may  be  removed  in future release.  Please use the -cj or -cq
              switch instead.
              Clears the error state of the specified jobs(s)/queue(s).

       -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  sge_execd(8) controlling the queues/jobs cannot be reached. Requires
              manager/operator privileges.

       -help  Prints a listing of all options.

       -r     Note: Deprecated, may be removed in future release.  Please  use  the  -rj  or  -rq
              switch instead.
              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.
              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     Note:  Deprecated,  may  be  removed  in future release.  Please use the -sj or -sq
              switch instead.
              If applied to queues, suspends the queues and any jobs which might  be  active.  If
              applied to running jobs, suspends the jobs.

       -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    Note:  Deprecated,  may  be removed in future release.  Please use the -usj or -usq
              switch instead.
              If applied to queues, unsuspends the queues and any jobs which might be active.  If
              applied to jobs, unsuspends the jobs.

       -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

       SGE_ROOT       Specifies the location of the Sun Grid Engine standard configuration files.

       SGE_CELL       If  set,  specifies the default Sun Grid Engine cell. To address a Sun 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.

       SGE_QMASTER_PORT
                      If  set,  specifies  the  tcp  port  on which sge_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

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

SEE ALSO

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

COPYRIGHT

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