Command Usage: sam v8_1_5
sam translate constraints

Just having some fun...
Command Description:

List the files that match the given dimensions.  NOTE,
this does not TAKE a snapshot; it merely tells you what files would
be IN the snapshot if you were to take one using these
constraints.

If you like what you see with translate constraints, you should
then use "sam create dataset" to take a snapshot.

The --returnCountOnly option (or, equivalently, --count) will return
only the count of the number of files matching these constraints.

--fileInfo will print the size and number of events (if any) for each file
in the list.

--noSummary will not print any summary information, but just a simple list of
files, one per line. When combined with --fileInfo it will print the filename,
file size in bytes, and number of events in the file as tab separated fields.

If you are looking for help on dimensions, you should use the
    sam get dimension info
command; but for backwards compatibility with one of the most stupid
things ever done in the original sam interface, we also allow the
    sam translate constraints --dim=help [--type=<dimensionCategory>]


Usage:
       sam translate constraints <--requiredOptions> [--options] [-flags]
       sam list files <--requiredOptions> [--options] [-flags]
       sam translate dimensions <--requiredOptions> [--options] [-flags]

Where:

  --requiredOptions:
	          --dimensions=<value> # string specifying the dimensional quantities of interest

  --options:
	                    --fileInfo # Display individual file size and event count
	                   --noSummary # Do not show summary information; return a simple list of files only
	             --returnCountOnly # Return only the count of files matching the dimensions
	                 --summaryOnly # Only display the summary and not the file list
	    --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)
	                --type=<value> 

   -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:
	                       --count # synonym for --returnCountOnly
	                 --dim=<value> # synonym for --dimensions=<value>
	           --dimension=<value> # synonym for --dimensions=<value>
	                --dims=<value> # synonym for --dimensions=<value>

Mutually Exclusive Options:
	--fileInfo OR --summaryOnly 
	--returnCountOnly OR --fileInfo 
	--returnCountOnly OR --noSummary OR --summaryOnly 

Required Data Types:
	              corbaCallTimeout : int 
	                    dimensions : string 
	                 retryInterval : int 
	                   retryJitter : int 
	                 retryMaxCount : int 
	                          type : 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 "--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: