QSTATC(1)

NAME
qstatc - display status of NQS requests and queues.

SYNOPSIS
qstatc [-a] [-U] [-b] [-d] [-p] [-f] [-l] [-n] [-s state -rqht-] [-h host-name ] [-u user-name ] [-T user-target-name ]
[ queue-name ... ] [ queue-name@host-name ... ]

DESCRIPTION
Qstatc displays the status of Network Queueing System (NQS) requests and queues.

If no objects are specified, then the current state of each NQS request on the local host is displayed. Otherwise, information is displayed for the specified object only. Each entry displays information about a given request. Ordinarily, qstatc shows only those requests belonging to the invoker.

If information about the queues is requested with the -b, -d or -p options, but no queues are specified, then the current state of each NQS queue on the local host is displayed. Otherwise, information is displayed for the specified queues only. Queues may be specified either as queue-name or queue-name@host-name. In the absence of a host-name specifier, the local host is assumed. You must have an account on the host specfied in order for qstatc to work. Also, root use of qstatc is limited to the local machine.

For each selected queue, qstatc displays information about the queue itself. The following flags are available:

-a  Displays all requests. The -U (unrestricted) option is synonymous.

-b  Displays batch queues.

-d  Displays device queues.

-p  Displays pipe queues.

-f  Queues are shown in a full format. The -l (long) option displays in the same format.

-n  The queue header and trailer are not displayed.

-u user-name
    Shows only those requests belonging to user-name.

When a queue is being examined, the queue name, host machine, priority, number of requests in a given state, resource limits, and access are displayed.

QUEUE STATE
The general state of a queue is defined by two principal properties of the queue.

The first property determines whether or not requests can be submitted to the queue. If they can, then the queue is said to be enabled. Otherwise the queue is said to be disabled.

The second principal property of a queue determines if requests which are ready to run, but are not now presently running, will be allowed to run upon the completion of any currently running requests, and whether any requests are presently running in the queue.

If queued requests not already running are blocked from running, and no requests are presently executing in the queue, then the queue is said to be stopped. If the same situation exists with the difference that at least one request is running, then the queue is said to be stopping, where the requests presently executing will be allowed to complete execution, but no new requests will be spawned. One of the words AVAILABLE, STOPPED, DISABLED, UNAVAIL, or NQS DOWN will appear in the queue status field to indicate the respective queue states of:

AVAILABLE= enabled and started,
STOPPED = enabled and stopped,
DISABLED = disabled and running or
UNAVAIL = disabled and stopped.

Requests can only be submitted to the queue if the queue is enabled, and the local NQS daemon is present.

If the NQS daemon for the local host upon which the queue resides is not running, the status displays NQS DOWN.

CAVEATS
This is the version of Qstat that was supplied with Cosmic NQS Version 2.

NQS is not finished, and continues to undergo development. Some of the request states shown above may or may not be supported in your version of NQS.

SEE ALSO
qcmplx(1), qdel(1), qdev(1), qlimit(1), qpr(1), qsub(1), qmgr(1M)

NPSN HISTORY
Origin: Sterling Software Incorporated

August 1985 - Brent Kingsbury, Sterling Software
Original release.

May 1986
Second release.

Feb. 1990 - Terrie Carver, Computer Sciences Corporation
Third release.