QRLS(1)

NAME
qrls - release NQS request(s).

SYNOPSIS
qrls [ -u username ] [ -v ] request-id ...

DESCRIPTION
Qrls releases all held NQS requests whose respective request-id is listed on the command line.

To release 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 release 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 is used to print the version of qrls.

BUGS
One cannot release a request held on a remote machine.

SEE ALSO
qdel(1), qhold(1), qstat(1).
qmgr(1M) in the NPSN UNIX System Administrator Reference Manual.

NPSN HISTORY
Origin: CERN

January 1992 - Christian Boissat, CERN
Original release.

August 1994 - John Roman, Monsanto Company
Release 3.36