SirMon user-initiated capturing of statistics - Revision history

JAL: misc cleanup

2015-11-03T22:48:58Z

misc cleanup

← Older revision		Revision as of 22:48, 3 November 2015
Line 6:		Line 6:
	statistics into a database file at user-specified intervals.		statistics into a database file at user-specified intervals.
	The statistics captured are the same as those displayed on		The statistics captured are the same as those displayed on
	the ~~System Overview Screen (~~[[SirMon System Overview screen]]).		the [[SirMon System Overview screen\|system overview screen]].

	Although <var class="product">SirMon</var> does not handle presentation of the captured statistics, you can write external programs to extract and display these		Although <var class="product">SirMon</var> does not handle presentation of the captured statistics, you can write external programs to extract and display these numbers. [[Contacting Rocket Software Technical Support\|Technical Support]] can also provide sample programs (including [[Janus Web Server\|Janus Web]]-based programs that allow the captured statistics to be downloaded into a spreadsheet or
	numbers. [[Contacting Rocket Software Technical Support\|Technical Support]] can also provide sample programs (including Janus Web-based programs that allow the captured statistics to be downloaded into a spreadsheet or
	displayed as vector graphics over time).		displayed as vector graphics over time).

	To verify that your site has the <var class="product">SirMon</var> Capture capability, check for the		To verify that your site has the <var class="product">SirMon</var> Capture capability, check for the
	existence of procedure <code>MOPR-CAPTURE</code> in the SIRIUS or SIRMON file.		existence of procedure <code>MOPR-CAPTURE</code> in the <code>[[SIRIUS file\|SIRIUS]]</code> or <code>SIRMON</code> file.

	Here is how the <var class="product">SirMon</var> Capture works:		Here is how the <var class="product">SirMon</var> Capture works:
	<ol>		<ol>
	<li>The optional file, <code>MONDATA</code>, must be allocated to the SIRMON		<li>The optional file, <code>MONDATA</code>, must be allocated to the <code>SIRMON</code> application subsystem.
	application subsystem.
	<p>		<p>
	MONDATA should have at least 1000 pages of Table B and 200 pages of Table D.		<code>MONDATA</code> should have at least 1000 pages of Table B and 200 pages of Table D.
	</p>		</p>
	Field definitions are:		Field definitions are:
Line 40:		Line 38:
	</ul>		</ul>
	<p>		<p>
	The <var>SIRMON CAPTURE</var> command locks up the thread it is executed on, so the sensible thing to do is to insert the command into a BATCH2 job, or		The <var>SIRMON CAPTURE</var> command locks up the thread it is executed on, so the sensible thing to do is to insert the command into a BATCH2 job, or to execute the command in an [[Sdaemons\|sdaemon]]. Here is a sample program that uses an sdaemon to run the command: </p>
	to execute the command in an sdaemon. Here is a sample program that uses an sdaemon to run the command: </p>		<p class="code">Begin
	<p class="code"~~><nowiki~~>Begin
	%s is float		%s is float
	%s = $ListNew		%s = $ListNew
Line 49:		Line 46:
	Call $ListDel(%s)		Call $ListDel(%s)
	End		End
	~~</nowiki>~~</p>		</p>
	<p>		<p>
	In the above ~~example~~, <var class="product">SirMon</var> would capture the ~~System Overview~~ statistics every 60 seconds for 10 hours.</p></li>		After the above request, <var class="product">SirMon</var> would capture the system overview statistics every 60 seconds for 10 hours.</p></li>

	<li>Review the captured data, which is stored as a single "TYPE=H" header record		<li>Review the captured data, which is stored as a single <code>TYPE=H</code> header record and a set of <code>TYPE=S</code> statistic records.
	and a set of "TYPE=S~~" stat~~ records.
	<p>		<p>
	The header and ~~stat~~ records are linked together by matching		The header and statistic records are linked together by matching
	starting-time values in the "SAMPLE" field.</p>		starting-time values in the <code>SAMPLE</code> field.</p>
	<p>		<p>
	The header record specifies the length of the intervals between samples, as		The header record specifies the length of the intervals between samples, as well as the names of the individual statistics (as values of a <code>STAT</code> field).
	well as the names of the individual statistics (as values of a STAT field).		The statistic records each have a time stamp (so they can be sorted in order by capture starting time), and they contain the captured value of each statistic (as a <code>STAT</code> field value) in the same order as listed in the header record.</p>
	The ~~stat~~ records each have a time stamp (so they can be sorted in order by capture starting time), and they contain the captured value of each statistic (as a STAT field value) in the same order as listed in the header record.</p>
	<p>		<p>
	An example of a header record is followed by an example of a ~~stat~~ record:</p>		An example of a header record is followed by an example of a statistic record:</p>
	<p class="code"><nowiki> TYPE = H		<p class="code"><nowiki> TYPE = H
	SAMPLE = 3291966206		SAMPLE = 3291966206

