SirMon background monitor
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 bottom of this page.
The Background Monitor is not available in the RKWeb interface.
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
|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 |
|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 user IDs to receive warning messages||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, |
|Email Port Name||To send warnings via email, the site must have a copy of Janus Sockets, and you must have defined and started a client socket port. You can use something like this for port definition and startup: |
JANUS DEFINE EMAILC * CLSOCK 5 IBSIZE 4096 OBSIZE 8192 JANUS START EMAILC
|SMTP Port Number||Port number for the SMTP server used to send email messages on the specified SMTP server host (below). The correct setting is almost always the default, 25.|
|SMTP Host||Host for the STMP server. Generally this will be the IP address or host name of the machine on which Model 204 is running.|
|Time Zone Offset||Used in the email header, this should specify the timezone offset from Greenwich Mean Time (-0500 is Eastern Standard Time for the United States east coast, which is the default).|
|From name||The name for the "From:" header of warning emails.|
|From addr||The email address for the "From:" header of warning emails.|
|Subject||The content of the "Subject:" header of warning emails.|
|E-mail addresses to receive warnings||For the format of the address, use |
|Would you like to send warning messages to a cell phone?||Most cell service providers permit sending email messages to phones
via ordinary SMTP email services. Each provider uses a different domain, of course, but they should be easy to identify on their company web site.
The format for most of them is to use the
phone number as the email address: Cingular's format is
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:
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:
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.
- SirMon application structure
- SirMon main menu
- SirMon System Overview screen
- SirMon threshold setting
- SirMon background monitor
- SirMon System Monitor menu
- SirMon User Monitor menu
- SirMon File Monitor menu
- SirMon Subsystem Monitor menu
- SirMon Task Monitor menu
- SirMon Janus Monitor menu
- SirMon custom screens
- SirMon critical-file-resource monitoring
- SirMon user-initiated capturing of statistics
- System statistics displayed in SirMon
- User statistics displayed in SirMon
- File statistics displayed in SirMon
- Subsystem statistics displayed in SirMon
- Task statistics displayed in SirMon
- Critical File Resource statistics displayed in SirMon
- SirMon date processing