Make destination user configurable per machine

[bex.git] / NOTES

diff --git a/NOTES b/NOTES
index 7b40ffd95260661b6785893fe6f203428cdb1e0c..366a4092130fad07a487870524b62fc4c8f9d4df 100644 (file)
--- a/NOTES
+++ b/NOTES
@@ -9,8 +9,10 @@
        /<job-id>.log           (Optional) transcript of output produced by the job (including
                                previous failed attempts)
 
-<queue>/jobs/<job-id>.job      All jobs issued on this queue, including those which
+<queue>/jobs/                  All jobs issued on this queue, including those which
                                are no longer queued for any machine
+       /<job-id>.job           Description of the job (see below)
+       /<job-id>.attach/       A directory containing attachments (if any)
 
 <queue>/history/<hostname>/    Successfully completed jobs (their .job, .stat and .log files)
                                are moved here if the keep_history config switch is set.
@@ -36,6 +38,10 @@ 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.
 
+Whenever a user command wants a job ID, it accepts any substring starting
+at a component boundary (start of the ID or a "-"), as long as the substring
+is unique.
+
 ### Status files ###
 
 Structure identical to job headers, but they do not contain a body.
@@ -67,7 +73,7 @@ REQUEUE               Attempted to put on a queue, but it already was there
 Additional status codes sent only over status FIFO:
 
 DONE           Done with the host (job equals "-")
-INIT           Host ready, preparing to execute jobs (job equals "-")
+INIT           Host or job ready, preparing to execute jobs
 LOCKED         Host or job not available, because it is locked by another brun
 PING           Trying to ping the host (job equals "-")
 SEND           Sending job to the host