.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "SJSTAT 1" .TH SJSTAT 1 2025-09-04 "perl v5.38.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAME sjstat \- List attributes of jobs under the SLURM control .SH SYNOPSIS .IX Header "SYNOPSIS" \&\fBsjstat\fR [\fB\-h\fR ] [\fB\-c\fR] [\fB\-r\fR ] [\fB\-v\fR] .SH DESCRIPTION .IX Header "DESCRIPTION" The \fBsjstat\fR command is used to display statistics of jobs under control of SLURM. The output is designed to give information on the resource usage and availablilty, as well as information about jobs that are currently active on the machine. This output is built using the SLURM utilities, sinfo, squeue and scontrol, the man pages for these utilities will provide more information and greater depth of understanding. .SH OPTIONS .IX Header "OPTIONS" .IP \fB\-h\fR 4 .IX Item "-h" Display a brief help message .IP \fB\-c\fR 4 .IX Item "-c" Display the computing resource information only. .IP \fB\-man\fR 4 .IX Item "-man" Show the man page. .IP \fB\-r\fR 4 .IX Item "-r" Display only the running jobs. .IP \fB\-v\fR 4 .IX Item "-v" Display more verbose information. .SH EXAMPLE .IX Header "EXAMPLE" The following is a basic request for status. .PP .Vb 1 \& > sjstat \& \& Scheduling pool data: \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& Pool Memory Cpus Total Usable Free Other Traits \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& pdebug 15000Mb 8 32 32 24 (null) \& pbatch* 15000Mb 8 1072 1070 174 (null) \& \& \& Running job data: \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& JobID User Nodes Pool Status Used Master/Other \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& 395 mary 1000 pbatch PD 0:00 (JobHeld) \& 396 mary 1000 pbatch PD 0:00 (JobHeld) \& 375 sam 1000 pbatch CG 0:00 (JobHeld) \& 388 fred 32 pbatch R 25:27 atlas89 \& 361 harry 512 pbatch R 1:01:12 atlas618 \& 1077742 sally 8 pdebug R 20:16 atlas18 \& \& \& The Scheduling data contains information pertaining to the: \& \& Pool a set of nodes \& Memory the amount of memory on each node \& Cpus the number of cpus on each node \& Total the total number of nodes in the pool \& Usable total usaable nodes in the pool \& Free total nodes that are currently free \& \& The Running job data contains information pertaining to the: \& \& JobID the SLURM job id \& User owner of the job \& Nodes nodes required, or in use by the job \& (Note: On cpu scheduled machines, this field \& will be labeled "Procs" show the number of processors \& the job is using.) \& Pool the Pool required or in use by the job \& Status current status of the job \& Used Wallclick time used by the job \& Master/Other Either the Master (head) node used by the job, or may \& indicate further status of a pending, or completing job. \& \& The common status values are: \& \& R The job is running \& PD The job is Pending \& CG The job is Completing \& \& These are states reported by SLURM and more elaborate documentation \& can be found in the squeue/sinfo man pages. \& \& \& An example of the \-v option. \& \& Scheduling pool data: \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& Total Usable Free Node Time Other \& Pool Memory Cpus Nodes Nodes Nodes Limit Limit Traits \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& pdebug 15000Mb 8 32 32 24 16 30 (null) \& pbatch* 15000Mb 8 1072 1070 174 UNLIM UNLIM (null) \& \& Running job data: \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& Time Time Time \& JobID User Nodes Pool Status Used Limit Started Master/Other \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& 38562 tom 4 pbatch PD 0:00 1:00:00 01\-14T18:11:22 (JobHeld) \& \& The added fields to the "Scheduling pool data" are: \& \& Node Limit SLURM imposed node limit. \& Time Limit SLURM imposed time limit, value in minutes. \& \& The added fields to the "Running job data" are: \& \& Limit Time limit of job. \& Start Start time of job. .Ve .SH "REPORTING BUGS" .IX Header "REPORTING BUGS" Report bugs to