home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / demos / proart24 / Virtualise / Docs / FrontEnd < prev    next >
Text File  |  1996-08-08  |  17KB  |  377 lines
  1. File        : FrontEnd
  2. Date        : 08-Aug-96
  3. Author      : © A.Thoukydides, 1995, 1996
  4. Description : Description of the WIMP front-end "!Virtualis".
  5.  
  6.  
  7. INTRODUCTION
  8.  
  9. This file is intended as a reference to all of the features included in the
  10. "!Virtualis" front-end. For a simple introduction read the "Tutorial" file.
  11. The front-end supports interactive help; use Acorn's !Help application to
  12. obtain information about the item under the mouse pointer.
  13.  
  14.  
  15. STARTING THE PROGRAM
  16.  
  17. It is necessary to register the software before using it for the first time.
  18. See the "Tutorial" file for details of how to do this.
  19.  
  20. Start the front-end by simply double-clicking SELECT on the "!Virtualis" icon
  21. in a directory viewer. After a short delay the application icon will appear
  22. on the icon-bar.
  23.  
  24.  
  25. THE ICON BAR
  26.  
  27. Clicking Menu on the icon which appears on the iconbar opens the main program
  28. menu which offers the following options:
  29.  
  30.     Info            Moving over the sub-menu arrow displays a standard
  31.                     program information window. The version number should be
  32.                     the same as the version of the Virtualise module being
  33.                     used.
  34.                     
  35.     List areas...   This opens up a window giving details of all the dynamic
  36.                     areas in the machine, and allow various operations to be
  37.                     performed. Clicking SELECT on the icon has the same
  38.                     effect.
  39.  
  40.     Page faults...  This opens up a window showing the number of page faults
  41.                     which have been serviced classified according to the type
  42.                     of instruction which generated the exception.
  43.                     
  44.     Configure...    This opens up a dialogue box which allows the Virtualise
  45.                     module to be configured. Clicking ADJUST on the icon has
  46.                     the same effect.
  47.  
  48.     Automatic...    This opens up a window listing the dynamic area names for
  49.                     which virtual memory will automatically be enabled when
  50.                     they are next created.
  51.  
  52.     Tasks...        This opens up a window listing the current WIMP tasks,
  53.                     allowing specified tasks to be suspended and swapped to
  54.                     disc.
  55.                     
  56.     Quit            Quits the front-end program. The module is not affected.
  57.  
  58.  
  59. DYNAMIC AREA LIST WINDOW
  60.  
  61. The dynamic area list window can be opened by either selecting the
  62. "List areas..." option from the icon-bar menu or clicking SELECT on the
  63. application icon.
  64.  
  65. The window which is opened displays details of all the dynamic areas which
  66. exist in the computer. This list is updated once per second on WIMP
  67. null-polls. Areas with numbers under 256 (those which are not listed as
  68. dynamic areas in the Taskmanager) are shaded. The columns of details are:
  69.  
  70.     Name            The name of the dynamic area as displayed by the
  71.                     TaskManager or returned by OS_DynamicArea 2.
  72.                     
  73.     Number          The dynamic area number as used with OS_DynamicArea,
  74.                     OS_ReadDynamicArea and OS_ChangeDynamicArea.
  75.                     
  76.     Maximum         The maximum size (reserved logical address space) of the
  77.                     dynamic area.
  78.                     
  79.     Logical         The current logical size of the area, i.e. how much
  80.                     memory the user of the area thinks is being used.
  81.                     
  82.     Physical        The current physical size of the area, i.e. how much real
  83.                     memory is being used to support accesses to area. If the
  84.                     area has not got virtual memory enabled then it will be
  85.                     the same as the logical size.
  86.                     
  87.     VM              An indicator of whether virtual memory is enabled for the
  88.                     area.
  89.  
  90. Unshaded areas may be selected by clicking with SELECT and ADJUST in the
  91. usual manner. Clicking Menu opens a menu that allows various operations to be
  92. performed. The options offered are:
  93.  
  94.     Virtualise      Either enable or disable virtual memory for all of
  95.                     the selected dynamic areas. If any of the selected
  96.                     areas have virtual memory already enabled then a tick
  97.                     appears next to this item. This option is shaded if no
  98.                     areas are selected.
  99.     
  100.     Delete area...  Remove the selected dynamic areas. This option is shaded
  101.                     if no areas are selected. A dialogue box is opened to
  102.                     confirm the deletion.
  103.  
  104.     Show map...     This opens a window for each selecting area showing the
  105.                     status of all the pages of memory within the areas.
  106.                     Double-clicking SELECT on a dynamic area entry has the
  107.                     same effect.
  108.     
  109.     Select all      This selects all of the dynamic areas.
  110.     
  111.     Clear selection This deselects any areas which are selected.
  112.  
  113. The Virtualise and Remove options should obviously be used with care; it is
  114. very easy to crash the computer if these are used carelessly.
  115.  
  116. If an application is dragged into the list window the "Modify application"
  117. dialogue box is opened. This is described in the next section.
  118.  
  119.  
  120. MODIFY APPLICATION DIALOGUE
  121.  
  122. This allows the application to be modified so that it always uses virtual
  123. memory when it is run. A backup of the application should be made before
  124. using this option.
  125.  
  126. The top of the window shows which application will be altered. The centre of
  127. the window controls the operation to perform:
  128.  
  129.     Enable virtual memory by default
  130.     
  131.                     This option modifies the !Run file of the application to
  132.                     automatically enable virtual memory for the dynamic areas
  133.                     which are selected within the dynamic area list window.
  134.                     These should be the dynamic areas that are used by the
  135.                     application being modified. This will take effect the next
  136.                     time that the application is started. This option also
  137.                     copies the Virtualise module into the
  138.                     "!Boot.Choices.Boot.PreDesk" directory to ensure that it
  139.                     is always loaded.
  140.     
  141.     Size limit      This is the maximum size that will be set for the
  142.                     selected dynamic areas.
  143.     
  144.     Restore original !Run file
  145.     
  146.                     This attempts to restore the application to the state it
  147.                     was in before it was modified. Due to the way in which
  148.                     this operates it may not take effect until the next time
  149.                     the computer is reset.
  150.  
  151.     Uninstall module
  152.     
  153.                     Selecting this option removes the Virtualise module from
  154.                     the boot sequence if it was previously installed by the
  155.                     enable virtual memory option.
  156.  
  157. At the bottom of the window are two action buttons:
  158.  
  159.     Cancel          Clicking on this icon aborts the modification, leaving
  160.                     the application unchanged. Pressing Escape has the same
  161.                     effect.
  162.     
  163.     OK              Clicking on this icon performs the selected modification.
  164.                     It is also possible to press Return to have the same
  165.                     effect.
  166.  
  167.  
  168. PAGE STATUS WINDOW
  169.  
  170. Any number of page status windows may be opened. The main part of the window
  171. at the top contains a square for each page of memory within the dynamic area.
  172. The colour of the square indicates the state of that page. Clicking MENU
  173. within the window opens a menu:
  174.  
  175.     Key...          A window showing the meaning of the different colours.
  176.  
  177.     Zoom            A list of the possible scales at which the status display
  178.                     can be shown.
  179.  
  180. The lower part of the window has an Update button which takes a new snapshot
  181. of the state of the dynamic area. Also shown is the dynamic area number and
  182. name.
  183.  
  184. Note that the access count is only meaningful if the NFU page replacement
  185. policy is configured.
  186.  
  187.  
  188. CONFIGURATION WINDOW
  189.  
  190. The configuration window is split into four main sections. There are also
  191. three buttons at the bottom of the window:
  192.  
  193.     Save