NAME
     mrmrpt    MichNet routers management report

     (tentative
      name)

SYNOPSIS
     mrmrpt [-l <usr> -h  <hours>  -s <time> -e <time> -u <number>
             -o <number> -p <pattern> -m <machine>] [keywords]

DESCRIPTION
     mrmrpt creates a summary report of MichNet routers' perform-
     ance with data gained from roverlogs in central data 
     monitoring machines.

     As a client, it uses the Berkeley trusted host facility, 
     plus its own  internal  list of trusted hosts.  The user 
     must have an account on one of the monitoring machines and
     must   have   an   entry  in  the /etc/hosts.equiv file or 
     in the .rhosts file in  the  user's home directory on the 
     monitoring machine.

     The user can indicate start and end time, using the  -h or
     -s  and  -e  flags.   If  a  start time is not given the
     default is 24 hours, and if no end  time  is  given,  the
     default is "now".

     The -u, -o, and -p flags are for filtering options, and if
     none is present, all MichNet routers will be displayed.

FLAGS
     -l   userid on server machine, if other than userid invoking
          client.

     -h   start time in hours prior to current time

     -s   start time  in  form  yymmddhhmmss.  -s  and  -h  flags
          are mutually exclusive.  Time need not be 12 char-
          acters, but can be  truncated;  it  is  zero-padded  on
          right.

     -e   end time, expressed same way as start time. Default  is
          keyword "now".

     -u   cut-off number that causes routers with uptime 
          percentage 'under' this value to be displayed.  The 
          number should not be smaller than 0, and may contain
          decimal value.

     -o   cut-off number that causes routers with uptime 
          percentage 'over' this value to be displayed.  The 
          number should not be greater than 100, and may contain
          decimal value.

     -p   pattern to match a sub-string of router's name.
 
     -m   data monitoring machine that is given higher priority
          over default machine.  If connection is unsuccessful,
          the priority is given back to default machine.


DIAGNOSTICS
     "Error: <error message from server>"


DEPENDENCIES
     See datarules and protocols for server.  These are  included
     in  distribution.  Also, trusted host file maintained by the
     server developers (contact nms@merit.edu).


EXAMPLES
     mrmrpt -s 920201 -e 920210 

     This creates a mamagement report of all MichNet routers from
     2/01/92 to 2/10/92.

     output:

                         Total Down  # Failure   Max. Down    Uptime
          Node             Minute     Occurred     Minute    Percentage
  --------------------  -----------  ----------  ----------  ----------
  MCH_ash.arbortext.co	     814         19          749       94.35%
 
  MCH_KZ3:Eth0-GW	     577        104           18       95.99%
  MCH_KZ3:0-->KZCOLL	     258         48           14       98.21%
 
  MCH_KZ1:Eth0-GW	     435         94           11       96.98%
  MCH_KZ1:0-->ANDY	     223         48           12       98.45%
 
  MCH_GVSU:1-->GRAND1	     366        106           28       97.46%
 
  MCH_ALMA:Eth0-GW	     355        157           28       97.53%
  MCH_ALMA:0-->CMU	     306        147           28       97.88%
 
  MCH_Ford-UM-GW:0->F	       0          0            0       100.00%
  MCH_Ford-UM-GW:Eth0	       0          0            0       100.00%
	.		       .	  .	       .	  . 
	.		       .	  .	       .	  . 
	.		       .	  .	       .	  . 
	.		       .	  .	       .	  . 

     mrmrpt -s 920101 -e 920201 -u 99.98 -p Mich1

     This creates a mamagement report with data from 1/01/92 to
     2/01/92 (all of January 1992) for interfaces with 'Mich1' in
     their names whose uptime percentage were under 99.98%. 

     output:

                         Total Down  # Failure   Max. Down    Uptime
          Node             Minute     Occurred     Minute    Percentage
  --------------------  -----------  ----------  ----------  ----------
  MCH_Mich1:-->ERIM	      20          2           18       99.86%
  MCH_Mich1:-->WMU	      14          5            3       99.90%
  MCH_Mich1:-->MTU	       7          3            3       99.95%
  MCH_Mich1:Eth2-WS	       5          1            5       99.97%
  MCH_Mich1:-->FL	       5          2            3       99.97%
  MCH_Mich1:-->WSU	       4          2            2       99.97%

  MCH_ERIM:0-->Mich1	      18          1           18       99.88%

     The 'Node' column displays abreviated names of router interfaces.
     The 'Total Down Minute' displays the sum of all down time, in
     minute, that had happened during specified period.  The 
     '# Failure Occurred' column displays the number of failure ( 
     failure count ) that had happened during specified period.  The
     'Max. Down Minute' represents the longest down period happened 
     during specified period.  The 'Uptime Percentage' column displays
     the percentage that the node is up during specified time period.


DESIGN
     The design of mrmrpt was borrowed from rtdata client to a large 
     extent.  It uses the BSD 4.3 socket interface to establish 
     connection with rtdata server and, when connected, sends 
     commands to the server to retrieve roverlogs data within 
     required time frame.  Upon receiving roverlogs data stream, it 
     calculates and saves downtime information for each router in a 
     data structure.  After all data are processed, it writes the 
     report to standard output in desired sequence. 

     
