QMOD(1)                    Grid Engine User Commands                   QMOD(1)



NNAAMMEE
       qmod - modify a Grid Engine queue

SSYYNNTTAAXX
       qqmmoodd [ ooppttiioonnss ] [ wwcc__jjoobb__rraannggee__lliisstt | wwcc__qquueeuuee__lliisstt ]


DDEESSCCRRIIPPTTIIOONN
       _Q_m_o_d enables users classified as _o_w_n_e_r_s (see _q_u_e_u_e___c_o_n_f(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 _q_m_o_d for any queue and job in a  cluster  but  only
       from  administrative  hosts.   Find  additional  information concerning
       _w_c___q_u_e_u_e___l_i_s_t and _w_c___j_o_b___l_i_s_t in _s_g_e___t_y_p_e_s(1).

OOPPTTIIOONNSS
       --cc     NNoottee:: Deprecated, may be removed in future release.  Please  use
              the --ccjj or --ccqq switch instead.
              Clears the error state of the specified jobs(s)/queue(s).

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

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

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

       --ee     Enables the queue(s).

       --ff     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 _g_e___e_x_e_c_d(8) controlling the queues/jobs  can-
              not be reached. Requires manager/operator privileges.

       --hheellpp  Prints a listing of all options.

       --rr     NNoottee::  Deprecated, may be removed in future release.  Please use
              the --rrjj or --rrqq 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  _q_s_u_b(1)  man
              page and the _r_e_r_u_n option in the _q_u_e_u_e___c_o_n_f(5) man page for more
              information.)  Additional restrictions apply  for  parallel  and
              checkpointing  jobs.  (See the _r_e_s_c_h_e_d_u_l_e___u_n_k_n_o_w_n description in
              the _s_g_e___c_o_n_f(5) man page for details).

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

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

       --ss     NNoottee:: Deprecated, may be removed in future release.  Please  use
              the --ssjj or --ssqq switch instead.
              If  applied  to  queues,  suspends the queues and any jobs which
              might be active. If applied to running jobs, suspends the  jobs.

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

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

       --uuss    NNoottee::  Deprecated, may be removed in future release.  Please use
              the --uussjj or --uussqq switch instead.
              If applied to queues, unsuspends the queues and any  jobs  which
              might be active. If applied to jobs, unsuspends the jobs.

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

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

EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS
       GGEE__RROOOOTT        Specifies  the location of the Grid Engine standard con-
                      figuration files.

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


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

       GGEE__QQMMAASSTTEERR__PPOORRTT
                      If set, specifies the tcp port on which _g_e___q_m_a_s_t_e_r(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.

FFIILLEESS
       _<_g_e___r_o_o_t_>_/_<_c_e_l_l_>_/_c_o_m_m_o_n_/_a_c_t___q_m_a_s_t_e_r
                      Grid Engine master host file

SSEEEE AALLSSOO
       _g_e___i_n_t_r_o(1),   _g_e___c_k_p_t(1),   _q_s_t_a_t(1),   _q_u_e_u_e___c_o_n_f(5),    _g_e___e_x_e_c_d(8),
       _g_e___t_y_p_e_s(1).

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



GE 6.2u2                 $Date: 2008/10/06 07:42:01 $                  QMOD(1)
