SLURM Reference Manual
Delimit all SQUEUE options with spaces (blanks),
but delimit items in option-argument lists with
commas unless otherwise noted
(-o requires space-delimited arguments, for example).
Enclose all argument lists in quotes (") for greater reliability.
This section lists SQUEUE's control options alphabetically except for
-o, which gets a separate subsection at the end because of its elaborate
- -? (--help)
- displays a brief SQUEUE options summary,
one line per option, giving both the single-character and Linux-syntax
versions of each option along with a very short note on its role
(but no argument details).
The -? version fails on some machines, so prefer --help.
- -h (lowercase, --noheader)
- omits the explanatory heads from SQUEUE's
tabular output (for easier reuse of the text).
- -i sec
- repeatedly gathers and reports the status
information (as specified by other options) every
Use CTRL-C to stop this iterated display.
- -j jlist
- limits the SQUEUE report to only the jobs specified in
jlist, a comma-delimited list of numerical SRUN job IDs
(for example, --jobs="1235,1237,1239").
The default report covers all current jobs.
You cannot change the order in which SQUEUE reports on jobs by using
this option (instead, use -S or --sort).
- -l (lowercase ell, --long)
- adds to SQUEUE's default report another column
(TIMELIMIT, which may contain numerical values or the strings
NOT_SET or UNLIMITED) and uses full words (such as RUNNING)
rather than abbreviations
(such as R, see later section)
to report job states.
(Compare with -v, --verbose below.)
- -p plist
- limits SQUEUE's report to jobs in the partitions specified
a comma-delimited list of partition names (such as "debug" or "pbatch").
- -s slist
- limits the SQUEUE report to only the steps specified in
slist, a comma-delimited list of numerical SRUN job-step IDs
(for example, --steps="6543.1,6555.3").
The default report covers all current job steps.
SQUEUE does not support job steps on BlueGene/L.
- -S sortkeys
- sorts the (job) rows in SQUEUE's report using the
sort keys specified in sortkeys,
a comma-delimited list of the same field (column) specifiers used for
and explained in the -o (--format) option below.
The default order is ascending; prefix each field specifier with
minus (-) for descending order.
The default sort for jobs is --sort="P,t,-p" (increasing partition names,
then increasing job states, then decreasing job priority).
The default sort for job steps is --sort="P,i" (increasing partition
names, then increasing job-step IDs).
SQUEUE does not support job steps on BlueGene/L.
- -t statelist
- limits SQUEUE's report to jobs with the specified states
(statuses), where statelist
is a comma-delimited list with these possible members:
ALL, PENDING, RUNNING, COMPLETE.
The default report includes only PENDING and RUNNING jobs.
See the Job States section below
for an explanatory list of all SQUEUE job-state codes.
- -u ulist
- limits SQUEUE's report to jobs belonging to the users
specified in ulist,
a comma-delimited list of user names on the system where you run SQUEUE.
- -v (lowercase, --verbose)
- prefixes the job report (table) that SQUEUE
would otherwise generate (based on the other control options that
you invoked) with a list of 12 report-control features and the current
setting for each (for example, the limits that you have currently
imposed on states, users, or output format).
The job report itself is not changed (compare with -l, --long).
- -V (uppercase, --version)
- displays SQUEUE's current version number
and ends (with no job report).
- -o formatspec
- specifies both the content of SQUEUE's report
(which job properties to include as report columns) and the layout
(the left-to-right order of those columns, the size of each column in
characters, and whether the data is left- or right-justified within
Here formatspec is a quoted,
space (not comma) delimited list of "field specifications," one for
each column that you want SQUEUE to report, and each with this syntax:
- is the [required] field specification
flag, marking the start
of each column's separate specification.
- requests right justification
of this column's data (the default omits the dot and uses left
justification of the reported data).
- is an integer specifying the
width of this column
(omitting w uses
just as much space as the data requires, which usually means that there
is no column alignment from one row (=job) to the next).
- is a single case-sensitive letter that specifies the content
(the job property)
reported in this column (using the dictionary given below).
For example, %.8j uses a right-justified (.) column 8 characters wide
to report job name (lowercase j).
The default column specifications for noncustomized SQUEUE job reports
-o "%.7i %.9P %.8j %.8u %.2t %.9M %.6D %N"
See the SQUEUE example
section below for a sample default report and a sample column-customized
report built using the -o option.
Available one-letter case-sensitive content specifiers
(Z) for use in
%.wZ field specifications
are (in alphabetical order):
b time when this job started executing
c minimum number of CPUs requested
C (uppercase) actual number of CPUs allocated
d minimum temp disk space (in Mbyte) requested
D (uppercase) minimum number of nodes requested (if pending),
or, actual number of nodes allocated (if running)
e time when job ended (or is predicted to end)
f node features required by this job
h (yes/no) allocated nodes can be shared with other jobs?
i job ID or job-step ID (numeric)
j job name (alphanumeric)
l time limit (days:hours:minutes:seconds)
or NOT_SET yet, or UNLIMITED
m minimum requested memory size (in Mbyte)
M (uppercase) time used (days:hours:minutes:seconds)
n list of requested node names
N (uppercase) list of allocated node names
o minimum number of nodes requested
O (uppercase) (yes/no) are contiguous nodes requested?
p job priority (0.0 .GE. p .LE. 1.0)
P (uppercase) job partition
S (uppercase) job start time
t job state (abbreviated, see later section)
T (uppercase) job state (spelled out)
u user name (alphanumeric)
U (uppercase) user ID (numeric)
Navigation Links: [
Document List ] [
HPC Home ]