qmod

Command qmod enables users classified as owners (see queue_conf(5) for details) to modify the state of Grid Engine queues for his/her machine as well as the state of his/her own jobs. This command send a signal to a running job :

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).

To disable queue use qmod -d Q. To enable back the queue, you can use qmod -e Q.

For more information in using SGE, please refer to the SGE documentation and the man pages.

General syntax

Options

Environmental Variables

The name of the cell specified in the environment variable GE_CELL, if it is set.

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

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
              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     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

       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 precedence):

                             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 information 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

COPYRIGHT

       See sge_intro(1) for a full statement of rights and permissions.

Etc

The Last but not Least Technology is dominated by two types of people: those who understand what they do not manage and those who manage what they do not understand ~Archibald Putt. Ph.D

The statements, views and opinions presented on this web page are those of the author (or referenced source) and are not endorsed by, nor do they necessarily reflect, the opinions of the Softpanorama society. We do not warrant the correctness of the information provided or its fitness for any purpose. The site uses AdSense so you need to be aware of Google privacy policy. You you do not want to be tracked by Google please disable Javascript for this site. This site is perfectly usable without Javascript.

Softpanorama May the source be with you, but remember the KISS principle ;-)	Home	Switchboard	Unix Administration	Red Hat	TCP/IP Networks	Neoliberalism	Toxic Managers
	(slightly skeptical) Educational society promoting "Back to basics" movement against IT overcomplexity and bastardization of classic Unix

News	SGE Commands	SGE Jobs	Monitoring and Controlling Jobs	Monitoring Queues	Queue states	Why Won't My Jobs Run ?
qstat	qdel	qalter -- Change Job Priority	Starting and Killing Daemons	qsub -- Submitting Jobs To Queue Instance		Creating and modifying SGE Queues
SGE cheat sheet	Creating and modifying SGE Queues	Monitoring Queues and Jobs	Submitting Jobs To Queue Instanc	Monitoring and Controlling Jobs	Humor	Etc

qmod -- modify a Grid Engine queue and running job

General syntax

Options

Environmental Variables

Files

Recommended Links

Google matched content

Softpanorama Recommended

Top articles

Sites

Top articles

Sites

Man pages

Google matched content

Softpanorama Recommended

Top articles

Sites

Reference

NAME

SYNTAX

DESCRIPTION

OPTIONS

ENVIRONMENTAL VARIABLES

FILES

SEE ALSO

COPYRIGHT

Etc