---
name: "qmod"
section: "1"
platform: "linux"
package: "gridengine-client"
version: "8.1.9+dfsg-13.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/qmod"
---

# qmod(1)

modify a Grid Engine queue and running job

## 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 *queue\_conf*(5) for details) of a workstation to modify the state of Grid Engine queues for their machine as well as the state of their 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*(5)](/sge_types/5.md).

## OPTIONS

- **-c**

  - **--clear**

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

  - **--clearjob**

  Clears the error state of the specified jobs(s).

- **-cq**

  - **--clearqueue**

  Clears the error state of the specified queue(s).

- **-d**

  - **--disable**

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

  - **--enable**

  Enables the queue(s).

- **-f**

  - **--force**

  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 on the jobs. In any case, the queue or job status will be set, even if the [*sge\_execd*(8)](/sge_execd/8.md) controlling the queues/jobs cannot be reached. Requires manager/operator privileges.

- **-help**

  - **--help**

  Prints a listing of all options.

- **-r**

  - **--reschedule**

  **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)](/qsub/1.md) 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)](/sge_conf/5.md) man page for details).

- **-rj**

  - **--reschedulejob**

  If applied to running jobs, reschedules the jobs. Requires root or  manager privileges.

- **-rq**

  - **--reschedulequeue**

  Reschedules all jobs currently running in the specified queues. Requires root or manager privileges.

- **-s**

  - **--suspend**

  **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 in them. If applied to running jobs, suspends the jobs.

- **-sj**

  - **--suspendjob**

  If applied to running jobs, suspends the jobs. If a job is both suspended explicitly and via suspension of its queue, a subsequent unsuspend of the queue will not release the suspension state on the job.

- **-sq**

  - **--suspendqueue**

  Suspends the specified queues and any jobs which might be active in them.

- **-us**

  - **--unsuspend**

  **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 in them. If applied to jobs, unsuspends the jobs.

- **-usj**

  - **--unsuspendjob**

  Unsuspends the specified jobs. If a job is both suspended explicitly and via suspension of its queue, a subsequent unsuspend of the queue will not release the suspension state on the job.

- **-usq**

  - **--unsuspendqueue**

  Unsuspends the specified queues and any jobs which might be active in them.

## ENVIRONMENT VARIABLES

- **SGE\_ROOT**

  Specifies the location of the Grid Engine standard configuration files.

- **SGE\_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 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)](/sge_qmaster/8.md) 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
	Grid Engine master host file
```

## SEE ALSO

[*sge\_intro*(1)](/sge_intro/1.md), [*sge\_ckpt*(1)](/sge_ckpt/1.md), [*qstat*(1)](/qstat/1.md), *queue\_conf*(5), [*sge\_execd*(8)](/sge_execd/8.md), [*sge\_types*(1)](/sge_types/1.md).

## COPYRIGHT

See [*sge\_intro*(1)](/sge_intro/1.md) for a full statement of rights and permissions.