TSP Lab SgaWMPol - The monitor poller SgaWMPol

The monitor poller module
("SgaWMPol")

Features

Basic operation

User interface

The main menu

Menu Menuitem Shortcut(s) Meaning
[Actions]
  Reload monitor units data   Reload link data for monitor units from SL.dat file
  Force monitor unit time sync () Forces monitor units to perform NTP synchronization immediately
[Log]
  Find line containing... (Ctrl-F) Finds text in log window
  Find next matching line (F3) Finds next occurrence of text in log window
  Details   Detail level of logging (Off, Normal, Detailed, or Debug)
  Log "Monitor OK" queries and results   Writes "Monitor OK" queries and results into screen and log file
[Options]
  Accept monitors (Ctrl-A, or ) Allows the Monitor units connecting to the server
  Auto-query monitors (Ctrl-Q, or )
  Auto scroll (ScrollLock, or ) Allows automatic scrolling of the log screen
  Show log (Ctrl-Tab) Shows the log screen
  Show monitor status (Ctrl-Tab) Shows the monitor status screen
  Save settings   Saves actual settings into the configuration (SgaWMPol.ini) file

The popup menu of the monitor status screen

Right-click on the monitor status screen window to access this menu!
  Menuitem Shortcut(s) Meaning
  Ping this monitor (and gets its version info)   Checks the connection with the Monitor unit and gets the version information of the Monitor.exe program and the SGA card SS7 firmware code (object code).
  Abort current remote capturing session on this Monitor   This feature is not implemented in this version!
  Abort current http session on this Monitor   Forces the Monitor unit to close its active http connection
  Reload OpPref.cfg and IMSIPref.cfg on this Monitor   Reloads the OpPref.cfg and IMSIPref.cfg files on this Monitor unit
  Reload OpPref.cfg on this Monitor   Reloads the OpPref.cfg file on the Monitor unit
  Reload IMSIPref.cfg on this Monitor   Reloads the IMSIPref.cfg file on the Monitor unit
  Disconnect this Monitor from Server (Poller)...   Disconnects the selected Monitor unit from the server in the normal way (gracefully) or immediately by breaking low layer sockets (immediately)
  Restart this Monitor...   Restarts the selected Monitor unit at specified time (can be one of the following: immediately, 5 minutes later or at 3:00 AM), what means restarting the Monitor.exe program module.
It is also possible to reboot the monitor machine, which is done by the watch-dog module. "... and forget MSUs" options are unavailable in this version.
  Cancel previous restart request for this Monitor   Cancels previous restart request for the selected Monitor unit
  File upload for this (DOS) Monitor   Uploads a file to the selected (DOS) Monitor unit. It is possible to specify the local file for upload and the remote name in a dialog window. Without giving the full path for remote file, it will be saved in the C:\Monitor directory. It is also possible to delete a remote file by selecting this menu item with empty local file name.

The bottom status-line

Configuration (INI) file settings

Section Entry Example Meaning
[Position]
  iLeft 140 Position of the program module on the display screen
  iTop 72 Position of the program module on the display screen
  iWidth 995 Position of the program module on the display screen
  iHeight 694 Position of the program module on the display screen
[Options]
  bAutoQuery True (Refer to the [Options]/Auto scroll menu item!)
  bAutoScroll True (Refer to the [Options]/Auto-query monitors menu item!)
[Advanced]
  wLocalTCPPort 8000 Port number where the Poller accepts the connection of the Monitor
  wLogDetailLevel 3 (Equals to the listed order; refer to the [Log]/Details menu item!)
  dwMaxLinesInLogWindow 1000 Number of lines in the log window on screen
  sDataPath d:\DataFiles Path for the temporary datafiles
  sLogFilesPath d:\LogFiles Path for the LOG files
  sTrapFilesPath d:\TrapFiles Path for the SNMP Trap files to be sent
  bCeaseBeforeSwitchingAlertLevel True Send a CEA SNMP trap before switching alert level (e.g., from WAR to CRI) for the very same error
  bAlternateTrapUID False Enables or disables generation of traps with alternate UID

SNMP Traps

Type Text Remarks
INF 'Sga-WM Monitor Poller v1.11' module is started. When Poller is started.
INF Connection to Monitor at [IPNumber] is up. When a monitor from [IPNumber] is connected.
WAR/CEA Connection to Monitor at [IPNumber] is down. [***] where [***] can be: "(closed)", "(operator)", "(reconnecting)" for CRI, and none for CEA
CEA when indicated Monitor is 'up' again
WAR/CEA "Is Monitor OK?" query of Monitor at [IPNumber] timed-out. CEA when indicated Monitor responds again
WAR 'Sga-WM Monitor Poller v1.11' module has been shut down by operator. a farewell WARning message

Version history

Known bugs