Maint: mkdir -p

[bex.git] / NOTES

diff --git a/NOTES b/NOTES
index 703001534933c078613c91d2bd86f0b3b7129939..28adf1971c959a42100a60e9bea75eeb25644a10 100644 (file)
--- a/NOTES
+++ b/NOTES
@@ -32,6 +32,9 @@ Known header fields:
 
 ID: <job-id>                   Identifier of the job, unique in the scope of a queue
 Subject: <subject>             Subject to be displayed to the user
+Prep: <command>                        Run <command> in a shell before the job body is executed;
+                               $HOST contains the name of the host. This is useful for
+                               example if you want to transfer data to the host by rsync.
 
 ### Status files ###
 
@@ -45,21 +48,26 @@ Message: <msg>                      (Optional) human-readable message explaining the status
 
 ### Status codes ###
 
+FAILED         Job failed to execute (i.e., it returned a non-zero exit code)
+INTERR         Internal error of BEX (e.g., failed to read job prolog file)
+NEW            Newly inserted job, which did not run yet
 NOPING         Host does not respond to ping
 NOXFER         Transfer of the job body to a temporary file on the host has failed
 OK             Job finished successfully (this is usually not seen in the queue, since
                finished jobs are immediately deleted or moved to the history)
-FAILED         Job failed to execute (i.e., it returned a non-zero exit code)
-INTERR         Internal error of BEX (e.g., failed to read job prolog file)
+PREP           Running preparatory commands (i.e., those present in Prep header field)
+PREPFAIL       Preparatory commands failed (i.e., those present in Prep header field)
+REMOVED                Job removed from the queue (behavior similar to OK)
+RUN            Job is running
 
-These are present only in log files and messages sent over status FIFO:
+Additional status codes recorded in the log files:
 
-RUN            Job is running
-SEND           Sending job to the host
+REQUEUE                Attempted to put on a queue, but it already was there
 
-Status codes not tied to a specific job (sent over status FIFO):
+Additional status codes sent only over status FIFO:
 
-PING           Trying to ping the host
+DONE           Done with the host (job equals "-")
+INIT           Host or job ready, preparing to execute jobs
 LOCKED         Host or job not available, because it is locked by another brun
-INIT           Host ready, preparing to execute jobs
-DONE           Done with the host
+PING           Trying to ping the host (job equals "-")
+SEND           Sending job to the host