Table of Contents

NAME

qstat - Displays the status of one or more lsbatch queues

SYNOPSIS

qstat [ -l ] [ -m ] [ -x] [ -a] [ -u user-name ] [ queue-name ... ]

DESCRIPTION

qstat is an lsNQS version of the NQS command of the same name. It displays the status of lsbatch queues.

If no queue is specified, the current status of all lsbatch queues is displayed. Otherwise, information is displayed for the specified queues only.

For each specified queue, qstat displays a queue header (contains information about the queue itself), followed by information about requests in the queue. Ordinarily, qstat shows only those requests that belong to the invoker.

The queue header always includes the queue-name, queue type, queue status (see below), and the number of requests waiting and running in the queue. An extended queue header also displays the priority and run limit of a queue, as well as the access restrictions and resource limits.

By default, qstat displays the following information about a request: the request-name, the request-id, the owner, and the current request state (see below).

The relative ordering of requests within a queue determines the order in which the requests are run. This is subject to the availability of resources needed by each request, and whether the user interferes with the running order.

OPTIONS

-l
Requests are displayed in a long format, and show more details than the default, short format. qstat -l shows the time at which the request was created, an indication of where mail is sent, the user name on the originating machine, resource limits, planned disposition of stderr, and stdout.
-m
Requests are shown in a medium-length format. At present, this is the same as the long format.
-x
The queue header is shown in an extended format.
-a
Shows all requests belonging to all users.
-u user-name
Shows only those requests belonging to the user username.

queue-name ...
Shows only those requests in the specified queue or queues .

QUEUE STATE

The general state of a queue is defined by whether or not requests can be submitted to the queue. If they can, the queue is said to be enabled. Otherwise the queue is said to be disabled.

REQUEST STATE

The state of a request can be waiting or running,

waiting
The request was submitted with the constraint that it cannot be run before a certain date and time, and that date and time have not yet arrived.
running
The request has been scheduled and is actually executing or is suspended during its execution. The processes of the request can be suspended by a signal sent by qdel(1) from the user.

CAVEATS

The output format of this command is different from qstat in NQS.

SEE ALSO

qsub(1) , qdel(1)

Table of Contents