qdel (1) - Linux Manuals

qdel: delete xxQS_NAMExx jobs from queues

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

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

-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

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.

The name of the default cell, i.e. default.

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.

FILES

<xxqs_name_sxx_root>/<cell>/common/act_qmaster
                          xxQS_NAMExx master host file

COPYRIGHT

See for a full statement of rights and permissions.