SirMon background monitor: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (reduce size of graphic)
m (misc cleanup)
Line 3: Line 3:
You've been warned.  ..  (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->
You've been warned.  ..  (Page built by JAL at the SIRIUS VM; file: FUNPGNEW SYSUT2) -->
<!-- Page name: SirMon background monitor-->
<!-- Page name: SirMon background monitor-->
The Background Monitor is a User Language application subsystem designed
The Background Monitor is a SOUL application subsystem designed
to execute as a "background" process, that is, without a terminal.
to execute as a "background" process, that is, without a terminal.
Once started, the Background Monitor examines <var class="product">Model 204</var> performance on a
Once started, the Background Monitor examines <var class="product">Model&nbsp;204</var> performance on a regular basis, and it generates alerts if a statistic on the [[SirMon System Overview screen|system overview]] screen exceeds its threshold for more than a user-specifiable number of monitoring intervals.
regular basis and generates alerts if a statistic on the System Overview
screen exceeds its threshold for more than a user-specifiable number of
monitoring intervals.


the PF2 key from either the System Overview screen or the Threshold
the PF2 key from either the system overview screen or the <b>Thresholds</b> screen causes the the <b>Background Monitor</b> screen to be displayed. The <b>Background Monitor</b> screen provides control over certain characteristics of the Background Monitor, and also allows users in the [[ADMIN SCLASS]] to start the Background Monitor.
Specification screen causes the the Background Monitor screen to be displayed.
The Background Monitor may also be started from the <var class="product">Model&nbsp;204</var> command line, as described at the end of this section.
The Background Monitor screen provides control over certain characteristics of
the Background Monitor, and also allows users in the "ADMIN" SCLASS to
start the Background Monitor.
The Background Monitor may also be started from the <var class="product">Model 204</var> command
line, as described at the end of this section.


<p class="caption" style="width:475px">Background Monitor screen</p>
<p class="caption" style="width:475px">Background Monitor screen</p>
<p class="figure">[[File:SmonBackground.png|475px]]</p>
<p class="figure">[[File:SmonBackground.png|475px]]</p>


==Setting up the Background Monitor==
User-defined characteristics of the Background Monitor are:
User-defined characteristics of the Background Monitor are:


<table class="thJustBold">
<table class="thJustBold">
<tr><th>Default monitoring interval (seconds)</th>
<tr><th>Monitoring interval (secs)</th>
<td>Specifies the number of seconds between Background Monitor samples.</td></tr>
<td>The number of seconds between Background Monitor samples.</td></tr>


<tr><th>Send warnings after (number of intervals)</th>
<tr><th>Num intervals before warning sent</th>
<td>Allows the Background Monitor to ignore situations where a statistic only momentarily exceeds its threshold.
<td>The number of consecutive monitoring intervals during which a statistic must be above its threshold before the background monitor will send warning messages.  
<p>
<p>
This parameter suppresses the warning unless a problem is detected for
This setting effects only the background monitor: The system overview screen always highlights statistics that have exceeded their thresholds, in real time. </p></td></tr>
a number of consecutive monitoring intervals. For example, if this parameter is set to 3, and the monitoring interval is set to 30 seconds, a warning is issued only if a problem persists for 90 seconds or more (3 consecutive samples separated by 30-seconds each).</p>
 
<p>
<tr><th>Skip minutes at start of run</th>
Note that all these settings are applied <i>per statistic</i>, so for instance, if DKRD-per-screen and DKPR-per-screen both exceed their threshold for two intervals, then DKRD-per-screen returns to a sub-threshold level and DKPR-per-screen does not, the counter for DKRD is reset to 0 and a warning is issued for DKPR-per-screen (again, using the example where this parameter is set to 3). </p></td></tr>
<td>Many SirMon threshold settings may be exceeded during Online initialization due to procedure compilations and other site-specific environment initialization jobs. To prevent SirMon's background task from sending excessive warnings during this time, the background task can be quiesced for up to 999 Online initial minutes. Typically you might set this to from 4 to 10 minutes. </td></tr>


