Provided by:
gridengine-client_6.2~beta2-2_i386 
NAME
qmod - modify a Grid Engine queue
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 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. Find
additional information concerning wc_queue_list and wc_job_list in
sge_types(1).
OPTIONS
-c Clears the error state of the specified jobs(s)/queue(s). Do
not use this switch anymore, use -cj / -cq instead.
-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 ge_execd(8) controlling the queues/jobs
cannot be reached. Requires manager/operator privileges.
-help Prints a listing of all options.
-r 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
anymore. Use -rj /-rq instead. 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 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.
-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 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.
-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
GE_ROOT Specifies the location of the Grid Engine standard
configuration files.
GE_CELL If set, specifies the default Grid Engine cell. To
address a Grid Engine cell qmod 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. default.
GE_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.
GE_QMASTER_PORT
If set, specifies the tcp port on which ge_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
<ge_root>/<cell>/common/act_qmaster
Grid Engine master host file
SEE ALSO
ge_intro(1), ge_ckpt(1), qstat(1), queue_conf(5), ge_execd(8),
ge_types(1).
COPYRIGHT
See ge_intro(1) for a full statement of rights and permissions.