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. Find addi-
       tional   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     Clears the error state of the  specified  jobs(s)/queue(s).   Do
              not use this switch anymore, use -cj / -cq instead.

       --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 _s_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     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 any-
              more.  Use -rj /-rq instead.  In order for a job to be  resched-
              uled,  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     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.

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

       --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
       SSGGEE__RROOOOTT       Specifies  the location of the Grid Engine standard con-
                      figuration files.

       SSGGEE__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 SGE_CELL, if it is set.

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


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

       SSGGEE__QQMMAASSTTEERR__PPOORRTT
                      If  set,  specifies the tcp port on which _s_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
       _<_s_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
       _s_g_e___i_n_t_r_o(1),  _s_g_e___c_k_p_t(1),  _q_s_t_a_t(1),   _q_u_e_u_e___c_o_n_f(5),   _s_g_e___e_x_e_c_d(8),
       _s_g_e___t_y_p_e_s(1).

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



GE 6.0                   $Date: 2007/01/05 20:31:03 $                  QMOD(1)