<tr><th nowrap>Minimum minutes between warning messages</th>
<tr><th nowrap>Minutes between warning messages</th>
<td>Prevents a storm of messages from being generated in response to a single problem, which could be especially annoying while you are already working on the problem. The "time of last warning" is maintained for each monitored statistic.
<td>Prevents a storm of messages from being generated in response to a single problem, which could be especially annoying while you are already working on the problem. The "time of last warning" is maintained for each monitored statistic.
Once a warning is sent for a statistic, the number of minutes specified in
<p>
this parameter must pass before another warning will be issued for that statistic.</td></tr>
Once a warning is sent for a statistic, the number of minutes specified here (integer between 0 and 9999) must pass before another warning is issued for that statistic.</p></td></tr>


<tr><th>Don't warn during first xxx online minutes</th>
<tr><th>Send warnings to the journal? (Y/N)</th>
<td>Prevents the Background Monitor from generating performance alerts during
<td>Directs the Background Monitor to log a <code>US</code> line on the <var class="product">Model&nbsp;204</var> journal in addition to any Online user notifications.</td></tr>
the early phases of online initialization when one would expect a lot of unusual activity.</td></tr>


<tr><th>Send warnings to the journal? (Y/N)</th>
<tr><th>Minutes between HWM warnings</th>
<td>Directs the Background Monitor to log a US line on the <var class="product">Model 204</var> journal in addition to any online user notifications.</td></tr>
<td>Certain statistics are never decremented, primarily High Water Mark indicators like <var>[[SNAPID parameter|SNAPID]]</var>, [[System statistics displayed in SirMon|CCATMHP]], and [[System statistics displayed in SirMon|SDMACTH]]. Once the threshold is exceeded for one of these statistics, message recipients would get a warning message about it at every sampling interval. This field setting prevents this condition by allowing the administrator to specify a number of minutes once an initial message has been sent (between 1 and 9999) to suppress warnings about these thresholds.
<p>
This field lets you safely set the threshold for <var>SNAPID</var> to 1, so someone is sent a warning whenever a single snap occurs, without the risk that their in-box or cell phone will be flooded with messages until the Online is cycled. </p></td></tr>


