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.