diff --git a/docs.it4i/general/slurm-job-submission-and-execution.md b/docs.it4i/general/slurm-job-submission-and-execution.md index 70814cbe011907fe9c6e641454386687e0395a41..1260bb27d14d9fe6477f2d3b4492d7d0ae817e29 100644 --- a/docs.it4i/general/slurm-job-submission-and-execution.md +++ b/docs.it4i/general/slurm-job-submission-and-execution.md @@ -199,6 +199,25 @@ cn101 cn102 ``` +### Job States + +The most common job states are (in alphabetical order): + +| Code | Job State | Explanation | +| :--: | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| CA | CANCELLED | Job was explicitly cancelled by the user or system administrator. The job may or may not have been initiated. | +| CD | COMPLETED | Job has terminated all processes on all nodes with an exit code of zero. | +| CG | COMPLETING | Job is in the process of completing. Some processes on some nodes may still be active. | +| F | FAILED | Job terminated with non-zero exit code or other failure condition. | +| NF | NODE_FAIL | Job terminated due to failure of one or more allocated nodes. | +| OOM | OUT_OF_MEMORY | Job experienced out of memory error. | +| PD | PENDING | Job is awaiting resource allocation. | +| PR | PREEMPTED | Job terminated due to preemption. | +| R | RUNNING | Job currently has an allocation. | +| RQ | REQUEUED | Completing job is being requeued. | +| SI | SIGNALING | Job is being signaled. | +| TO | TIMEOUT | Job terminated upon reaching its time limit. | + ## Modifying Jobs In general: