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.

SGE 6.2u5                                            $Date$                                              QDEL(1)