1qdel(1B)                              PBS                             qdel(1B)
2
3
4

NAME

6       qdel - delete pbs batch job
7

SYNOPSIS

9       qdel  [-a] [-c] [-m message] [-p] [-t array_range] [-W delay] job_iden‐
10       tifier...
11

DESCRIPTION

13       The qdel command deletes jobs in the order in which their  job  identi‐
14       fiers  are  presented  to  the  command.  A job is deleted by sending a
15       Delete Job batch request to the batch server that owns the job.  A  job
16       that  has been deleted is no longer subject to management by batch ser‐
17       vices.
18
19       A batch job may be deleted by its owner, the  batch  operator,  or  the
20       batch administrator.
21
22       A  batch  job  being  deleted by a server will be sent a SIGTERM signal
23       following by a SIGKILL signal.  The time delay between the two  signals
24       is an attribute of the execution queue from which the job was run (set‐
25       table by the administrator).  This delay may be overridden  by  the  -W
26       option.
27
28       See  the PBS ERS section 3.1.3.3, "Delete Job Request", for more infor‐
29       mation.
30

OPTIONS

32       -W delay       Specify the delay between the sending of the SIGTERM and
33                      SIGKILL   signals.    The  argument  delay  specifies  a
34                      unsigned integer number of seconds.
35
36       -a             Request the job(s) be deleted asynchronously, which  for
37                      a  Running  job  means that the reply will return before
38                      the MOM is requested to delete the job.
39
40       -c             Clean up unreported jobs from the server.   This  should
41                      only  be  used if the scheduler is unable to purge unre‐
42                      ported jobs.  This option is only available to  a  batch
43                      operator or the batch administrator.
44
45       -p             Forcibly  purge  the  job  from the server.  This should
46                      only be used if a running job will not exit because  its
47                      allocated  nodes are unreachable.  The admin should make
48                      every attempt at resolving the problem on the nodes.  If
49                      a  job's mother superior recovers after purging the job,
50                      any epilogue scripts may still run.  This option is only
51                      available  to  a batch operator or the batch administra‐
52                      tor.
53
54       -m message     Specify a comment to be  included  in  the  email.   The
55                      argument  message  specifies  the comment to send.  This
56                      option is only available to  a  batch  operator  or  the
57                      batch administrator.
58
59       -t array_range The  array_range argument is an integer id or a range of
60                      integers. Multiple ids or id ranges can be combined in a
61                      comma   delimted   list.   Examples:   -t  1-100  or  -t
62                      1,10,50-100
63
64                      If an array range isn't specified, the command tries  to
65                      operate  on  the  entire  array. The command acts on the
66                      array (or specified range of the array) just as it would
67                      on an individual job.
68

OPERANDS

70       The  qdel  command  accepts  one or more job_identifier operands of the
71       form:
72           sequence_number[.server_name][@server]
73             or
74           'all'
75

STANDARD ERROR

77       The qdel command will write a diagnostic messages to standard error for
78       each error occurrence.
79

EXIT STATUS

81       Upon  successful  processing  of all the operands presented to the qdel
82       command, the exit status will be a value of zero.
83
84       If the qdel command fails to process any  operand,  the  command  exits
85       with a value greater than zero.
86

SEE ALSO

88       qsub(1B), qsig(1B), and pbs_deljob(3B)
89
90
91
92
93Local                                                                 qdel(1B)
Impressum