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
-S sortkeys (uppercase, --sort=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 (lowercase, --states=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 (page 52) section below for an explanatory list of all SQUEUE job-state
codes.
-u ulist (lowercase, --users=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).
OUTPUT-FORMAT OPTION.
-o formatspec (lowercase, --format=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 each
column). 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: %.wZ
% is the [required] field specification flag, marking the start of each
column's separate specification.
.(dot) requests right justification of this column's data (the default omits
the dot and uses left justification of the reported data).
SLURM Reference Manual - 48