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)