Command Usage: sam v8_1_5 sam get date
|  |
Command Description:
The 'sam getdate' utility is useful within other scripts
when you need to pass date information on the command line.
It allows you to do things like
runMyProgram --start-date=`sam getdate YESTERDAY` --end-date=`sam getdate TOMORROW`
The "magic words" you may use are:
TODAY - midnight on this day
YESTERDAY - midnight of TODAY-1d
TOMORROW - midnight of TODAY+1d
NOW - right now
START_OF_TIME - start of time
You may also use combinations such as
sam getdate "TODAY+3d" # 3 days from now
sam getdate "TODAY-1m" # 1 month ago
sam getdate "TOMORROW+1y" # 1 year from tomorrow
Usage:
sam get date [--options] [-flags] <arg1>
sam getdate [--options] [-flags] <arg1>
Where:
--options:
--corbaCallTimeout=<value> # time in seconds for CORBA method calls to return before timing out (default: 0; zero implies no timeout)
--format=<value> # format to use for output printing; default = %d-%b-%Y
--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
Args:
<arg1> # TODAY, YESTERDAY, etc., describes the date of interest
Required Data Types:
args : SamTime
corbaCallTimeout : int
format : 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: