1 STRETCH
 STRETCH is a program used to graphically analyze stretch performance
 logs.

 Format:

       $ STRETCH == "$SYS$ENVROOT:[STRETCH]STRETCH
       $ STRETCH/qual/qual...  infile,infile,...

2 Parameters
 Qual:

 Any valid STRETCH qualifier.  All qualifiers are global, that is
 they may appear anywhere in the command line.

 Infile:

 A stretch log to be used as input for analysis.  Wildcards are
 permitted, in which case, all matching files are read for analysis.

2 Qualifiers
/AVERAGE=delta-time
 Stretch log entries are taken modulo the given delta-time (after
 subtracting the /SINCE time), and averaged together. The graph
 thus shows each bar labelled with a delta time, instead of an
 absolute time.  This is useful in generating, for example, a
 graph of an "average" day (/AVERAGE=1-0::), or week
 (/AVERAGE=`7-0::).

 Note that, in general, the /AVERAGE interval should be longer
 than the /INTERVAL value.

 As the displayed delta times are relative to the initial time, it
 is required that /SINCE be specified when using /AVERAGE.
/BEFORE=date-time
 Only stretch log entries earlier than the given date-time will
 be selected.
/BIAS
/NOBIAS
 The smallest stretch time encountered in any stretch log entry is
 subtracted from all stretch entries before graphing.

 If /STACK is specified, the bias is computed for each file separately.

 /NOBIAS is the default.
/DAYS=(d,d-d,...)
 A list of days of the week to be selected an graphed.  Entries falling
 outside the specified days are ignored, and graph points entirely
 within days not explicitly selected are not shown.  Valid days of the
 week are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY and
 SUNDAY.

 The specification is a list of one or more day values.  Each day value
 may be a single day name, or a range of days specified as "low-high".
 If more than one day value is given, separate them by commas and
 enclose the list in parentheses.
/HOURS=(n,n-n,...)
 A list of hours of the day to be selected and graphed.  Entries falling
 outside the specified hours are ignored, and graph points at hours not
 selected are not shown.  Hours range from 0 to 23.

 The specification is a list of one or more hour specifications.  Each
 hour specification may be a single hour, or a range of hours specified
 as "low-high".  If more than one hour specification is given, separate
 them by commas and enclose the list in parentheses.

 For example, to select 8 AM to 6PM, use /HOURS=8-17.
/INTERVAL=delta-time (D=1::)
 Controls the resolution of the analysis and graphing.  The default
 is one hour.

 The storage required by STRETCH is proportional to the number of
 intervals falling in the range of data analyzed.  If this range is
 too large, or the delta-time too small, an error will result.  In
 general, /INTERVAL should be at least as large as the frequency with
 which samples are written to the stretch logs.
/LOG
/NOLOG
 Log each file as it is processed.

 /NOLOG is the default.
/MAXIMUM=value
 Define the approximate maximum that will appear on the graph scale.
 Normally, it is not necessary to specify this, as STRETCH will choose
 a maximum for the graphs according to the values of the analysis.
 When generating graphs for comparison purposes, however, it may be
 helpful to be able to fix the scale.  The actual maximum used will
 be the next higher power of ten times 1, 2 or 5, if the value given
 is not in that form.  Note that either integers or floating decimal
 values may be specified.

 Graph points that fall beyond the maximum will be indicated with a
 "!" at the end of the bar.
/NORMALIZE
/NONORMALIZE
 /NORMALIZE causes data values to be scaled according to the
 smallest stretch time found.  This causes the values to
 range upwards from 1.  This is the default.  /NONORMALIZE
 causes the unscaled values to be plotted.  If /STACK is
 specified, then each file's samples are normalized
 separately. 

 The default is /NONORMALIZE.
/OUTPUT=filename (D=SYS$OUTPUT)
 The name of the file for graphing and logging.  The default is
 SYS$OUTPUT.
/PAGE=n
 Define the number of lines to a page.  The default is 60.
/SINCE=date-time
 Select only stretch log entries that are on or after the given
 date-time.  If unspecified, graphing starts at the first even
 multiple of the interval time at or before the earliest date analyzed
 in any stretch log.
/SQUEEZE
/NOSQUEEZE
 Controls plotting of intervals for which there is no data.  If
 /NOSQUEEZE (the default) is specified, no-data points are marked
 by a bar consisting of a single period (".").  Otherwise, such
 bars are omitted from the graph.
/STACK[=(title,...)]
/NOSTACK
 /STACK specifies that samples from successive files are to be
 plotted with separate bars, rather than averaging intervals across
 all input files.  Bars from all files are stacked next to each
 other for a given interval.  The titles, if specified, are
 labels that appear next to the stacked bars to identify
 them.  If the titles are omitted, then the title for a file
 is the first 20 characters of the filename component. 

 /NOSTACK is the default.
/TITLE=string
 Specify a title for each page of the output.  If special characters
 (spaces, puncutation, etc.) are in the string, enclose it in double
 quotes.
