qdel(1)
NAME
qdel – delete xxQS_NAMExx 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
OPTIONS
-f- Force deletion of job(s). The job(s) are deleted from the list of jobs registered at even if the controlling the job(s) does not respond to the delete request sent by
-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.
Users who are neither xxQS_NAMExx 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 However, the behavior for administrative and non-administrative users differs. Jobs are deleted from the xxQS_NAMExx 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
ENVIRONMENT VARIABLES
xxQS_NAME_Sxx_ROOT- Specifies the location of the xxQS_NAMExx standard configuration files.
xxQS_NAME_Sxx_CELL- If set, specifies the default xxQS_NAMExx cell. To address a xxQS_NAMExx cell qdel uses (in the order of precedence):
- The name of the cell specified in the environment variable xxQS_NAME_Sxx_CELL, if it is set.
xxQS_NAME_Sxx_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.
xxQS_NAME_Sxx_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.
The name of the default cell, i.e. default.
FILES
<xxqs_name_sxx_root>/<cell>/common/act_qmaster
xxQS_NAMExx master host file
SEE ALSO
COPYRIGHT
See for a full statement of rights and permissions.