---
name: "qdel"
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/qdel"
---

# qdel(1)

delete Grid Engine jobs from queues

## NAME

qdel - delete Grid Engine jobs from queues

## SYNTAX

**qdel** \[**-f**\] \[**-help**\] \[**-u** *wc\_user\_list*\] \[*wc\_job\_range\_list*\] \[**-t** *task\_id\_range*\]

## DESCRIPTION

*Qdel* provides a means for a user/operator/manager to delete one or more jobs. A manager/operator can delete jobs belonging to any user, while a regular user can only delete his or her own jobs. If a manager wants to delete another user's job, the manager can specify the job id. A manager using a job name or pattern must also specify the user's name via "-u wc\_user\_list". A  "qdel wc\_job\_name" will delete only the jobs of the  calling user by default. *Qdel* deletes jobs in the order in which their job  identifiers are presented. Find additional information concerning *wc\_user\_list* and *wc\_job\_list* in [*sge\_types*(5)](/sge_types/5.md).

## OPTIONS

- **-f**

  Force deletion of job(s). The job(s) are deleted from the list of jobs registered at [*sge\_qmaster*(8)](/sge_qmaster/8.md) even if the [*sge\_execd*(8)](/sge_execd/8.md) controlling the job(s) does not respond to the delete request sent by [*sge\_qmaster*(8)](/sge_qmaster/8.md).

  Users who are neither Grid Engine managers nor operators can only use the **-f** option (for their own jobs) if the cluster configuration entry **qmaster\_params** contains the flag ENABLE\_FORCED\_QDEL (see [*sge\_conf*(5)](/sge_conf/5.md)). However, the behavior for administrative and non-administrative users differs. Jobs are deleted from the Grid Engine database immediately in the case of administrators. Otherwise, a regular deletion is attempted first and a forced cancellation is only executed if the regular deletion was unsuccessful.

  Additionally, regular qdel requests can result in a forced deletion of a job if **ENABLE\_FORCED\_QDEL\_IF\_UNKNOWN** is set in the **qmaster\_params** (see  [*sge\_conf*(5)](/sge_conf/5.md)).

- **-help**

  Prints a listing of all options.

- **-t**

  Deletes specified tasks of an array job. It means tasks created by the *qsub -t* command. For example, after creating an array job with the command "qsub -t 1-100 $SGE\_ROOT/examples/sleeper.sh" it is possible to delete tasks 5-10 from the job array with the command "qdel job\_id -t 5-10". All other tasks (1-4 and 11-100) will be executed.

- **-u wc\_user\_list**

  Deletes only those jobs which were submitted by users specified in the list of usernames. For managers it is possible to use **qdel -u "\*"** to delete all jobs of all users. If a manager wants to delete a specific job of a user, he has to specify the user and the job. If no  job is specified, all jobs from that user are deleted.

- **wc\_job\_range\_list**

  A list of jobs which should be deleted.

## 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 *qdel* 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), [*qstat*(1)](/qstat/1.md), [*qsub*(1)](/qsub/1.md), [*sge\_qmaster*(8)](/sge_qmaster/8.md), [*sge\_execd*(8)](/sge_execd/8.md).

## COPYRIGHT

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