home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / lan2 / sam106.lzh / SAM.DOC next >
Text File  |  1990-05-29  |  5KB  |  142 lines
  1. SAM Version 1.06 - Server Activity Monitor for LANtastic (tm) networks
  2.  
  3.   Copyright (C) 1989, 1990 Humbleware Custom Programming
  4.   247 Paul Martin Drive
  5.   Baltimore, MD 21227
  6.   (301) 799-1975
  7.  
  8. What is SAM?
  9.  
  10.      SAM is an acronym for Server Activity Monitor.
  11.  
  12.  
  13. Why do I need SAM?
  14.  
  15.      If you have a "dedicated" server in your system and have
  16.      wished for a network monitor that could be run without human
  17.      intervention and that would give you a quick assessment of
  18.      network activity with just a quick look over your shoulder
  19.      then SAM is the answer.
  20.  
  21.  
  22. Why was SAM written?
  23.  
  24.      The server monitoring capabilities built into the NET
  25.      program are fine for a quick look-see at a network server.
  26.      The trouble with the NET program is that it requires that
  27.      you sit there and tap the space-bar repeatedly to update the
  28.      monitor screen. Like I said, fine for a quick look-see but
  29.      not very good for real-time server monitoring.
  30.  
  31.      Also, some of the information provided by the NET monitor
  32.      option is irrelevant to most network supervisors. I took the
  33.      items that I felt were most needed and tossed the rest away.
  34.      SAM will show you these items:
  35.  
  36.      1) The name of each machine logged into the server
  37.      2) The name of each user logged into the server
  38.      3) The privileges assigned to each user
  39.      4) The last command issued by each user
  40.      5) The number of bytes each user has sent/received
  41.  
  42.  
  43. How do I use SAM?
  44.  
  45. Usage: SAM ServerName [Interval]
  46.  
  47.   [Interval] = 0 to 300 seconds.
  48.  
  49.      SAM Server    - Monitors Server and updates screen continuously. 
  50.      SAM Server 60 - Monitors Server and updates screen every 60 seconds.
  51.  
  52.      SAM requires only one command line parameter to operate. You
  53.      must specify the name of a server that you are currently
  54.      logged into. The double backslashes "\\" are not required
  55.      when specifying the server name.
  56.  
  57.      The Interval parameter is optional. If you do not provide an
  58.      interval parameter then SAM will default to updating the
  59.      screen continuously. You may override the default by
  60.      specifying an interval of 0 seconds (continuous update) to
  61.      300 seconds (update every 5 minutes).
  62.  
  63.  
  64. Enhancements:
  65.  
  66.      SAM 1.05: 
  67.  
  68.      Some LAN operators have noticed that the system clock in
  69.      their servers will occasionally lose a day or two for no
  70.      apparent reason.  This problem stems from the fact that DOS
  71.      will not do any "maintenance" of the system clock unless a
  72.      DOS time/date function call is made by an application
  73.      program.  This "maintenance" of the system clock is pretty
  74.      straightforward.  If a program makes a DOS time/date
  75.      function call, DOS will do two things:
  76.  
  77.      a) DOS will go to the BIOS data area and read the current
  78.      number of clock ticks since midnight and calculate the time
  79.      from this number.
  80.  
  81.      b) DOS will then look for the midnight rollover flag to see
  82.      if a midnight has passed since the clock was queried last.
  83.      If the midnight rollover flag is set DOS increments its
  84.      internal date count and lowers the midnight rollover flag.
  85.  
  86.      The trouble with this scenario is that DOS has no way of
  87.      knowing if more than one midnight has passed since the last
  88.      time the clock was queried.  I the clock is queried at least
  89.      once every 24 hours then the system clock is maintained
  90.      properly.
  91.  
  92.      For most users this is not a problem since they usually turn
  93.      their systems on/off at least once a day or reboot their
  94.      system or run an application program that asks DOS for the
  95.      current time and date.  All of these things cause DOS to
  96.      fetch the current date and time from the system clock and
  97.      perform any maintenance needed.
  98.  
  99.      Now in the case of a LAN server it can happen that the
  100.      server may run for days without any activity at all such as
  101.      over a weekend.  In this case the system will have run for
  102.      more than 24 hours without the benefit of any DOS time/date
  103.      function calls being made.
  104.  
  105.      To correct this DOS/BIOS quirk I added some code to SAM that
  106.      monitors the BIOS data area for the "midnight rollover
  107.      flag."  If SAM detects that midnight has passed it will
  108.      issue a DOS function call to read the date thus forcing the
  109.      system time/date to be maintained properly.
  110.  
  111.  
  112.      SAM 1.06:
  113.  
  114.      The I/O bytes field would overflow if more than 999,999,999
  115.      bytes of data had been registered.  This produced the
  116.      expected "%" (overflow) sign in front of the I/O bytes
  117.      field.  Since I routinely see this condition on the LANs I
  118.      operate I chose to increase the length of the I/O Bytes
  119.      field by one digit.
  120.  
  121.      The I/O Bytes field has been increased in size to display 10
  122.      digits ie: 0,000,000,000 I/O Bytes.  The actual number of
  123.      I/O bytes that can be displayed is 4,294,967,296 I/O Bytes.
  124.      If the number of I/O Bytes exceeds this value the counter
  125.      will simply rollover to zero and begin again.
  126.  
  127.  
  128. Comments:
  129.  
  130.      Please send any comments or suggestions to:
  131.  
  132.           Humbleware Custom Programming
  133.           247 Paul Martin Drive
  134.           Baltimore, MD 21227
  135.           Attn: Larry Westhaver
  136.  
  137.      or you may leave a voice message at this number:
  138.  
  139.           (301) 799-1975
  140.  
  141.  
  142.