Command Usage: sam v8_1_5
sam submit

Just having some fun...
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: