SLURM Reference Manual for HP XC System Software
Table Of Contents
- Preface
- Introduction
- SLURM Goals and Roles
- SLURM Features
- SLURM Operation
- SLURM Utilities
- SRUN (Submit Jobs)
- SQUEUE (List Jobs)
- SINFO (List Nodes)
- SMAP (Show Job Geometry)
- SCONTROL (Manage Configurations)
- Disclaimer
- Keyword Index
- Alphabetical List of Keywords
- Date and Revisions
SQUEUE Options
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 format-specification language.
CONTROL OPTIONS.
-? (--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 (lowercase, --iterate=sec)
repeatedly gathers and reports the status information (as specified by other options)
every sec seconds. Use CTRL-C to stop this iterated display.
-j jlist (lowercase, --jobs=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 (page 52)) to
report job states. (Compare with -v, --verbose below.)
-p plist (lowercase, --partition=plist)
limits SQUEUE's report to jobs in the partitions specified by plist, a comma-delimited
list of partition names (such as "debug" or "pbatch").
-s slist (lowercase, --steps=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.
SLURM Reference Manual - 47