|
|
Unix Batch command, and running jobs in queues.
|
|
QMOD(1) Sun Grid Engine User Commands QMOD(1) NAME
qmod - modify a Sun Grid Engine queue and running job 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 Sun 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 but only from administrative hosts. Find additional information concerning wc_queue_list and wc_job_list in sge_types(1). OPTIONS
-c Note: Deprecated, may be removed in future release. Please use the -cj or -cq switch instead. Clears the error state of the specified jobs(s)/queue(s). -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 sge_execd(8) controlling the queues/jobs cannot be reached. Requires manager/operator privileges. -help Prints a listing of all options. -r Note: Deprecated, may be removed in future release. Please use the -rj or -rq switch 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 qsub(1) man page and the rerun option in the queue_conf(5) man page for more informa- tion.) 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 Note: Deprecated, may be removed in future release. Please use the -sj or -sq switch instead. If applied to queues, suspends the queues and any jobs which might be active. If applied to running jobs, suspends the jobs. -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 Note: Deprecated, may be removed in future release. Please use the -usj or -usq switch instead. If applied to queues, unsuspends the queues and any jobs which might be active. If applied to jobs, unsuspends the jobs. -usj If applied to jobs, unsuspends the jobs. If a job is both suspended explicitly and via suspension of its queue, a following unsus- pend 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
SGE_ROOT Specifies the location of the Sun Grid Engine standard configuration files. SGE_CELL If set, specifies the default Sun Grid Engine cell. To address a Sun Grid Engine cell qmod uses (in the order of prece- dence): The name of the cell specified in the environment variable SGE_CELL, if it is set. The name of the default cell, i.e. default. SGE_DEBUG_LEVEL If set, specifies that debug information should be written to stderr. In addition the level of detail in which debug infor- mation is generated is defined. SGE_QMASTER_PORT If set, specifies the tcp port on which sge_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
<sge_root>/<cell>/common/act_qmaster Sun Grid Engine master host file SEE ALSO
sge_intro(1), sge_ckpt(1), qstat(1), queue_conf(5), sge_execd(8), sge_types(1). COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions. SGE 6.2u5 $Date$ QMOD(1)
