ICC Home Privacy and Legal Notice LC User Documents Banner


SLURM Reference Manual

SQUEUE Execute Line

SQUEUE displays the job ID and job name for every job currently managed by the SLURM control daemon (SLURMCTLD) on the machine where you run SQUEUE, along with status and resource information for each job (such as time used so far, or a list of committed nodes), in a table whose content and format details you can control with SQUEUE options. (To report on node status rather than job status, use SINFO instead.)

To run SQUEUE (on any machine with SLURM installed), type

squeue [opts]

where opts is a blank-delimited list of SQUEUE output-control options and their (comma-delimited) arguments.

If run without options, SQUEUE reports by default on these job properties (in this order in columns left to right) and then ends:

     job ID
     job name
     user name
     status (state) of job [for codes, see later section]
     time used so far (hours:minutes:seconds)
     total nodes (allocated or used)
     node list (specific node names)

See the first example below for typical default SQUEUE output. You can change the properties reported (and the order of the output columns) by using SQUEUE's -o (lowercase oh, --format) option.

Each row in the SQUEUE report describes one job (or, if you request, one job step; but job steps are not supported on BlueGene/L). SQUEUE sorts the rows (alphabetically, or in decreasing magnitude) using this ranked list of job properties:

     partition name
     status (state) of job
     time used so far

You can change the sort order (to more closely match PSUB by relying on job ID or job name, for example) by using SQUEUE's -S (uppercase ess, --sort) option.

Navigation Links: [ Document List ] [ HPC Home ] [ Next ]