[0001]
[0002]
[0003]
[0004]
[0005]
[0006]
[0007]
[0008]
[0009]
[0010]
[0011]
[0012]
[0013]
[0014]
[0015]
[0016]
[0017]
[0018]
[0019]
[0020]
[0021]
[0022]
[0023]
[0024]
[0025]
[0026]
[0027]
[0028]
[0029]
[0030]
[0031]
[0032]
[0033]
[0034]
[0035]
[0036]
[0037]
[0038]
[0039]
[0040]
[0041]
[0042]
[0043]
[0044]
[0045]
[0046]
[0047]
[0048]
[0049]
[0050]
[0051]
[0052]
[0053]
[0054]
[0055]
[0056]
[0057]
[0058]
[0059]
[0060]
[0061]
[0062]
[0063]
[0064]
[0065]
[0066]
[0067]
[0068]
[0069]
[0070]
[0071]
[0072]
[0073]
[0074]
[0075]
[0076]
[0077]
[0078]
[0079]
[0080]
[0081]
[0082]
[0083]
[0084]
[0085]
[0086]
[0087]
[0088]
[0089]
[0090]
[0091]
[0092]
[0093]
[0094]
[0095]
[0096]
[0097]
[0098]
[0099]
[0100]
[0101]
[0102]
[0103]
[0104]
[0105]
[0106]
[0107]
[0108]
[0109]
[0110]
[0111]
[0112]
[0113]
[0114]
[0115]
[0116]
[0117]
[0118]
[0119]
[0120]
[0121]
[0122]
[0123]
[0124]
[0125]
[0126]
[0127]
[0128]
[0129]
[0130]
[0131]
[0132]
[0133]
[0134]
[0135]
[0136]
[0137]
[0138]
[0139]
[0140]
[0141]
[0142]
[0143]
[0144]
[0145]
[0146]
[0147]
[0148]
[0149]
[0150]
[0151]
[0152]
[0153]
[0154]
[0155]
[0156]
[0157]
[0158]
[0159]
[0160]
[0161]
[0162]
[0163]
[0164]
[0165]
[0166]
[0167]
[0168]
[0169]
[0170]
[0171]
[0172]
[0173]
[0174]
[0175]
[0176]
[0177]
[0178]
[0179]
[0180]
[0181]
[0182]
[0183]
[0184]
[0185]
[0186]
[0187]
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>HyperSPI Help</title>

<style type="text/css">
body {
   margin:1em;
   font-family: arial, helvetica, sans-serif,
                "DejaVu Sans Mono", "Everson Mono", FreeMono, "Lucida Console";
   font-size:14px;
}

tt { font-family:monospace; padding:0 4px 0 4px; }

.hyperspi {
   font-family: futura, \"Tw Cen MT\", helvetica, arial, sans;
   font-size:110%; letter-spacing:-1px;
}

.header {
   padding:0.5em 0.5em 0.5em 1em;
   border:1px solid lightslategray; border-radius:1px;
   background-color: gainsboro;
   font-size: 140%; font-weight: bold; word-spacing:0.2em;
}

.footer {
   padding:0.6em 0.5em 0.6em 1em;
   border:1px solid lightslategray; border-radius:1px;
   background-color: gainsboro;
   font-size: 90%; font-weight:bold;
}

.topic {
   padding:0.1em 0.1em 0.1em 1em;
   font-size: 120%; font-weight: bold; text-decoration:underline;
}

</style>

</head>
<body bgcolor="#ffffff" text="#000000" link="#0000cc" vlink="#0000cc">

<div class="header"><span class="hyperspi">HyperSPI</span> Help</div>

<blockquote>

<p> <span class="hyperspi">HyperSPI</span> provides graphical representations
of selected VMS system performance indicators.  These indicators can be used to
help assess the overall performance of a system, or to assist in the
identification of probable factors in instances of observed poor performance.

<p> This facility has been provided primarily for those involved in VMS 
systems management, but is also available for the general user to gain some 
appreciation of what a particular system is doing at any particular stage of 
the day or week.  <I>(It has not been provided to facilitate the creation of 
a dozen systems performance experts</I> <TT>:^)</TT> <I>)</I>

</blockquote>

<div class="topic">How It Works</div>

<blockquote>

<p> The facility comprises two distinct components:

