.\" Copyright (C) 1994-2018 Altair Engineering, Inc. .\" For more information, contact Altair at www.altair.com. .\" .\" This file is part of the PBS Professional ("PBS Pro") software. .\" .\" Open Source License Information: .\" .\" PBS Pro is free software. You can redistribute it and/or modify it under the .\" terms of the GNU Affero General Public License as published by the Free .\" Software Foundation, either version 3 of the License, or (at your option) any .\" later version. .\" .\" PBS Pro is distributed in the hope that it will be useful, but WITHOUT ANY .\" WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS .\" FOR A PARTICULAR PURPOSE. .\" See the GNU Affero General Public License for more details. .\" .\" You should have received a copy of the GNU Affero General Public License .\" along with this program. If not, see . .\" .\" Commercial License Information: .\" .\" For a copy of the commercial license terms and conditions, .\" go to: (http://www.pbspro.com/UserArea/agreement.html) .\" or contact the Altair Legal Department. .\" .\" Altair’s dual-license business model allows companies, individuals, and .\" organizations to create proprietary derivative works of PBS Pro and .\" distribute them - whether embedded or bundled with other software - .\" under a commercial license agreement. .\" .\" Use of Altair’s trademarks, including but not limited to "PBS™", .\" "PBS Professional®", and "PBS Pro™" and Altair’s logos is subject to Altair's .\" trademark licensing policies. .\" .TH qdel 1B "30 November 2017" Local "PBS Professional" .SH NAME .B qdel - delete PBS jobs .SH SYNOPSIS .B qdel [ -Wforce | -Wsuppress_email=] [-x] [ ...] .br .B qdel --version .SH DESCRIPTION The .B qdel command deletes jobs in the order given, whether they are at the local server or at a remote server. .B Usage .br The qdel command is used without options to delete queued, running, held, or suspended jobs, while the .I -x option gives it the additional capacity to delete finished or moved jobs. With the .I -x option, this command can be used on finished and moved jobs, in addition to queued, running, held, or suspended jobs. When this command is used without the .I -x option, if job history is enabled, the deleted job's history is retained. The .I -x option is used to additionally remove the history of the job being deleted. If someone other than the job's owner deletes the job, mail is sent to the job's owner, or to a list of mail recipients if specified during .B qsub. See the .B qsub(1B) man page. If the job is in the process of provisioning, it can be deleted only by using the .I -W force option. .B "How Behavior of qdel Command Can Be Affected" .br The server's .I default_qdel_arguments attribute may affect the behavior of the .B qdel command. This attribute is settable by the administrator via the .B qmgr command. The attribute may be set to "-Wsuppress_email=". The server attribute is overridden by command-line arguments. See the .B pbs_server_attributes(1B) man page. .B Sequence of Events .IP " " 3 The job's running processes are killed. .IP The epilogue runs. .IP Files that were staged in are staged out. This includes standard out (.o) and standard error (.e) files. .IP Files that were staged in or out are deleted. .IP The job's temp directory is removed. .IP The job is removed from the MOM(s) and the server. .LP .B Required Privilege .br A PBS job may be deleted by its owner, an Operator, or the administrator. The server deletes a PBS job by sending a .B SIGTERM signal, then, if there are remaining processes, a .B SIGKILL signal. .SH OPTIONS .IP "(no options)" 8 Can delete queued, running, held, or suspended jobs. Does not delete job history for specified job(s). .IP "-W force" 8 Deletes the job whether or not the job's execution host is reachable. Deletes the job whether or not the job is in the process of provisioning. Cannot be used with the .I -Wsuppress_email option. If the server can contact the MoM, this option is ignored; the server allows the job to be deleted normally. If the server cannot contact the MoM or the job is in the .I E state, the server deletes its information about the job. .IP "-Wsuppress_email=" 8 Sets limit on number of emails sent when deleting multiple jobs. .RS 11 If .I N >= 1 and .I N or more .I job IDs are given, .I N emails are sent. .br If .I N >=1 and less than .I N job IDs are given, the number of emails is the same as the number of jobs. .br If .I N = 0, this option is ignored. .br If .I N = -1, no email is sent. .RE .LP .IP " " 8 The .I argument is an integer. Note that there is no space between "W" and "suppress_email". Cannot be used with the .I -Wforce option. .LP .IP "-x" 8 Can delete running, queued, suspended, held, finished, or moved jobs. Deletes job history for specified job(s). .LP .IP "--version" 8 The .B qdel command returns its PBS version information and exits. This option can only be used alone. .SH OPERANDS The .B qdel command accepts one or more space-separated .I job ID operands. These operands can be job identifiers, job array identifiers, subjob dentifiers, or subjob range identifiers. Job IDs have the form: .br .I \ \ \ [.][@] Job arrays have the form: .br .I \ \ \ [][.][@] Subjobs have the form: .br .I \ \ \ [][.][@] Ranges of subjobs have the form: .br .I \ \ \ [-][.][@] Job array identifiers must be enclosed in double quotes for some shells. .SH STANDARD ERROR The .B qdel command writes a diagnostic message to standard error for each error occurrence. .SH EXIT STATUS .IP Zero 8 Upon successful processing of input .IP "Greater than zero" 8 Upon error .SH SEE ALSO The .I PBS Professional User's Guide, the .I PBS Professional Administrator's Guide, .br pbs_queue_attributes(7B), pbs_server_attributes(1B), qsub(1B), qsig(1B), pbs_deljob(3B)