<tr><th>Users to receive warning messages (separate by blanks)</th>
<tr><th>M204 userids to receive warning messages (blank separated</th>
<td>Directs the Background Monitor to send an online warning to the listed user(s) when a threshold is exceeded for the requisite number of consecutive monitoring intervals. The special user <code>OPR</code> causes the warning message to be sent to the console operator for the <var class="product">Model 204</var> online.</td></tr>
<td>Directs the Background Monitor to send an online warning to the listed user(s) when a threshold is exceeded for the requisite number of consecutive monitoring intervals. The default, <code>OPR</code>, sends the warning message to the console operator for the <var class="product">Model&nbsp;204</var> Online.</td></tr>
</table>
</table>


The PF12 key saves the Background Monitor characteristics.
The PF12 key saves the Background Monitor characteristics.
The PF5 key causes the Background Monitor to be started in an sdaemon
The PF5 key causes the Background Monitor to be started in an [[Sdaemons|sdaemon]] thread. If the Background Monitor is already running in an sdaemon thread, the PF5 key bumps the previously running Background Monitor and starts a new occurrence.
thread (see the <i>Sirius Mods Installation Guide</i>
 
for information about sdaemons).
==Command level initiation==
If the Background Monitor is already running in an sdaemon thread,
<var class="product">SirMon</var> also provides a <var class="product">Model 204</var> command level interface for starting the Background Monitor. The following command could be inserted into the User&nbsp;0 input stream or entered at a terminal to cause the <var class="product">SirMon</var> Background Monitor to be started in an sdaemon thread:
the PF5 key bumps the previously running Background Monitor and
<p class="code">SIRMON BACKGROUND</p>
starts a new occurrence.
 
If the Background Monitor is already running in an sdaemon thread,  
the command bumps the previously running Background Monitor and starts a new occurrence.
 
The Background Monitor may also be started for execution within any Model&nbsp;204 thread by issuing:
<p class="code">SIRMON SDAEMON</p>


<var class="product">SirMon</var> provides a <var class="product">Model 204</var> command level interface for starting the Background Monitor.
This command can be issued on a terminal thread, but the terminal will lock up the until the thread is closed by <var>BUMP</var>, since the background task does not perform any terminal I/O.
The following command could be inserted into the User 0 input stream
or entered at a terminal to cause the <var class="product">SirMon</var> Background Monitor to be started in an sdaemon thread:
up the until the thread is BUMPed, since the background task does not
perform any terminal I/O.


==See also==
==See also==

Revision as of 22:41, 30 October 2015

The Background Monitor is a SOUL application subsystem designed to execute as a "background" process, that is, without a terminal. Once started, the Background Monitor examines Model 204 performance on a regular basis, and it generates alerts if a statistic on the system overview screen exceeds its threshold for more than a user-specifiable number of monitoring intervals.

the PF2 key from either the system overview screen or the Thresholds screen causes the the Background Monitor screen to be displayed. The Background Monitor screen provides control over certain characteristics of the Background Monitor, and also allows users in the ADMIN SCLASS to start the Background Monitor. The Background Monitor may also be started from the Model 204 command line, as described at the end of this section.

Background Monitor screen

Setting up the Background Monitor

User-defined characteristics of the Background Monitor are:

Monitoring interval (secs) The number of seconds between Background Monitor samples.
Num intervals before warning sent The number of consecutive monitoring intervals during which a statistic must be above its threshold before the background monitor will send warning messages.

This setting effects only the background monitor: The system overview screen always highlights statistics that have exceeded their thresholds, in real time.

Skip minutes at start of run Many SirMon threshold settings may be exceeded during Online initialization due to procedure compilations and other site-specific environment initialization jobs. To prevent SirMon's background task from sending excessive warnings during this time, the background task can be quiesced for up to 999 Online initial minutes. Typically you might set this to from 4 to 10 minutes.
Minutes between warning messages Prevents a storm of messages from being generated in response to a single problem, which could be especially annoying while you are already working on the problem. The "time of last warning" is maintained for each monitored statistic.

Once a warning is sent for a statistic, the number of minutes specified here (integer between 0 and 9999) must pass before another warning is issued for that statistic.

Send warnings to the journal? (Y/N) Directs the Background Monitor to log a US line on the Model 204 journal in addition to any Online user notifications.
Minutes between HWM warnings Certain statistics are never decremented, primarily High Water Mark indicators like SNAPID, CCATMHP, and SDMACTH. Once the threshold is exceeded for one of these statistics, message recipients would get a warning message about it at every sampling interval. This field setting prevents this condition by allowing the administrator to specify a number of minutes once an initial message has been sent (between 1 and 9999) to suppress warnings about these thresholds.

This field lets you safely set the threshold for SNAPID to 1, so someone is sent a warning whenever a single snap occurs, without the risk that their in-box or cell phone will be flooded with messages until the Online is cycled.

M204 userids to receive warning messages (blank separated Directs the Background Monitor to send an online warning to the listed user(s) when a threshold is exceeded for the requisite number of consecutive monitoring intervals. The default, OPR, sends the warning message to the console operator for the Model 204 Online.

The PF12 key saves the Background Monitor characteristics. The PF5 key causes the Background Monitor to be started in an sdaemon thread. If the Background Monitor is already running in an sdaemon thread, the PF5 key bumps the previously running Background Monitor and starts a new occurrence.

Command level initiation

SirMon also provides a Model 204 command level interface for starting the Background Monitor. The following command could be inserted into the User 0 input stream or entered at a terminal to cause the SirMon Background Monitor to be started in an sdaemon thread:

SIRMON BACKGROUND

If the Background Monitor is already running in an sdaemon thread, the command bumps the previously running Background Monitor and starts a new occurrence.

The Background Monitor may also be started for execution within any Model 204 thread by issuing:

SIRMON SDAEMON

This command can be issued on a terminal thread, but the terminal will lock up the until the thread is closed by BUMP, since the background task does not perform any terminal I/O.

See also

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=SirMon_background_monitor&oldid=81490"