NAME
qdel - delete Sun 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. If
the manager is using a job name or pattern, he or she 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(1).
OPTIONS
-f Force deletion of job(s). The job(s) are deleted from the list
of jobs registered at sge_qmaster(8) even if the sge_execd(8)
controlling the job(s) does not respond to the delete request
sent by sge_qmaster(8).
Users which are neither Sun 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)). However, behavior for
administrative and non-administrative users differs. Jobs are
deleted from the Sun Grid Engine database immediately in 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))
-help Prints a listing of all options.
-t Deletes specified tasks of array job. It means tasks created by
qsub -t command. For example after creating array job by command
"qsub -t 1-100 $SGE_ROOT/examples/sleeper.sh" it is possible to
delete tasks 5-10 from job array by 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
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 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)
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), qstat(1), qsub(1), sge_qmaster(8), sge_execd(8).
COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions.