1QMOD(1) Grid Engine User Commands QMOD(1)
2
6 qmod - modify a Grid Engine queue and running job
7
9 qmod [ options ] [ wc_job_range_list | wc_queue_list ]
10
12 Qmod enables users classified as owners (see queue_conf(5) for details)
13 of a workstation to modify the state of Grid Engine queues for his/her
14 machine as well as the state of his/her own jobs. A manager/operator
15 or root can execute qmod for any queue and job in a cluster but only
16 from administrative hosts. Find additional information concerning
17 wc_queue_list and wc_job_list in sge_types(1).
18
20 -c Note: Deprecated, may be removed in future release. Please use
21 the -cj or -cq switch instead.
22 Clears the error state of the specified jobs(s)/queue(s).
23 -cj Clears the error state of the specified jobs(s).
25 -cq Clears the error state of the specified queue(s).
27 -d Disables the queue(s), i.e. no further jobs are dispatched to
29 disabled queues while jobs already executing in these queues are
30 allowed to finish.
31 -e Enables the queue(s).
33 -f Force the modification action for the queue despite the apparent
35 current state of the queue. For example if a queue appears to be
36 suspended but the job execution seems to be continuing the man‐
37 ager/operator can force a suspend operation which will send a
38 SIGSTOP to the jobs. In any case, the queue or job status will
39 be set even if the ge_execd(8) controlling the queues/jobs can‐
40 not be reached. Requires manager/operator privileges.
41 -help Prints a listing of all options.
43 -r Note: Deprecated, may be removed in future release. Please use
45 the -rj or -rq switch instead.
46 If applied to queues, reschedules all jobs currently running in
47 this queue. If applied to running jobs, reschedules the jobs.
48 Requires root or manager privileges. In order for a job to be
49 rescheduled, it or the queue in which it is executing must have
50 the rerun flag activated. (See -r option in the qsub(1) man
51 page and the rerun option in the queue_conf(5) man page for more
52 information.) Additional restrictions apply for parallel and
53 checkpointing jobs. (See the reschedule_unknown description in
54 the sge_conf(5) man page for details).
55 -rj If applied to running jobs, reschedules the jobs. Requires root
57 or manager privileges.
58 -rq If applied to queues, reschedules all jobs currently running in
60 this queue. Requires root or manager privileges.
61 -s Note: Deprecated, may be removed in future release. Please use
63 the -sj or -sq switch instead.
64 If applied to queues, suspends the queues and any jobs which
65 might be active. If applied to running jobs, suspends the jobs.
66 -sj If applied to running jobs, suspends the jobs. If a job is both
68 suspended explicitly and via suspension of its queue, a follow‐
69 ing unsuspend of the queue will not release the suspension state
70 on the job.
71 -sq If applied to queues, suspends the queues and any jobs which
73 might be active.
74 -us Note: Deprecated, may be removed in future release. Please use
76 the -usj or -usq switch instead.
77 If applied to queues, unsuspends the queues and any jobs which
78 might be active. If applied to jobs, unsuspends the jobs.
79 -usj If applied to jobs, unsuspends the jobs. If a job is both sus‐
81 pended explicitly and via suspension of its queue, a following
82 unsuspend of the queue will not release the suspension state on
83 the job.
84 -usq If applied to queues, unsuspends the queues and any jobs which
86 might be active.
87
89 GE_ROOT Specifies the location of the Grid Engine standard con‐
90 figuration files.
91 GE_CELL If set, specifies the default Grid Engine cell. To
93 address a Grid Engine cell qmod uses (in the order of
94 precedence):
95 The name of the cell specified in the environment
97 variable GE_CELL, if it is set.
98 The name of the default cell, i.e. default.
100 GE_DEBUG_LEVEL If set, specifies that debug information should be writ‐
103 ten to stderr. In addition the level of detail in which
104 debug information is generated is defined.
105 GE_QMASTER_PORT
107 If set, specifies the tcp port on which ge_qmaster(8) is
108 expected to listen for communication requests. Most
109 installations will use a services map entry for the ser‐
110 vice "sge_qmaster" instead to define that port.
111
113 <ge_root>/<cell>/common/act_qmaster
114 Grid Engine master host file
115
117 ge_intro(1), ge_ckpt(1), qstat(1), queue_conf(5), ge_execd(8),
118 ge_types(1).
119
121 See ge_intro(1) for a full statement of rights and permissions.
122GE 6.2u5 $Date: 2009/05/11 12:23:44 $ QMOD(1)