Command Usage: sam v8_1_5
sam add consumption node

Just having some fun...
Command Description:

Establish a consumption on a node that SAM will you to deliver files to a consumer process Id,
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.



Usage:
       sam add consumption node <--requiredOptions> [--options] [-flags]

Where:

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

  --options:
	    --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 consumer process is running
	       --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 (default: stdout)

   -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:
	                --cpid=<value> # synonym for --processId=<value>
	                --node=<value> # synonym for --nodeName=<value>

Required Data Types:
	              corbaCallTimeout : int 
	                         limit : long 
	                      nodeName : string 
	                     processId : long 
	                       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: