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



[1mNAME[0m
       qmod - modify a Grid Engine queue

[1mSYNTAX[0m
       [1mqmod [22m[ [1moptions [22m] [ [1mwc_job_range_list [22m| [1mwc_queue_list [22m]


[1mDESCRIPTION[0m
       [4mQmod[24m enables users classified as [4mowners[24m (see [4mqueue_conf[24m(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 [4mqmod[24m for any queue and job in a cluster. Find addi-
       tional   information   concerning   [4mwc_queue_list[24m  and  [4mwc_job_list[24m  in
       [4msge_types[24m(1).

[1mOPTIONS[0m
       [1m-c     [22mClears the error state of the  specified  jobs(s)/queue(s).   Do
              not use this switch anymore, use -cj / -cq instead.

       [1m-cj    [22mClears the error state of the specified jobs(s).

       [1m-cq    [22mClears the error state of the specified queue(s).

       [1m-d     [22mDisables  the  queue(s),  i.e. no further jobs are dispatched to
              disabled queues while jobs already executing in these queues are
              allowed to finish.

       [1m-e     [22mEnables the queue(s).

       [1m-f     [22mForce 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 [4msge_execd[24m(8) controlling the queues/jobs can-
              not be reached. Requires manager/operator privileges.

       [1m-help  [22mPrints a listing of all options.

       [1m-r     [22mIf  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  [4mqsub[24m(1)  man  page
              and  the  [4mrerun[24m  option  in  the [4mqueue_conf[24m(5) man page for more
              information.)  Additional restrictions apply  for  parallel  and
              checkpointing  jobs.  (See the [4mreschedule_unknown[24m description in
              the [4msge_conf[24m(5) man page for details).

       [1m-rj    [22mIf applied to running jobs, reschedules the jobs. Requires  root
              or manager privileges.

       [1m-rq    [22mIf  applied to queues, reschedules all jobs currently running in
              this queue.  Requires root or manager privileges.

       [1m-s     [22mIf 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.

       [1m-sj    [22mIf  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.

       [1m-sq    [22mIf applied to queues, suspends the queues  and  any  jobs  which
              might be active.

       [1m-us    [22mIf  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.

       [1m-usj   [22mIf  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.

       [1m-usq   [22mIf applied to queues, unsuspends the queues and any  jobs  which
              might be active.

[1mENVIRONMENTAL VARIABLES[0m
       [1mSGE_ROOT       [22mSpecifies  the location of the Grid Engine standard con-
                      figuration files.

       [1mSGE_CELL       [22mIf set, specifies  the  default  Grid  Engine  cell.  To
                      address  a  Grid  Engine cell [4mqmod[24m 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. [1mdefault[22m.


       [1mSGE_DEBUG_LEVEL[0m
                      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.

       [1mSGE_QMASTER_PORT[0m
                      If  set,  specifies the tcp port on which [4msge_qmaster[24m(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.

[1mFILES[0m
       [4m<sge_root>/<cell>/common/act_qmaster[0m
                       Grid Engine master host file

[1mSEE ALSO[0m
       [4msge_intro[24m(1),  [4msge_ckpt[24m(1),  [4mqstat[24m(1),   [4mqueue_conf[24m(5),   [4msge_execd[24m(8),
       [4msge_types[24m(1).

[1mCOPYRIGHT[0m
       See [4msge_intro[24m(1) for a full statement of rights and permissions.



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