NAME
qdel - Delete or signal NQS batch requests.
SYNOPSIS
qdel [-k ] [ -signo ] [ -h hostname ] [ -u username ]
request-id . . .
DESCRIPTION OF PARAMETERS
-k Send the SIGKILL signal to the request.
-signo Send a specified signal to the identified running
request.
-h hostname
Delete or signal requests on hostname.
-u username
Delete or signal requests owned by username.
request-id
The unique identity of a request in the NQS
system.
DISCUSSION
qdel deletes all queued NQS requests whose respective
request-id is listed on the command line. Additionally, if
the flag -k is specified, then the default signal of SIGKILL
(-9) is sent to any running request whose request-id is
listed on the command line. This will cause the receiving
request to exit and be deleted. If the flag -h hostname is
requested then the action will be taken on the given host.
If the flag -signo is present, then the specified signal is
sent instead of the SIGKILL signal to any running request
whose request-id is listed on the command line. Signals
applicable for the OSF/1 kill command are also applicable
for the -signo flag. In the absence of the -k and -signo
flags, qdel will not delete a running NQS request.
To delete or signal an NQS request, the invoking user must
be the owner; namely the submitter of the request. The only
exception to this rule occurs when the invoking user is the
superuser, or has NQS operator privileges as defined in the
NQS manager database. Under these conditions, the invoker
may specify the -u username flag which allows the invoker to
delete or signal requests owned by the user whose account
name is username. When this form of the command is used, all
request-ids listed on the command line are presumed to refer
to requests owned by the specified user.
An NQS request is always uniquely identified by its
request-id, no matter where it is in the network of the
machines. A request-id is of the form: seqno or
seqno.hostname where hostname identifies the machine from
whence the request was originally submitted, and seqno
identifies the sequence number assigned to the request on
the originating host. If the hostname portion of a
request-id is omitted, then the local host is assumed.
The request-id of any NQS request is displayed when the
request is first submitted (unless the silent mode of
operation for the given NQS command was specified). The user
can also obtain the request-id of any request through the
use of the qstat command.
CAVEATS
When an NQS request is signalled by the methods discussed
above, the proper signal is sent to all processes comprising
the NQS request that are in the same process group. Whenever
an NQS request is spawned, a new process group is
established for all processes in the request. However,
should one or more processes of the request successfully
execute a setpgrp() system call, then such processes will
not receive any signals sent by the qdel command. This can
lead to ``rogue'' request processes which must be killed by
other means such as the kill command.
SEE ALSO
qcmplx, qdev, qlimit, qmgr, qpr, qstat, qsub, kill,
setpgrp(), signal()
Acknowledgement and Disclaimer