qmod

Langue: en

Version: $Date: 2009/05/11 12:23:44 $ (fedora - 01/12/10)

Section: 1 (Commandes utilisateur)

NAME

qmod - modify a Grid Engine queue and running job

SYNTAX

qmod [ options ] [ wc_job_range_list | wc_queue_list ]

DESCRIPTION

Qmod enables users classified as owners (see 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 but only from administrative hosts. Find additional information concerning wc_queue_list and wc_job_list in

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 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 man page and the rerun option in the man page for more information.) Additional restrictions apply for parallel and checkpointing jobs. (See the reschedule_unknown description in the 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 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 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

See for a full statement of rights and permissions.