QALTER(1)

NAME
qalter - modify NQS request parameters.

SYNOPSIS
qalter [ -p priority ] [ -u username ] [ -v ] request-id(s)

DESCRIPTION
Qalter modifies the attributes of the NQS requests whose request-ids are listed on the command line. Only queued, waiting, or holding requests may be modified.

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.

To modify the attributes of 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 print the files requests owned by the user whose account name is username.

This utility is part of the P1003.15 Batch Queueing Extensions draft. Other switches will be added as time allows.

OPTIONS

-p priority
    The intra-queue priority of the request is modified to the given value. If the user does not have NQS operator privileges then the priority must be between 1 and 63. If the user does have these privileges, then the priority may be between 1 and 1023.

-u username
    Indicate the owner of the request, if not the invoker.

-v  List the version of qalter.

All other switches will print an indication of the usage of the program.

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

NPSN HISTORY
Origin: Monsanto

August 1994 - John Roman, Monsanto Company
Release 3.36.