SirMon background monitor

From m204wiki
Revision as of 22:43, 10 May 2017 by JAL (talk | contribs) (mention RKWeb equivalents)
Jump to navigation Jump to search

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 subsystem class (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.

The Background Monitor is not available in the RKWeb interface.

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=102928"