qhold(1)
qhold - hold NQS request(s).
SYNOPSIS
qhold [ -u username ] [ -v ] request-id ...
DESCRIPTION
Qhold holds all queued or waiting NQS requests whose
respective request-id is listed on the command line. Qhold
will not hold a running NQS request.
To hold 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 hold
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 comprising the NPSN. A request-id is always 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 always
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(1) command.
The -v switch will print out the current version of qhold.
BUGS
One cannot hold a job on a remote machine.
SEE ALSO
qdel(1), qrls(1), qstat(1).
qmgr(1M) in the NPSN UNIX System Administrator Reference
Manual.
NPSN HISTORY
Origin: CERN
January 1992 - Christian Boissat, CERN
August 1994 - John Roman, Monsanto Company
Release 3.36