Admin: 1 revision: SirMon pages

2015-09-10T22:05:22Z

1 revision: SirMon pages

← Older revision	Revision as of 22:05, 10 September 2015
(No difference)

JAL: more conversion cleanup

2015-09-10T16:13:00Z

more conversion cleanup

New page

<var class="product">SirMon</var> includes a feature for capturing
statistics into a database file at user-specified intervals.
The statistics captured are the same as those displayed on
the System Overview Screen ([[SirMon System Overview screen]]).

Although <var class="product">SirMon</var> does not handle presentation of the captured statistics, you can write external programs to extract and display these
numbers. [[Contacting Rocket Software Technical Support|Technical Support]] can also provide sample programs (including Janus Web-based programs that allow the captured statistics to be downloaded into a spreadsheet or
displayed as vector graphics over time).

To verify that your site has the <var class="product">SirMon</var> Capture capability, check for the
existence of procedure <code>MOPR-CAPTURE</code> in the SIRIUS or SIRMON file.

Here is how the <var class="product">SirMon</var> Capture works:
<ol>
<li>The optional file, <code>MONDATA</code>, must be allocated to the SIRMON
application subsystem.

MONDATA should have at least 1000 pages of Table B and 200 pages of Table D.

Field definitions are:
IN FILE MONDATA DEFILE FIELD INTERVAL
IN FILE MONDATA DEFILE FIELD SAMPLE (ORD CHAR)
IN FILE MONDATA DEFILE FIELD STAT
IN FILE MONDATA DEFILE FIELD TIME
IN FILE MONDATA DEFILE FIELD TYPE (ORD CHAR)
</li>

<li>To initiate captures, execute this command:
SIRMON CAPTURE int samples

where:
<ul>
<li><var class="term">int</var> is the number of seconds between samples (60 seconds minimum) </li>

<li><var class="term">samples</var> is the number of samples to take (1440 maximum)</li>
</ul>

The <var>SIRMON CAPTURE</var> command locks up the thread it is executed on, so the sensible thing to do is to insert the command into a BATCH2 job, or
to execute the command in an sdaemon. Here is a sample program that uses an sdaemon to run the command: 
<nowiki>Begin
%s is float
%s = $ListNew
Call $ListAdd( %s, 'SIRMON CAPTURE 60 600')
Call $CommBG(%s)
Call $ListDel(%s)
End
</nowiki>

In the above example, <var class="product">SirMon</var> would capture the System Overview statistics every 60 seconds for 10 hours.</li>

<li>Review the captured data, which is stored as a single "TYPE=H" header record
and a set of "TYPE=S" stat records.

The header and stat records are linked together by matching
starting-time values in the "SAMPLE" field.

The header record specifies the length of the intervals between samples, as
well as the names of the individual statistics (as values of a STAT field).
The stat records each have a time stamp (so they can be sorted in order by capture starting time), and they contain the captured value of each statistic (as a STAT field value) in the same order as listed in the header record.

An example of a header record is followed by an example of a stat record:
<nowiki> TYPE = H
SAMPLE = 3291966206
INTERVAL = 120
TIME = 3291966206
STAT = RESPMED
STAT = RESP90
STAT = RESPAVG
STAT = VTAMBW
STAT = RSXCOMP
...

TYPE = S
SAMPLE = 3291966206
TIME = 3291966206
STAT = 0.00
STAT = 0.00
STAT = 0.00
STAT = 0
STAT = 0
STAT = 0.38
STAT = 3.86
STAT = 16.05
...
</nowiki>

The <code>TIME</code> field on each <code>S</code> record displays the actual time of the sample, while the <code>SAMPLE</code> field remains the same, allowing the records within a sample to be selected as a set.</li>
</ol>

==See also==
{{Template:SirMon topic list}}

[[Category: SirMon]]