home *** CD-ROM | disk | FTP | other *** search
/ IBM Presents OS/2 Software Hits 1995 / OS-2_SW_HITS_2ND_EDITION_1995.ISO / i17 / ur423841.dsk / CSDX.DFI / RUPOLL.DOC < prev   
Text File  |  1993-09-18  |  5KB  |  118 lines
  1. RUPOLL is a tool that uses LAN Network Manager 1.1's command line
  2. interface (LAN.EXE) to poll the ring utilization of many segments at a
  3. user-defined interval. The results of these queries are
  4. stored in a table created in the LAN Network Manager database,
  5. allowing you to create a history of ring performance similar to
  6. the Bridge Performance tables that come with LAN Network Manager 1.1.
  7.  
  8. RUPOLL will not produce any data unless LAN Network Manager is running
  9. on the same machine and is successfully reporting ring utilization for
  10. the rings you wish to query.
  11.  
  12. Requirements
  13. ------------
  14. LAN Network Manager 1.1 is required and must be capable of
  15. reporting ring utilization itself.
  16.  
  17. Using RUPOLL
  18. ------------
  19. When you start RUPOLL, you see a listbox of segments RUPOLL is
  20. currently polling and the polling interval. To start querying
  21. a segment, select the 'Add' pushbutton.
  22.  
  23. ADD - Specifies the segment you want to query and the query
  24.       interval in minutes. The minimum interval is 1 minute
  25.       (see Performance Considerations) and the maximum is 9999,
  26.       nearly one week.
  27.  
  28. At the specified interval, RUPOLL causes LAN.EXE to be executed
  29. and requests the ring utilization of the specified segment.
  30. If polling is successful, RUPOLL writes data into the
  31. RING_PERFORMANCE database table.
  32.  
  33. To change the frequency at which RUPOLL queries a segment,
  34. select the 'Change' pushbutton.
  35.  
  36. CHANGE - Changes the interval at which RUPOLL polls segments.
  37.          To change the segment number, add a new query.
  38.  
  39. The change dialog appears once for each segment selected in the
  40. listbox.
  41.  
  42. The delete button removes a query from RUPOLL's list and stops
  43. logging data for the selected segments. Delete works on every
  44. segment selected in the listbox. You are prompted once for
  45. confirmation.
  46.  
  47. RUPOLL does not use any LAN Network Manager DLLs and
  48. can be started and stopped independently of LAN Network Manager.
  49.  
  50. New Sessions in a Task List
  51. ---------------------------
  52. RUPOLL creates an OS/2 command session to execute LAN.EXE.
  53. RUPOLL appears in your task list as 'RUPOLL Poller Work Session'.
  54.  
  55. Performance Considerations
  56. --------------------------
  57. If LAN Network Manager has a significant level of activity,
  58. use RUPOLL with caution. RUPOLL uses almost no CPU time when
  59. idle. No performance concerns occur when RUPOLL queries a few
  60. segments at substantial intervals of time. If you query 60 segments
  61. at one minute intervals, however, RUPOLL may have performance problems.
  62.  
  63. Once each minute, RUPOLL will step through its list of segments
  64. to query. If a segment interval has expired, RUPOLL starts
  65. LAN.EXE through the OS/2 command session the RUPOLL spawned
  66. when it started. LAN.EXE then communicates with LAN Network
  67. Manager, which communicates with LAN Station Manager, which
  68. communicates with an adapter on the ring in question.
  69.  
  70. LAN Station Manager responds. LAN Network Manager sends the response
  71. back to LAN.EXE, which writes the information. RUPOLL reads
  72. the information and writes it to the database. The information
  73. passes through 5 processes (RUPOLL->CMD.EXE->LAN.EXE->LANM->LSM) on the
  74. way in and the same 5 on the way back, not including time spent
  75. sending a frame out to the reporting station on the ring, passing
  76. through bridges on the way. If RUPOLL runs 60 queries each minute,
  77. a query must complete in less than a second to give RUPOLL time to
  78. write the information to the database and start the next query.
  79.  
  80. RUPOLL is entirely dependent on LAN.EXE, which in turn is dependent
  81. on LAN Network Manager. Actual polling intervals will not correspond
  82. exactly to the intervals you requested. In practice, each interval
  83. requires additional time. When a query runs slowly, it has a domino
  84. effect on the queries following it. RUPOLL has to wait for each
  85. invocation of LAN.EXE to finish. LAN.EXE is synchronous and cannot
  86. execute 2 copies at the same time. If one query takes a long time
  87. to complete, RUPOLL will be late starting the next query.
  88.  
  89. Technical Information
  90. ---------------------
  91. RUPOLL executes a session of CMD.EXE through DosStartSession and
  92. redirects the stdin, stdout and stderr of that session to anonymous
  93. pipes which RUPOLL created before starting the session. RUPOLL has
  94. a write pipe which mimics stdin of the OS/2 session and a read pipe
  95. which traps anything going to stdout.
  96.  
  97. Each segment/interval combination is stored as a node in a linked list.
  98. At initialization, RUPOLL starts a timer with WinStartTimer which pops
  99. once per minute. On each timer tick, a second thread walks the list and
  100. checks to see which query has waited long enough. For each query
  101. whose interval has expired, RUPOLL writes the command
  102. 'lan segment util seg=xxx' to the pipe which mimics stdin and
  103. then monitors the read pipe for LAN.EXE's output. Once RUPOLL
  104. receives the output, it parses the output, writes that data
  105. to the RING_PERFORMANCE table, and continues traversing the linked list.
  106.  
  107. Data in the database table includes:
  108.  
  109. Segment number the given record relates to.
  110. Time the record was generated.
  111. Date the record was generated.
  112. Interval (in seconds) between the time this record and the last
  113.    was logged.
  114. Date and time represented as the number of seconds
  115.    since 1/1/1970 (this number will wrap in the year 2038).
  116. Ring utilization expressed as xxx.x%.
  117.  
  118.