NAME
	  qstat	- Displays the status of NQS requests and queues.

     SYNOPSIS
	  qstat	[ -a | -U ] [ -b ] [ -d	] [ -f | -l ] [	-h hostname ]
	  [ -n ]  [ -p ] [ -s state ]
	  [ -t n_days queue ] [	-u user	] [ queue ... ]	[ queue@host
	  ... ]	[ -v ]

     DESCRIPTION OF PARAMETERS
	  -a	    Displays the status	of requests belonging to all
		    users.

	  -b	    Displays batch queues.

	  -d	    Displays device queues.

	  -f	    Shows queues or requests in	a full format, that
		    is,	multiple lines for each	request	or queue. The
		    default listing shows one line for each request or
		    queue.

	  -h host-name
		    Displays requests for queues on the	host-name
		    host.

	  -l	    Same as -f.

	  -n	    The	queue header and trailer are not displayed.

	  -p	    Displays pipe queues.

	  -s state  Displays only those	requests with the specified
		    state.
		    Allowable states are:

		      r		  Running

		      h		  Holding

		      q		  Queued

		      t		  Exiting

	  -t n_days queue
		    (Currently unused.)	Displays the tennis court
		    schedule for a dedicated request up	to 7 days in
		    advance. The n_day is an integer from 0 to 6,
		    where 0 is the current day.	If a 0 is specified,
		    the	available time slot will be listed. If an
		    integer n from 1 to	6 is specified,	the available
		    time slots for the day which is n days in advance
		    of the current day will be listed.

	  -u user   Shows only those requests belonging	to the
		    specified user. By default,	qstat shows requests
		    belonging to the invoking user.

	  -U	    Same as -a.

	  -v	    Displays output in 132-column format, and adds a
		    NODES field	(number	of nodes associated with a
		    request) and a SUBMITTED AT	field (date and	time
		    the	request	was submitted) to the standard
		    display.

	  queue	...
		    The	name of	a queue	for which the status is	being
		    requested. The local host is assumed if it is not
		    indicated with the @host specifier.

	  queue@host ...
		    The	name of	a queue	for which the status is	being
		    requested. The host	named host is indicated.

     DISCUSSION
	  The qstat command displays the status	of NQS requests	and
	  queues. In the absence of -a,	-u, or -U, qstat shows only
	  requests and queues belonging	to the user who	executes it.

	  If no	options	are specified, NQS displays the	current	state
	  of each NQS request on the local host. Otherwise, the	type
	  of information displayed is determined by the	invocation
	  flag used.

	  qstat	displays information about each	selected queue.	The
	  flags	can be used to display particular types	of
	  information.

	  If information about the queues is requested with the	-b,
	  -d, or -p flags, 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 specified	in order for qstat to
	  work.	Also, root use of qstat	is limited to the local
	  machine.

	  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 started.

	  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
	  The -s flag currently	gives incorrect	results.

     SEE ALSO
	  qcmplx, qdel,	qdev, qlimit, qmgr, qpr, qsub