I have a bug report on the description of the job "state" field in the
output of "sacct". The man page says:
state Displays the job status, or state.
Output can be RUNNING, RESIZING, SUSPENDED, COMPLETED,
CANCELLED, FAILED, TIMEOUT, PREEMPTED or NODE_FAIL. If
multiple job states are found for a single job (e.g.
the job was requeued after a NODE_FAIL and then COM-
PLETED) then the last job state will be displayed fol-
lowed by a "+".
The sentence about multiple job states does not seem to be true. I see
no evidence that a "+" sign indicates that multiple job states were found.
The "+" sign only appears to indicate that there is more information than
the current field width can hold. For example "CANCELLED+" can indicate
that the state is actually "CANCELLED by nnn". Increasing the field
width with the %NUMBER format modifier will show this. I propose to
change the wording of this paragraph to:
state Displays the job status, or state.
Output can be RUNNING, RESIZING, SUSPENDED, COMPLETED,
CANCELLED, FAILED, TIMEOUT, PREEMPTED or NODE_FAIL. If
more information is available on the job state than
will fit into the current field width (for example,
the uid that CANCELLED a job) the state will be fol-
lowed by a "+". You can increase the size of the dis-
played state using the "%NUMBER" format modifier
described earlier.
-Don Albert-
Here is a patch against SLURM 2.3.0-rc2:
[stag] (dalbert) s230rc2> cvs diff -u slurm/doc/man/man1/sacct.1
Index: slurm/doc/man/man1/sacct.1
===================================================================
RCS file: /cvsroot/slurm/slurm/doc/man/man1/sacct.1,v
retrieving revision 1.1.1.40
diff -u -r1.1.1.40 sacct.1
--- slurm/doc/man/man1/sacct.1 29 Aug 2011 16:31:15 -0000 1.1.1.40
+++ slurm/doc/man/man1/sacct.1 9 Sep 2011 18:10:13 -0000
@@ -664,9 +664,10 @@
Displays the job status, or state.
Output can be RUNNING, RESIZING, SUSPENDED, COMPLETED, CANCELLED, FAILED,
-TIMEOUT, PREEMPTED or NODE_FAIL. If multiple job states are found for a
single
-job (e.g. the job was requeued after a NODE_FAIL and then COMPLETED)
-then the last job state will be displayed followed by a "+".
+TIMEOUT, PREEMPTED or NODE_FAIL. If more information is available on the
job state
+than will fit into the current field width (for example, the uid that
CANCELLED
+a job) the state will be followed by a "+". You can increase the size of
+the displayed state using the "%NUMBER" format modifier described
earlier.
.TP
\f3submit\fP
