sam generate recovery project

Command Usage: sam v8_5_2
sam generate recovery project

Command Description:

Produces a recovery project for projects where some files were not
consumed or not even delivered. 

The default behaviour is to determine which consumer processes need to
be recovered from the state of the last file seen. The --useProcessStatus
option instead gives you processes which were not marked as completed.
--useProcessStatus and --useLastFileStatus together use both the last file
state and the process status. To ignore the processes altogether and just
provide the unconsumed files, use --ignoreProcesses. 

This command does not produce reasonable results for projects with
more that one consumer. Multiple consumer processes are OK.



Usage:
       sam generate recovery project  <--requiredOptions> [--options] [-flags]

Where:

  --requiredOptions:
	             --project=<value> # name of the project to get a summary for

  --options:
	          --ignoreBadProcesses # if using the process status, ignore processes with the status bad
	             --ignoreProcesses # do not use anything about the status or last file state of a process
	                  --noSnapshot # does not generate a snapshot
	                  --printQuery # print the generated dimension query
	           --useLastFileStatus # include processes where the last file status is not consumed
	            --useProcessStatus # include processes where the process status is still active
	    --corbaCallTimeout=<value> # time in seconds for CORBA method calls to return before timing out (default: 0; zero implies no timeout)
	            --cpidList=<value> # constrain the command results to files affected by the given list of CPIDs
	       --extraCpidList=<value> # comma separated list of consumer process IDs to use in addition to the failed processes
	               --group=<value> # group to use for making the dataset definition and snapshot
	         --recoDefname=<value> # name of the recovery dataset
	       --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)

   -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:
	              --ignoreConsumed # synonym for --ignoreProcesses

Must specify at least one of:
	--recoDefname=<value> OR --printQuery 

Mutually Exclusive Options:
	--cpidList=<value> OR --extraCpidList=<value> 
	--ignoreProcesses OR --useLastFileStatus 
	--ignoreProcesses OR --useProcessStatus 

Required Data Types:
	              corbaCallTimeout : int 
	                      cpidList : SamLongList 
	                 extraCpidList : SamLongList 
	                         group : string 
	                       project : string 
	                   recoDefname : string 
	                 retryInterval : int 
	                   retryJitter : int 
	                 retryMaxCount : int 

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 "--group=<value>" if the $SAM_GROUP 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.

UNIX ExitStatus:
	             Success :   0
	Unhandled exceptions : 127
Command Usage: sam v8_5_2sam generate recovery project

Command Usage: sam v8_5_2
sam generate recovery project
