home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / iprates.zip / readme.doc < prev   
Text File  |  1996-07-01  |  5KB  |  108 lines
  1.             
  2. IPRATES.CMD                                           1 July 1996
  3.  
  4. What It Is:
  5.     Graphical display of the TCP/IP connection showing:
  6.         o Momentary and overall data receive rate
  7.         o Percent utilization (active time/total time)
  8.         o Momentary and overall data send rate
  9.  
  10. Requires: 
  11.     TCP/IP and VREXX (HOBBES - os2/ibm/ews/vrexx2.zip)
  12.  
  13. Parameters:
  14.     Single, numeric, value representing the amount of time 
  15.     (seconds) to wait between TCP/IP poll operations. Missing or 
  16.     invalid(character) values result in default wait of 10 
  17.     seconds. 
  18.  
  19. How To Install:
  20.     Copy IPRATES.CMD to the CMDs directory listed in your PATH. 
  21.     (You do have a CMDs directory, don't you?)  Create a program 
  22.     object which refers to IPRATES.CMD. 
  23.  
  24.     I've set the parameters to: [Wait] 1
  25.     which will prompt for a wait time. If I click on OKAY without 
  26.     entering a value then IPRATES will wait >1 second between poll 
  27.     operations. 
  28.  
  29.     Other program object settings you may want to set are:
  30.         [Session]   (check) Start minimized
  31.                     (uncheck) Close window on exit
  32.         [Window]    (radio) Display existing window - !required!
  33.         [General]   Assign any personally pleasing title
  34.                     Create/assign/find/modify any convenient icon
  35.  
  36. Warnings, Comments, Caveats:
  37.     [Window]    (radio) Display existing window - !required!
  38.     This is important. VREXX does not operate well when there are 
  39.     more than one(1) process using it at the same time.  Not sure 
  40.     why. 
  41.  
  42.     The display window is sized and positioned to occupy the 
  43.     upper-left 1/16th corner of the desktop window.  It may be 
  44.     resized and moved while running but, the new size and position 
  45.     are not remembered between invocations.  Again, VREXX does not 
  46.     return data to the REXX program about the window's position. 
  47.  
  48.     Several operational parameters (including window position and 
  49.     size) can be permanently changed by editing IPRATES.CMD. 
  50.  
  51.         BackGround = 'BLACK'    /* window background            */
  52.  
  53.         win_pos.top    = 100    /* position of       100+---+   */
  54.         win_pos.bottom = 75     /* window as            |   |   */
  55.         win_pos.left   = 0      /* percent of          0+---+   */
  56.         win_pos.right  = 25     /* maximum extents      0  100  */
  57.  
  58.         np = 50                 /* number of points to draw     */
  59.  
  60.         recv.0 = "GREEN"        /* colors with which to draw    */
  61.         rovr.0 = "CYAN"         /* the lines of the graph       */    
  62.         util.0 = "YELLOW"       /* VREXX supports color choices */
  63.         send.0 = "RED"          /*     BLACK WHITE RED GREEN    */
  64.         sovr.0 = "PINK"         /*     BLUE CYAN YELLOW PINK    */
  65.  
  66.     IPRATES must be started AFTER the TCP/IP connection has been 
  67.     established.  IPRATES may be terminated with Ctrl-Break in the 
  68.     (minimized) command window.  When IPRATES is stopped or the 
  69.     TCP/IP connection is broken the command window displays final 
  70.     statistics then waits for a keyboard entry.  The graph window 
  71.     will not be dismissed until the keyboard entry is received. 
  72.  
  73. Modifications:
  74.     28 June 1996 - initial release - worked okay but needed 
  75.         something 
  76.  
  77.     29 June 1996 - added the something missing. prior version 
  78.         would redraw the graph all over from the beginning on a 
  79.         redraw; (REXX meta-file?)  This version clears and redraws 
  80.         the display window for each poll interval.  Strangely 
  81.         enough, this was much more pleasing. 
  82.  
  83.     1 July 1996 - Final iteration - "production version" - 29 June 
  84.         did not rescale the "overall" graph when a new maximum was 
  85.         set.  Also, added axes to the graphs.  Receive rate marks 
  86.         the maximum with a vertical line; send rate marks the 
  87.         minimum (0 bytes/sec) with a vertical line.  Together, 
  88.         they mark the utilization graph.  Removed some commented 
  89.         instructions. 
  90.     
  91. Disclaimer:
  92.     I had a good time writing IPRATES.CMD.  If you have a good 
  93.     time using it, great.  I'll accept no responsibility for its 
  94.     use nor its interaction with your system.  If you use it then 
  95.     it's yours. 
  96.     
  97. Contacting The Author:
  98.     While I try to disown responsibility above, I am interested in 
  99.     any comments, suggestions, or (even) problems users may have. 
  100.     I may be most easily contacted at the e-mail address below. 
  101.  
  102.                      joropo@notes.cc.bellcore.com
  103.  
  104.     I hope you enjoy this small application.
  105.  
  106.     John Ross Porter, New Jersey, USA
  107.  
  108.