Louhi User's Guide, the 2nd Edition > Batch jobs and the batch system > Commands > Status of jobs, queues and batch server: qstat
Tehdyt toimenpiteet

Status of jobs, queues and batch server: qstat

The qstat command displayes the status of jobs, queues, or a batch server.

Options of qstat

The following table show few options of the qstat command. You can also use the job identifiers and destinations (queues, servers or a queue on a server) as the last part of the command to restrict information displayed, but these are not shown here. For complete desription see the manual page qstat(1B).

Option Description
(no options) Displays all jobs
-f Displays full status of jobs
-a Displays all jobs in alternative format
-i Displays jobs (non-running mainly) in alternative format
-r Displays jobs (mainly running and suspended)
-n In addition to the basic information, nodes  allocated  to  a  job  are  listed
-u user(s) Displays jobs of a user or users
-Q Status  of queues
-Q -f Full status of queues (configuration also)
-q Status of queues in the alternative format
-B Batch server status
-B -f Full batch server status (configuration also)

Job identifiers, queue names, PBS server names or named queues on named servers can be given as additional operands for these options. These restrict displayed information only to these items. For more information about these operands and the qstat command see the manual page qstat(1B).

Job status

Job status is displayed by the command qstat without options, or in an alternative format by using, e.g,. the options -a, -i, -r, -n and -u without  -f.

When option -f is included, full job status, i.e., attributes including requested and used (if job is running) resources, is displayed.

Queue status

Queue status is displayed by options -q and -Q. Full queue status, i.e., queue attributes including resources (minimum and maximum limits and defaults), is displayed with options -Q -f.

Server status

Server status is displayed by the option  -B.

Full server status, i.e., server attributes including resources (limits and defaults), is shown by options -B -f.

Examples

Examples of qstat commands and what they display are given in Section Monitoring and displaying job and system status.