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] job_iden‐
10 tifier...
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
34 unsigned 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 -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 -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 -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 -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 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
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
77 The qdel command will write a diagnostic messages to standard error for
78 each error occurrence.
79
81 Upon successful processing of all the operands presented to the qdel
82 command, the exit status will be a value of zero.
83 If the qdel command fails to process any operand, the command exits
85 with a value greater than zero.
86
88 qsub(1B), qsig(1B), and pbs_deljob(3B)
89Local qdel(1B)