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 Univa Grid  Engine  queues  for
       his/her  machine  as  well  as  the  state of his/her own jobs.  A man-
       ager/operator or root can execute qmod for any queue and job in a clus-
       ter  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 man-
              ager/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 can-
              not 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.

              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 sus-
              pended 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 Univa Grid Engine standard
                      configuration files.

       SGE_CELL       If set, specifies the default Univa Grid Engine cell. To
                      address a Univa 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 writ-
                      ten 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 ser-
                      vice "sge_qmaster" instead to define that port.

FILES
       <sge_root>/<cell>/common/act_qmaster
                       Univa 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.



Man(1) output converted with man2html