ICC Home Privacy and Legal Notice LC User Documents Banner

UCRL-WEB-201386

SLURM Reference Manual


SQUEUE (List Jobs)

Links to subtopics in this section:
  • SQUEUE Execute Line

  • SQUEUE Options

  • SQUEUE Examples

  • SQUEUE Job State Codes


  • Navigation Links: [ Document List ] [ HPC Home ] [ Previous ]

    No content in this section. Showing first subtopic...

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

    BASIC RUN.
    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.

    COLUMNS.
    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
         partition
         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.

    ROWS.
    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
         priority
         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 ]