qdel.1

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).

COPYRIGHT

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



SGE 8.1.3pre                      2011-05-17                           QDEL(1)