Python API: sam v8_1_5 sam.startUnreservedProjectViaStation()
|  |
This is the python interface to the command 'sam start unreserved project'.
Command Description:
Start a project that has not previously been reserved in the database.
The project is started asynchronously by the station. If you need to verify that
it is started and available before running any other commands you can use 'sam
ping project' to test if it is responding yet.
Python Usage:
from Sam import sam
result = sam.startUnreservedProjectViaStation(...)
Return value: SamStruct.BaseProjectInfo.BaseProjectInfo
Arguments are passed as keyword-value pairs, as in:
myfunc(arg1='myarg', arg2='anotherarg', d=1)
Argument Keyword Description:
(*) indicates that this keyword is required
>>> indicates that either the API object or the CLI equivalent (<<<) is required
====================================================================================================================================
KEYWORD DATA TYPE DESCRIPTION
------------------------------------------------------------------------------------------------------------------------------------
c SamBoolean automatically close all servants after each method call
corbaCallTimeout int time in seconds for CORBA method calls to return before timing out (default: 0; zero implies no timeout)
d SamBoolean debug mode
>>> datasetSpecification SamBoolean
<<< definitionId long DB ID number of the dataset definition to be used to create the project file list
<<< definitionName string name of the dataset definition to be used to create the project file list
detached SamBoolean tell station not to start project master
(*) group string working group under which this project should be run
project string name to give to the project
retryInterval int retry interval base in seconds; will multiply this base times retryCount (default: 5)
retryJitter int retry jitter, random jitter added to base retry interval times retryCount (default: 5)
retryMaxCount int number of times to retry CORBA calls for retriable exceptions (default: 25; zero implies no retries)
s SamBoolean retrySilently mode (do not issue messages to stderr on proxy retries)
<<< snapshotId long DB ID number of an existing snapshot to be used as the project file list
<<< snapshotName string name of an existing snapshot to be used as the project file list
<<< snapshotVersion SnapshotVersion "new", "last", or an existing snapshot version taken with the specified dataset definition
(*) station string station where the project will run
t SamBoolean time-it mode (print additional info on timings)
v SamBoolean verbose mode
====================================================================================================================================
Python API-only Keywords:
'datasetSpecification': replaces (definitionName, definitionId, snapshotVersion, snapshotName, snapshotId)
Must have at least one of:
(datasetSpecification, definitionName, definitionId, snapshotVersion, snapshotName, snapshotId)
Mutually exclusive keywords:
(definitionName || definitionId)
(snapshotName || snapshotId)
(snapshotName || snapshotVersion)
Incompatible keyword combinations:
(datasetSpecification) OR (definitionName, definitionId, snapshotVersion) OR (snapshotName, snapshotId)
Environment Defaults:
c = os.environ['SAM_PYAPI_AUTO_CLOSE_SERVANTS']
corbaCallTimeout = os.environ['SAM_PYAPI_CORBA_CALL_TIMEOUT']
project = os.environ['SAM_PROJECT']
retryInterval = os.environ['SAM_PYAPI_RETRY_INTERVAL']
retryJitter = os.environ['SAM_PYAPI_RETRY_JITTER']
retryMaxCount = os.environ['SAM_PYAPI_RETRY_MAX_COUNT']
s = os.environ['SAM_PYAPI_RETRY_SILENTLY']
station = os.environ['SAM_STATION']
See Also: