Command Usage: sam v8_1_5 sam submit
|  |
Command Description:
Submit a job to the batch system.
The --envVar option may be used to specify a comma-separated list
of varName=value environmental variables that should be set when the
job executes.
The --bundle-files option allows you to send your script file along to
a remote execution host. This is only intended for small files.
Usage:
sam submit <--requiredOptions> [--options] [-flags]
sam submit job <--requiredOptions> [--options] [-flags]
Where:
--requiredOptions:
--station=<value> # station where the job should run
--options:
--detached # run pmaster detached from the station in the current session
--interactive # do NOT submit the job; instead, run interactively
--keepBatchScript # do not remove temporary batch wrapper script after execution
--restart # flag that this project should be restarted
--useForcedStop # project will be stopped if job count reaches zero, regardless of whether all consumers are finished or not
--batchSystem=<value> # name of the batch system to use if not the station default
--batchSystemFlags=<value> # additional batch-specific flags to be passed to the batch system
--bundleFiles=<value> # comma separated list of files to send with the job to a remote batch system
--corbaCallTimeout=<value> # time in seconds for CORBA method calls to return before timing out (default: 0; zero implies no timeout)
--cpuPerEvent=<value> # estimated amount of CPU required per event
--defname=<value> # project definition name
--envVar=<value> # user environmental variables to be set when the job executes
--fileCut=<value> # limit the number of files to this number
--group=<value> # work group that should be charged for project resources
--jdf=<value> # job description file
--jobErrorFile=<value> # job error file (use __default__ for the defaul error file)
--jobInfoFile=<value> # job information file
--jobOutputFile=<value> # job output file (use __default__ for the default output file)
--nconsumers=<value> # number of consumer processes to run in this job
--project=<value> # name of the project
--queue=<value> # batch queue to which the job should be submitted
--retryInterval=<value> # retry interval base in seconds; will multiply this base times retryCount (default: 5)
--retryJitter=<value> # retry jitter, random jitter added to base retry interval times retryCount (default: 5)
--retryMaxCount=<value> # number of times to retry CORBA calls for retriable exceptions (default: 25; zero implies no retries)
--rtfile=<value> # file in which to return "start project" results; default=stdout
--script=<value> # script containing the processing commands you wish to execute
--scriptParams=<value> # parameters to be passed to the script
--snapshot=<value> # name of the already-existing snapshot to be used as the project file list
--submitInfoFile=<value> # file into which submission information is written
--workDir=<value> # working directory for process
--wrapperScriptDir=<value> # directory in which to write the batch wrapper script (default: $HOME)
-flags:
-c # automatically close all servants after each method call
-d # debug mode
-s # retrySilently mode (do not issue messages to stderr on proxy retries)
-t # time-it mode (print additional info on timings)
-v # verbose mode
Synonymous Options:
--cpu-per-event=<value> # synonym for --cpuPerEvent=<value>
--dataset=<value> # synonym for --snapshot=<value>
--file-cut=<value> # synonym for --fileCut=<value>
--framework-exe=<value> # synonym for --script=<value>
--framework-params=<value> # synonym for --scriptParams=<value>
--frameworkExe=<value> # synonym for --script=<value>
--frameworkParams=<value> # synonym for --scriptParams=<value>
--max-file-amt=<value> # synonym for --fileCut=<value>
--maxFileAmt=<value> # synonym for --fileCut=<value>
--max_file_amt=<value> # synonym for --fileCut=<value>
--name=<value> # synonym for --project=<value>
--snapid=<value> # synonym for --snapshot=<value>
Must specify at least one of:
--defname=<value> OR --snapshot=<value>
Mutually Exclusive Options:
--defname=<value> OR --snapshot=<value>
Required Data Types:
batchSystem : string
batchSystemFlags : string
bundleFiles : string
corbaCallTimeout : int
cpuPerEvent : TimeInterval
defname : string
envVar : string
fileCut : int
group : string
jdf : string
jobErrorFile : string
jobInfoFile : string
jobOutputFile : string
nconsumers : int
project : string
queue : string
retryInterval : int
retryJitter : int
retryMaxCount : int
rtfile : string
script : string
scriptParams : string
snapshot : string
station : string
submitInfoFile : string
workDir : string
wrapperScriptDir : string
You may omit "-c" if the $SAM_PYAPI_AUTO_CLOSE_SERVANTS environmental variable is set.
You may omit "--corbaCallTimeout=<value>" if the $SAM_PYAPI_CORBA_CALL_TIMEOUT environmental variable is set.
You may omit "--project=<value>" if the $SAM_PROJECT environmental variable is set.
You may omit "--retryInterval=<value>" if the $SAM_PYAPI_RETRY_INTERVAL environmental variable is set.
You may omit "--retryJitter=<value>" if the $SAM_PYAPI_RETRY_JITTER environmental variable is set.
You may omit "--retryMaxCount=<value>" if the $SAM_PYAPI_RETRY_MAX_COUNT environmental variable is set.
You may omit "-s" if the $SAM_PYAPI_RETRY_SILENTLY environmental variable is set.
You may omit "--station=<value>" if the $SAM_STATION environmental variable is set.
UNIX ExitStatus:
Success : 0
Unhandled exceptions : 127
See Also: