Command Usage: sam v8_1_5
sam add location

Just having some fun...
Command Description:

Register a new replica location for a file which has been
previously declared to the SAM database.

If the location is an enstore tape location at Fermilab, the location
must include the volume label (and may also include the tape offset,
if known).  The syntax is:
   sam add location --file=fileNameHere \
      --loc=/pnfs/path/to/file(volumeLabel[.offset])

The location must be a known and valid data storage location; that
is, already registered in the database.


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

Where:

  --requiredOptions:
	            --fileName=<value> # basename of the file which is gaining a new location (aka replica)
	     --replicaLocation=<value> # string representing the replica location being added for this file

  --options:
	    --corbaCallTimeout=<value> # time in seconds for CORBA method calls to return before timing out (default: 0; zero implies no timeout)
	       --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:
	                --file=<value> # synonym for --fileName=<value>
	                 --loc=<value> # synonym for --replicaLocation=<value>
	            --location=<value> # synonym for --replicaLocation=<value>
	                --name=<value> # synonym for --fileName=<value>

Required Data Types:
	              corbaCallTimeout : int 
	                      fileName : string 
	               replicaLocation : 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 "--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


See Also: