focal (1) qdel.1.gz

Provided by: gridengine-client_8.1.9+dfsg-9build2_amd64 bug

NAME

       qdel - delete 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. 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
       sge_types(5).

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 who are neither 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, the behavior for administrative and non-administrative users differs. Jobs
              are deleted from the Grid Engine 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 sge_conf(5)).

       -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

       SGE_ROOT       Specifies the location of the Grid Engine standard configuration files.

       SGE_CELL       If  set,  specifies  the default Grid Engine cell. To address a 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
                       Grid Engine master host file

SEE ALSO

       sge_intro(1), qstat(1), qsub(1), sge_qmaster(8), sge_execd(8).

       See sge_intro(1) for a full statement of rights and permissions.