Command Usage: sam v8_1_5
sam establish process

Just having some fun...
Command Description:

Establish a consumer process which will analyze SAM files, by calling the
sam_idl/sam_station/GPM2Consumer.establishProcess interface of the project
master.

A 'consumer process' is the process where your actual work is performed.
It is one of N processes collected under one consumer (established with a
prior "establish consumer" call), which all run the same application.

If no nodename is specified, sam_common_pylib/SamUtility/SamHostName/getSamHostName()
is used to determine the node upon which the process is running.

The process description is some text to identify the consumer. It will be
displayed in the project dump, project summary, and can be queried by a
dimension to retrieve the files seen by this consumer.


Usage:
       sam establish process <--requiredOptions> [--options] [-flags]
       sam establish consumer process <--requiredOptions> [--options] [-flags]
       sam create process <--requiredOptions> [--options] [-flags]

Where:

  --requiredOptions:
	          --consumerId=<value> # consumer ID returned by a previous call to "establish consumer"
	             --project=<value> # project under which this consumer process will be running
	             --station=<value> # station where this project is running

  --options:
	               --minimalOutput # Write unadorned output (useful for scripting)
	    --corbaCallTimeout=<value> # time in seconds for CORBA method calls to return before timing out (default: 0; zero implies no timeout)
	               --limit=<value> # limit number of files to deliver
	            --nodeName=<value> # node on which the project is running
	  --processDescription=<value> # description of the process
	       --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> # routing file into which to write results

   -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:
	                 --cid=<value> # synonym for --consumerId=<value>
	                --desc=<value> # synonym for --processDescription=<value>
	                   --minOutput # synonym for --minimalOutput
	                --node=<value> # synonym for --nodeName=<value>

Required Data Types:
	                    consumerId : long 
	              corbaCallTimeout : int 
	                         limit : long 
	                      nodeName : string 
	            processDescription : string 
	                       project : string 
	                 retryInterval : int 
	                   retryJitter : int 
	                 retryMaxCount : int 
	                        rtfile : string 
	                       station : 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: