1qdel(1B) PBS qdel(1B)
2
6 qdel - delete pbs batch job
7
9 qdel [-a] [-c] [-m message] [-p] [-t array_range] [-W delay] [-b secs]
10 job_identifier...
11
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 A batch job may be deleted by its owner, the batch operator, or the
20 batch administrator.
21 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 See the PBS ERS section 3.1.3.3, "Delete Job Request", for more infor‐
29 mation.
30
32 -W delay Specify the delay between the sending of the SIGTERM and
33 SIGKILL signals. The argument delay specifies a un‐
34 signed integer number of seconds.
35 -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 -b seconds Defines the maximum number of seconds qsub will block
41 attempting to contact pbs_server. If pbs_server is
42 down, or for a variety of communication failures, qsub
43 will continually retry connecting to pbs_server for job
44 submission. This value overrides the CLIENTRETRY param‐
45 eter in torque.cfg. This is a non-portable TORQUE ex‐
46 tension. Portability-minded users can use the
47 PBS_CLIENTRETRY environmental variable. A negative
48 value is interpreted as infinity. The default is 0.
49 -c Clean up unreported jobs from the server. This should
51 only be used if the scheduler is unable to purge unre‐
52 ported jobs. This option is only available to a batch
53 operator or the batch administrator.
54 -p Forcibly purge the job from the server. This should
56 only be used if a running job will not exit because its
57 allocated nodes are unreachable. The admin should make
58 every attempt at resolving the problem on the nodes. If
59 a job's mother superior recovers after purging the job,
60 any epilogue scripts may still run. This option is only
61 available to a batch operator or the batch administra‐
62 tor.
63 -m message Specify a comment to be included in the email. The ar‐
65 gument message specifies the comment to send. This op‐
66 tion is only available to a batch operator or the batch
67 administrator.
68 -t array_range The array_range argument is an integer id or a range of
70 integers. Multiple ids or id ranges can be combined in a
71 comma delimted list (examples: -t 1-100 or -t
72 1,10,50-100). The command acts on the array (or speci‐
73 fied range of the array) just as it would on an individ‐
74 ual job.
75
77 The qdel command accepts one or more job_identifier operands of the
78 form:
79 sequence_number[.server_name][@server]
80 or
81 'all'
82
84 The qdel command will write a diagnostic messages to standard error for
85 each error occurrence.
86
88 Upon successful processing of all the operands presented to the qdel
89 command, the exit status will be a value of zero.
90 If the qdel command fails to process any operand, the command exits
92 with a value greater than zero.
93
95 qsub(1B), qsig(1B), and pbs_deljob(3B)
96Local qdel(1B)