Command Usage: sammis v8_1_5
sammis plot consumption

Just having some fun...
Command Description:

Generate the consumption plot for *all* stations, as well as for
the individual stations listed with the "--station-list=s1,s2,..." option.
  
The individual plots may be re-generated using the commands
   sammis plot consumed [files|events|gbytes] ...

with appropriate options; but since we generate all of these plots
on a regular basis, it is much more efficient to do it with a minimum
of command parsing and SQL querying.  Hence, all of the consumption plots 
that we generate as part of our 'usual' D0 sam diagnostics have been gathered
into one script which runs in about half an hour (instead of over
the course of several hours to days).

The plots that are generated by default are:
    pastDay-consumedFiles,    pastDay-consumedGbytes,    pastDay-consumedEvents,
    pastWeek-consumedFiles,   pastWeek-consumedGbytes,   pastWeek-consumedEvents,
    pastMonth-consumedFiles,  pastMonth-consumedGbytes,  pastMonth-consumedEvents,
    pastYear-consumedFiles,   pastYear-consumedGbytes,   pastYear-consumedEvents,
    all-consumedFiles,        all-consumedGbytes,        all-consumedEvents,

plus the integrated total of each of the above; plus the same for each specified
station, unless specified otherwise by the commandline.

You may use "--start-date=dd-mon-yyyy --end-date=dd-mon-yyyy" to
specify particular dates, overriding the default plot dates.

You may use "--all" along with "--nodaily", "--noweekly", etc.,
  OR,       "--noall" along with "--daily", "--weekly", etc.,
to produce a subset of the default plots.

The default if no start-date, end-date, etc., is specified, is "--all".
          

Usage:
       sammis plot consumption [--options] [-flags]

Where:


  --options:
	                         --all # create all plots except those turned off on the command line
	                       --daily # create the plot for the past 24 hours
	                     --monthly # create the plot for the past month
	                       --noall # do not create any plots except those specified on the command line
	                     --nodaily # skip the plot for the past 24 hours
	                      --nohtml # do not generate an HTML page wrapping the standard plots
	                   --nomonthly # skip the plot for the past month
	               --nostartOfTime # skip the plot for cumulative totals since time began
	                    --noweekly # skip the plot for the past 7 days
	                    --noyearly # skip the plot for the past year
	                 --reuseColors # re-use the colors in the color palatte (by default turned OFF; merge stragglers as "other")
	                 --startOfTime # create the plot for cumulative totals since time began
	                      --weekly # create the plot for the past 7 days
	                      --yearly # create the plot for the past year
	    --corbaCallTimeout=<value> # time in seconds for CORBA method calls to return before timing out (default: 0; zero implies no timeout)
	             --endDate=<value> # end of a particular date range for which to make plots (dd-mon-yyyy); default TODAY
	              --output=<value> # output file base name, for user-specified date ranges (ignored otherwise)
	       --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)
	           --startDate=<value> # beginning of a particular date range for which to make plots (dd-mon-yyyy)
	         --stationList=<value> # comma-separated list of stations for which to generate consumption plots

   -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:
	            --end-date=<value> # synonym for --endDate=<value>
	             --nostart-of-time # synonym for --nostartOfTime
	          --start-date=<value> # synonym for --startDate=<value>
	               --start-of-time # synonym for --startOfTime

Mutually Exclusive Options:
	--all OR --noall 
	--daily OR --nodaily 
	--monthly OR --nomonthly 
	--start-of-time OR --nostart-of-time 
	--weekly OR --noweekly 
	--yearly OR --noyearly 

Incompatible Option Combinations:
	[noall, daily, weekly, monthly, yearly, start-of-time] OR [start-date, end-date] OR [all, nodaily, noweekly, nomonthly, 
	    noyearly, nostart-of-time] 

Required Data Types:
	              corbaCallTimeout : int 
	                       endDate : SamTime 
	                        output : string 
	                 retryInterval : int 
	                   retryJitter : int 
	                 retryMaxCount : int 
	                     startDate : SamTime 
	                   stationList : SamStringList 

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: