Man Linux: Main Page and Category List

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.