diff --git a/docs/agave/guides/jobs/job-monitoring.rst b/docs/agave/guides/jobs/job-monitoring.rst
index 613a7ee..44c05b5 100644
--- a/docs/agave/guides/jobs/job-monitoring.rst
+++ b/docs/agave/guides/jobs/job-monitoring.rst
@@ -128,96 +128,68 @@ The list of all possible job statuses is given in table 2.
- CREATED |
- The job was updated |
+ ACCEPTED |
+ The job accepted for processing |
- UPDATED |
- The job was updated |
-
-
- DELETED |
- The job was deleted |
-
-
- PERMISSION_GRANT |
- User permission was granted |
-
-
- PERMISSION_REVOKE |
- Permission was removed for a user on this job |
+ PENDING |
+ The job processing beginning |
- PENDING |
- Job accepted and queued for submission. |
+ PROCESSING_INPUTS |
+ Identifying input files for staging |
STAGING_INPUTS |
Transferring job input data to execution system |
- CLEANING_UP |
- Job completed execution |
-
-
- ARCHIVING |
- Transferring job output to archive system |
-
-
- STAGING_JOB |
+ STAGED |
Job inputs staged to execution system |
- FINISHED |
- Job complete |
-
-
- KILLED |
- Job execution killed at user request |
+ STAGING_JOB |
+ Staging runtime assets to execution system. |
- FAILED |
- Job failed |
+ SUBMITTING |
+ Submitting job to execution system |
- STOPPED |
- Job execution intentionally stopped |
+ QUEUED |
+ Job queued in execution system queue |
RUNNING |
- Job started running |
-
-
- PAUSED |
- Job execution paused by user |
+ Job running on execution system |
- QUEUED |
- Job successfully placed into queue |
+ CLEANING_UP |
+ Job completed execution |
- SUBMITTING |
- Preparing job for execution and staging binaries to execution system |
+ ARCHIVING |
+ Transferring job output to archive system |
- STAGED |
- Job inputs staged to execution system |
+ BLOCKED |
+ Job blocked |
- PROCESSING_INPUTS |
- Identifying input files for staging |
+ PAUSED |
+ Job processing suspended |
- ARCHIVING_FINISHED |
- Job archiving complete |
+ FINISHED |
+ Job completed successfully |
- ARCHIVING_FAILED |
- Job archiving failed |
+ STOPPED |
+ Job execution intentionally stopped |
- HEARTBEAT |
- Job heartbeat received |
+ FAILED |
+ Job failed |
@@ -229,7 +201,7 @@ The list of all possible job statuses is given in table 2.
Table 2. Job statuses listed in progressive order from job submission to completion.
-Polling is an incredibly effective approach, but it is bad practice for two reasons. First, it does not scale well. Querying for one job status every few seconds does not take much effort, but querying for 100 takes quite a bit of time and puts unnecessary load on Tapis's servers. Second, polling provides what is effectively a binary response. It tells you whether a job is done or not done, it does not give you any information on what is actually going on with the job or where it is in the overall execution process.
+Polling is an incredibly effective approach, but it is bad practice for two reasons. First, it does not scale well. Querying for one job status every few seconds does not take much effort, but querying for 100 takes quite a bit of time and puts unnecessary load on Tapis's servers. Second, polling provides what is effectively a binary response. It tells you whether a job is done or not done, it does not give you any information on what is actually going on with the job or where it is in the overall execution process. Subscribing to any job event notification will automatically subscribe you to: `FINISHED`, `STOPPED`, `BLOCKED`, `PAUSED` and `FAILED` notifications.
The job history URL provides much more detailed information on the various state changes, system messages, and progress information associated with data staging. The syntax of the job history URL is as follows: