From 654f8abe26179befd52f895699e921c4733e880d Mon Sep 17 00:00:00 2001
From: Andy Turner <a.turner@epcc.ed.ac.uk>
Date: Wed, 25 Sep 2024 10:53:34 +0100
Subject: [PATCH] Adds not on estimatung start time. Closes #629

---
 docs/user-guide/scheduler.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/user-guide/scheduler.md b/docs/user-guide/scheduler.md
index 5bfc00cd7..3820e45cc 100644
--- a/docs/user-guide/scheduler.md
+++ b/docs/user-guide/scheduler.md
@@ -763,6 +763,27 @@ sbatch: Job 1039497 to start at 2022-02-01T23:20:51 using 256 processors on node
 in partition standard
 ```
 
+## Estimated start time for queued jobs
+
+You can use the `squeue` command to show the current estimated start time for a job.
+Please note that it is just an estimate, the actual start time may differ as the scheduler
+status when the start time was estimated may be different due to subsequent changes to
+the scheduler state. To return the estimated start time for a job you spacify the 
+job ID with the `--jobs=<jobid>` and `--Format=StartTime` options.
+
+For example, to show the estimated start time for job `123456`, you would use:
+
+```
+squeue --jobs=123456 --Format=StartTime
+```
+
+The output from this command would look like:
+
+```
+START_TIME          
+2024-09-25T13:07:00
+```
+
 ## Example job submission scripts
 
 A subset of example job submission scripts are included in full below.