<ol>

<li> The <b>data gathering</b> application.  This permanently executes on 
selected systems.  It obtains specific data from the VMS System Performance 
Interface once a second.  This is accumulated for a period of one minute 
before being output as peaks and averages to on-disk storage.  The one second 
collection period provides excellent granularity for observing peak 
behaviours, while the one minute recording period provides sufficient 
granularity for meaningful observation of short-duration trends (within an 
hour) as well as long-term behaviours (days or weeks), all without consuming 
significant amounts of mass-storage.  The data gathering utility has minimal 
impact on the system it is recording, less than one-tenth of one percent of 
one CPU, measured on AXP systems. 

<p>
<li> The <b>data processing/presentation</b> application.  This is designed to 
use the hypertext-interface of a browser such as Mosaic, employing the 
<I>forms</I> HTML facility to provide a versatile and easy-to-use interface for 
selection of the data to be presented, as well as the browser's image display 
capabilities, to present graphs of performance data integrated with textual 
information.  Data is processed on-demand, meaning graphs are generated 
dynamically, allowing simple, rapid assessments of current and recent 
performance, as well as longer-term overviews in versatile combinations of 
periods and factors. 

</ol>

</blockquote>

<div class="topic">Selection of Data</div>

<blockquote>

<p> A <a target="_blank" href="/cgi-bin/hyperspi">menu of options</a>
is presented allowing selection by <I>radio-button</I> 
(one of multiple), <I>checkbox</I> (one or more of multiple), and direct 
textual input.

<ul>

<li> <b>System</b>
<br> A series of <I>radio-buttons</I> allows selection of the system to be 
processed.

<p>
<li> <b>Period</b>
<br> A series of <I>radio-buttons</I> allows selection of one of a number of 
standard periods for processing and display of the data. From 7am up to and
including the current hour of the day is selected by default.  Alternatively,
the starting and ending time and date may be explicitly specified. 

<p>
<li> <b>Category</b>
<br> A series of <I>checkboxes</I> allow selection of one or more data 
categories for processing and display.  A combination useful for basic 
assessment is selected by default.  These may be deselected, others added, and 
so forth.  More than four categories tends to become cluttered. 

</ul>

<p> When ready, click on the <I>process</I> button to process and present the 
selected data.  The <I>double-height graph</I> checkbox allows graphs to be 
generated with an X axis twice the normal size.  This can be useful when 
examining a specific category in greater detail, but can make a multi-category 
display more difficult to overview.  The <I>reset</I> button returns all 
selectors to default. 

<p> A slightly more
<a target="_blank" href="/cgi-bin/hyperspi?do=ComprehensiveMenu">comprehensive menu</a>
is available.

</blockquote>

<div class="topic">Presentation of Data</div>

<blockquote>

<p> The data selected by category and period is presented as a single page of 
text and graphic.  The page is titled with the system name, the period the 
data represents, and a short description of the system (number of CPUs, 
memory, etc.). 

<p> Graphs are simple two-dimensional representations providing time along the 
X axis (graduated in hours and days), and quantity along the Y axis (either as 
a percentage of total available or as an absolute quantity).  A short 
description of the graph and applicable scales, averages and maxima are 
provided following the graph.  Graphs may contain one or two quantities, 
presented as a filled histogram, and/or as plotted points.  The following 
example illustrates each component: 

<p> <img src="ExampleGraph.gif" alt="[image]">

<ol>

<li> <b>X Axis</b> ... the period, graduated in hours and days (if applicable)

<li> <b>Y Axis</b> ... the quantity, appropriately graduated 

<li> <b>Data Available</b> ... a horizontal line below the X axis indicating 
data was available for that sample time (gaps in data can thus be 
discriminated from zero quantities, as illustrated by the gap near <TT>3a</TT>) 

<li> <b>Current Time</b> ... a small vertical bar at the end of the data
available indicator (if current time falls within the specified period)

<li> <b>Histogram</b> ... each datum is represented by a bar

<li> <b>Plotted</b> ... each datum is represented by a plot point (these may 
or may not form a (semi-)continuous line, depending on the data characterstics,
here scattered due to a highly variable quantity)

</ol> 

</blockquote>

<div class="footer">HyperSPI v2.1;&nbsp; October 2014</div>

</body>
</html>