qdel

(delete job)

Z.148.50 Synopsis

qdel [{-a <asynchronous delete>|-b <secs>|-m <message>|-p <purge>|-t <array_range>|-W <delay>}]
<JOBID>[ <JOBID>]... | 'all' | 'ALL'

Z.148.51 Description

The qdel command deletes jobs in the order in which their job identifiers are presented to the command. A job is deleted by sending a Delete Job batch request to the batch server that owns the job. A job that has been deleted is no longer subject to management by batch services.

A batch job may be deleted by its owner, the batch operator, or the batch administrator.

A batch job being deleted by a server will be sent a SIGTERM signal following by a SIGKILL signal. The time delay between the two signals is an attribute of the execution queue from which the job was run (set table by the administrator). This delay may be overridden by the -W option.

See the PBS ERS section 3.1.3.3, "Delete Job Request", for more information.

Z.148.52 Options

Option	Name	Description
-a	asynchronous delete	Performs an asynchronous delete. The server responds to the user before contacting the MOM. The option qdel -a all performs qdel all due to restrictions from being single-threaded.
-b	seconds	Defines the maximum number of seconds qdel will block attempting to contact pbs_server. If pbs_server is down, or for a variety of communication failures, qdel will continually retry connecting to pbs_server for job submission. This value overrides the CLIENTRETRY parameter in torque.cfg. This is a non-portable Torque extension. Portability-minded users can use the PBS_CLIENTRETRY environmental variable. A negative value is interpreted as infinity. The default is 0.
-p	purge	Forcibly purges the job from the server. This should only be used if a running job will not exit because its allocated nodes are unreachable. The admin should make every attempt at resolving the problem on the nodes. If a job's mother superior recovers after purging the job, any epilogue scripts may still run. This option is only available to a batch operator or the batch administrator.
-t	array_range	The array_range argument is an integer id or a range of integers. Multiple ids or id ranges can be combined in a comma delimited list (examples: -t 1-100 or -t 1,10,50-100). The command acts on the array (or specified range of the array) just as it would on an individual job. When deleting a range of jobs, you must include the subscript notation after the job ID (for example, "qdel -t 1-3 98432[]").
-m	message	Specify a comment to be included in the email. The argument message specifies the comment to send. This option is only available to a batch operator or the batch administrator.
-W	delay	Specifies the wait delay between the sending of the SIGTERM and SIGKILL signals. The argument is the length of time in seconds of the delay.

Z.148.53 Operands

The qdel command accepts one or more job_identifier operands of the form:

sequence_number[.server_name][@server]

all

Z.148.54 Examples

# Delete a job array
$ qdel 1234[]

# Delete one job from an array

$ qdel 1234[1]

# Delete all jobs, including job arrays
$ qdel all

# Delete selected jobs from an array

$ qdel -t 2-4,6,8-10 64[]

There is not an option that allows you to delete all job arrays without deleting jobs.

Z.148.55 Standard error

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

Z.148.56 Exit status

Upon successful processing of all the operands presented to the qdel command, the exit status will be a value of zero.

If the qdel command fails to process any operand, the command exits with a value greater than zero.