home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / geo_ense / dumperf.zip / README.TXT < prev   
Text File  |  1993-10-07  |  9KB  |  169 lines
  1. This README.TXT file contains instructions for using Perf and the 
  2. Screen Dumper for GEOS 2.0. Place the application files in your 
  3. \WORLD directory in Ensemble 2.0 and double click on their icons
  4. to run them.
  5.  
  6. Copyright (c) 1993 Geoworks. All rights reserved. These
  7. files may be distributed to registered owners of
  8. GeoWorks Ensemble under the terms of the GeoWorks
  9. Software License Agreement. Any other use is expressly
  10. forbidden. These files provided on an "as is" basis, 
  11. without warranty of any kind.
  12.  
  13. Screen Dumper and Perf are provided free of charge
  14. as unsupported GEOS applications. If you experience problems with these
  15. applications, we'd like to know about them, but we do not guarantee 
  16. suitability of this software on any system for any purpose.
  17.  
  18. Instructions for Screen Dumping
  19.  
  20. Screen Dumper for GEOS 2.0 defaults to placing the screen dump on
  21. the GEOS clipboard. Subsequent screen dumps will replace the item
  22. on the clipboard, so remember to Paste the clipboard into a GEOS application
  23. (GeoDraw, Scrapbook, etc.) before making your next screen dump, when 
  24. using the clipboard format.
  25.  
  26. The text below is available by clicking the Help menu item in the 
  27. Screen Dumper.
  28.  
  29. The following keystrokes are recognized by Dump when the system is
  30. running normally:
  31.  
  32. Ctrl-Shift-Tab  Freezes the screen and causes Dump to pay
  33.                 attention to the function keys as commands.
  34.                 No further input is passed to any application or the
  35.                 UI. The pointer may be freely moved around the
  36.                 screen (but not onto another screen) and will be
  37.                 brought back to its starting point when the screen
  38.                 is thawed.
  39. Shift-PrtScr    Creates a dump of the entire screen on which the
  40.                 pointer is currently located. Does not remove the
  41.                 pointer image first.
  42.  
  43.  
  44. The following keystrokes are recognized only when the screen has been
  45. frozen with Ctrl-Shift-Tab:
  46.  
  47. Esc             Thaws the screen without dumping any piece of it.
  48. F1              Bring up the main parameters box again after it's
  49.                 been banished, in case you need to change any of
  50.                 the dumping parameters.
  51. F2              This is currently inactive.
  52. F3              Dumps the window under the pointer after removing
  53.                 the pointer from the screen.
  54. F4              Dumps the window under the pointer, leaving the
  55.                 pointer image on the screen.
  56. F5              Shows the current dump rectangle. The rectangle
  57.                 remains on screen, where it can be moved or resized
  58.                 by means of the numeric keypad, until a dump is made
  59.                 or the screen is thawed.
  60. F6              Dump the current rectangle. If the rectangle is currently
  61.                 showing, it is removed first. Note, however, that the
  62.                 rectangle need not have been on-screen for this
  63.                 command to work. If the rectangle is not showing,
  64.                 the rectangle as it was last displayed will be dumped,
  65.                 allowing you to create a succession of screen dumps of
  66.                 the same area of the screen.
  67. F7              This is currently inactive.
  68. F8              Dumps the entire screen in the same manner as
  69.                 Shift-PrtScr.
  70.  
  71.  
  72. When the dumping rectangle is displayed on the screen, the numeric
  73. keypad is activated to move and resize it. The rectangle is moved by
  74. typing one of the numbers on the eight compass points (for example,
  75. typing 9 on the keypad will cause the rectangle to move up and to
  76. the right one pixel). The motion can be magnified by modifying the
  77. keypad key with the Alt key: Alt-9 will move the rectangle up and to the
  78. right 8 pixels.
  79.  
  80. If Shift is typed with one of the keypad keys, the rectangle is enlarged
  81. in that direction, rather than moved: Shift-6 will enlarge the rectangle
  82. to the right one pixel. Again, Alt can be used to enlarge the rectangle by 8
  83. pixels.
  84.  
  85. If Ctrl-Shift is typed with one of the keypad keys, the rectangle is
  86. shrunk from that direction: Ctrl-Shift-4 will reduce the rectangle by one
  87. pixel on its left side. Adding the Alt modifier will shrink the rectangle by 8
  88. pixels instead of 1.
  89.  
  90. The dumping rectangle can also be brought up/resized using the mouse.
  91. Clicking and dragging with the left mouse button will place one corner
  92. of the rectangle where you clicked and allow you to resize the rectangle in
  93. any direction. When you release the button, the rectangle will remain
  94. on-screen for you to fine-tune with the keypad, as necessary. Clicking
  95. and dragging with the right mouse button uses the previous anchor point
  96. but allows you to resize the rectangle as you wish.
  97.  
  98.  
  99. PERF
  100.  
  101. This application draws a series of graphs, showing the performance and activity 
  102. of the GEOS operating system as you run multiple applications. Drag the window 
  103. to the bottom of the screen, and then watch the graphs
  104. as you launch and use other applications.
  105.  
  106. Every second, the graphs are updated to show the system statistics from four 
  107. areas: processor usage, interrupt and context switch activity, memory usage, and
  108. swap activity.
  109.  
  110. Processor Usage
  111.  
  112. When you run PC/GEOS applications, the processor is actually shared by many 
  113. independent threads of execution. Each thread has a priority, and these 
  114. priorities change based on how often each thread has executed recently. PC/GEOS 
  115. always ensures that the highest priority thread is executing. The dynamic nature
  116. of the priorities results in threads sharing the processor. The process of 
  117. stopping one thread and starting another is called a context switch. Threads 
  118. vary in their demands upon the processor, so you will typically find that the 
  119. processor has execution time to spare.
  120.  
  121. The CPU Usage graph shows the percentage of time during each second that the 
  122. processor was actually executing one or more threads. The Load Average graph 
  123. indicates the average number of threads which were awaiting processor time.
  124.  
  125. Interrupts and Context Switches
  126.  
  127. Many times a second, the processor is interrupted from its current thread of 
  128. execution, in order to handle very quick, timing-critical tasks. The Interrupts 
  129. graph shows how many hardware interrupts occur each second.
  130.  
  131. As mentioned before, a context switch is performed to redirect the processor's 
  132. attention to a different thread. Context switches are also performed when an 
  133. interrupt occurs, or when a thread completes before its tenth of a second 
  134. time-slice has ended. As you can see from the Context Switches graph, a large 
  135. number of context switches can be performed per second.
  136.  
  137. Memory Usage
  138.  
  139. PC/GEOS will use any available RAM in the first one megabyte as its Global Heap.
  140. Portions of applications, documents, and even PC/GEOS itself are stored in 
  141. blocks in this area. These blocks are classified as either fixed or movable; the
  142. majority are movable, so that they might be rearranged to make room for new 
  143. blocks as they are created. The Memory Usage graph shows the portion of the heap
  144. that is occupied by both fixed and movable blocks. PC/GEOS will try to keep this
  145. portion near 90%, to balance two conflicting needs: (1) to have space for 
  146. starting new applications and opening new documents readily available, and (2) 
  147. to keep as much of currently active applications and documents in memory as 
  148. possible.
  149.  
  150. The Fixed Memory graph shows the amount of the heap which is occupied by fixed 
  151. blocks. This value will change as you launch and exit applications. The 
  152. Fragmentation graph shows the portion of the heap which is not usable, because 
  153. the movable blocks are not organized in an ideal manner. Note: the time required
  154. to collect data for these graphs may lower your overall system performance.
  155.  
  156. Swap Activity
  157.  
  158. As you launch more applications, or open large documents, you will notice that 
  159. the memory demands on the global heap increase. When the heap is full, 
  160. lesser-used blocks of code and data are temporarily swapped, or copied, out to 
  161. any available extended or expanded memory, or to the swap file on your hard 
  162. disk. This Virtual Memory scheme permits pre-emptive multitasking between 
  163. applications, and allows you to edit large documents regardless of the amount of
  164. memory on your computer. The Swap Memory and Swap File graphs show the 
  165. percentage of EMS/XMS memory and swap file space that is occupied by swapped 
  166. blocks. The Swap Out and Swap In graphs show the total amount of swap activity 
  167. per second.
  168.  
  169.