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  but  only
       from  administrative  hosts.   Find  additional  information concerning
       [4mwc_queue_list[24m and [4mwc_job_list[24m in [4msge_types[24m(1).

[1mOPTIONS[0m
       [1m-c     Note: [22mDeprecated, may be removed in future release.  Please  use
              the [1m-cj [22mor [1m-cq [22mswitch instead.
              Clears the error state of the specified jobs(s)/queue(s).

       [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 [4mge_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     Note:  [22mDeprecated, may be removed in future release.  Please use
              the [1m-rj [22mor [1m-rq [22mswitch 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  [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     Note: [22mDeprecated, may be removed in future release.  Please  use
              the [1m-sj [22mor [1m-sq [22mswitch instead.
              If  applied  to  queues,  suspends the queues and any jobs which
              might be active. If applied to running jobs, suspends the  jobs.

       [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    Note:  [22mDeprecated, may be removed in future release.  Please use
              the [1m-usj [22mor [1m-usq [22mswitch instead.
              If applied to queues, unsuspends the queues and any  jobs  which
              might be active. If applied to jobs, unsuspends the jobs.

       [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
       [1mGE_ROOT        [22mSpecifies  the location of the Grid Engine standard con-
                      figuration files.

       [1mGE_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 GE_CELL, if it is set.

                             The name of the default cell, i.e. [1mdefault[22m.


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

       [1mGE_QMASTER_PORT[0m
                      If set, specifies the tcp port on which [4mge_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<ge_root>/<cell>/common/act_qmaster[0m
                      Grid Engine master host file

[1mSEE ALSO[0m
       [4mge_intro[24m(1),   [4mge_ckpt[24m(1),   [4mqstat[24m(1),   [4mqueue_conf[24m(5),    [4mge_execd[24m(8),
       [4mge_types[24m(1).

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



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