note: the { and } characters are meaningful to many command line shells. Double quotes were used above to make sure the { and } were passed into tractor-spool which would be required for most shells including cmd.exe and bash , and csh etc. |
--range-formatting=both|sfmt|text | The default setting 'both' attempts substitutions of range integers into -c command arguments using first Python string format() style {RANGE} expressions, followed by simple replacement of any remaining occurrences of the word RANGE. Use the value 'sfmt' here to process only string format {RANGE} expressions, or the value 'text' for simple replacement only. |
--itervalues=LIST | create one task for each item in the list, specified by a comma-separated list of items, replacing ITER in the command string or serivce key expression with the current value; e.g. red,green,blue or 'red house,green lawn,blue sky' |
--iterfile=FILENAME | create one task for each item in the file, which specifies a line-separated list of items |
--task-title=TTITLE | Task title pattern, for use with auto-generated jobs using RANGE or ITER construction |
-T [MINSECS,]MAXSEC --runtime-bounds=[MINSECS,]MAXSECS | For use with -c, adds minimum and maximum bounds on the elapsed time of the command on a blade. Give a range of seconds, as 'min,max' or 'min-max'. The launched command is marked Error if its elapsed run time is shorter or longer than the given bounds. Commands that exceed the maximum time are killed. If only one value is given, it specifies the max run time. A max time of 0 (zero) means unbounded. |
--limit-tags=TAGS | Specifies the limit counting tags to be added to each command; subject to substitution by RANGE and ITER |
--tier=TIER | Dispatching tier assignment, for special-case jobs |
--paused | spool the job in a paused state, meaning that no tasks will be launched from it until its priority is later changed from a negative to a positive number. |
--aftertime='MM DD HH:MM' | delay job start until the given date, as 'MM DD HH:MM' |
--afterjid=JID | delay job start until the given job(s) complete, specified as jid(s) |
--nrm | causes auto-generated --ribs to use netrender on the local blade rather than direct rendering with prman on a blade; used when the named RIBfile is not accessible from the remote blades directly |
--spool-wait | block until job is fully spooled (to tractor-engine 2.0+) |
--status-json | prints the submission confirmation message (or denial) as a JSON-format dict on stdout, rather than plain text |
--status-plain | prints spool confirmation message as human-readable plain text; this is the default |
-A, --in-alfred | indicates that the job file being submtted is in Alfred (tcl) format, the default |
-J, --in-json | indicates that the job file(s) being submitted is formatted as Tractor compliant JSON |
--alfescape | process job files assuming that they expect backward-compatible alfred-style two-level unquoting / substitution |
--alf-argv-subst | apply second substitution pass on Cmd executable parameters only |
--maxactive=MAXACTIVE | limit the maximum number of concurrently active commands of job |
--user=LOGIN | The user (login) to be associated with this job; default is the name of the user executing the spooling script. May be disallowed by site configuration policies. |
--jdelete=JDEL_ID --jretire=JDEL_ID | delete the requested job from the active queue |
--haddr=HADDR | Host address selection for the submitting host, not usually needed. May be necessary only for "local Cmd" variant jobs when the submitting host has several network interfaces or tractor-engine might see a differing addresses for the submission script and for the locally running tractor-blade node. |
-p PASSWD --passwd=PASSWD | Tractor login password for the user submitting the job (if engine passwords are enabled) |
--configfile=CONFIGFILE | file containing cached login and password data for the user running tractor-spool |
--parse-debug | parse the inbound job text and report errors, the job is not submitted to the engine for processing |
-o --review --print-alfscript | print the job alfscript rather than spooling it; usually to view or save the job text that tractor-spool itself has generated based on other arguments, rather than when it is reading an existing job from a file |