home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / util / misc / mhsutil5.lha / MemMonitor / Manual < prev    next >
Text File  |  1995-09-25  |  8KB  |  239 lines
  1.     -------------------------------------------------------------------------
  2.     INTRODUCTION
  3.     -------------------------------------------------------------------------
  4.  
  5.     Imagine working from a remote graphics screen, then suddenly while
  6.     working, the memory gets too low and without warning ... A SYSTEM
  7.     CRASH!  'MemMonitor' will watch for low memory conditions (you set
  8.     the lower limits) for both CHIP & FAST memory; warning you when the
  9.     memory drops below the desired limits allowing immediate action
  10.     to be taken before a program or system 'crash' occurs!  'MemMonitor'
  11.     allows monitoring both the largest or total memory (chunks) that are
  12.     available and lower memory limits from 0 bytes to gigabytes!  All
  13.     this at the click of the mouse!  In this, 'MemMonitor' is invaluable!
  14.  
  15.  
  16.     -------------------------------------------------------------------------
  17.     FEATURES
  18.     -------------------------------------------------------------------------
  19.  
  20.     --------------------------
  21.     Standard features include:
  22.     --------------------------
  23.     o - Multitasks.
  24.     o - Uses standard INTUITION interfaces.
  25.     o - Adjusts to different WORKBENCH environments.
  26.  
  27.  
  28.     -------------------------
  29.     Special features include:
  30.     -------------------------
  31.     o - Uses the 'SOFTCONFIG' environment.
  32.     o - Uses the 'CCFQ' convention.
  33.  
  34.  
  35.     -------------------------
  36.     Program features include:
  37.     -------------------------
  38.     o - Monitor both free CHIP & FAST memory.
  39.     o - Monitor largest or total size memory chunks.
  40.     o - Monitor lower memory limit from 0 bytes to gigabytes.
  41.     o - Visual and/or audible warning when memory drops below established
  42.         limits.
  43.     o - Has a low system 'overhead' while running.
  44.  
  45.  
  46.     -------------------------------------------------------------------------
  47.     USING MEMMONITOR
  48.     -------------------------------------------------------------------------
  49.  
  50.     ----------------
  51.     Getting Started:
  52.     ----------------
  53.     You can start 'MemMonitor' from the supplied icon, or from the CLI/
  54.     Shell using:
  55.  
  56.     >Run MemMonitor
  57.  
  58.     ... you will be presented with the preferences window.
  59.  
  60.     (Please refer to the online help file for more information.)
  61.  
  62.  
  63.     --------
  64.     Options:
  65.     --------
  66.     The following options are available from the CLI/ Shell.
  67.  
  68.     -n ................. Don't initially open the preferences window.
  69.     -c<value> .......... Specify CHIP memory limit: 0-1024
  70.     -f<value> .......... Specify FAST memory limit: 0-1024.
  71.     -t ................. Specify memory size type: b/k/m.
  72.     -b ................. Specify block type: l/t.
  73.     -p ................. Edit prefereneces when 'hidden'.
  74.     -q ................. Exit 'MemMonitor' when 'hidden'.
  75.  
  76.     (For information on 'TOOLTYPES' please refer to the online help file.)
  77.  
  78.  
  79.     ----------------
  80.     Pull-Down Menus:
  81.     ----------------
  82.  
  83.     Projects Menu:
  84.     --------------
  85.     About .............. Program credits & info.
  86.     Quit ............... Exit 'MemMonitor'.
  87.  
  88.  
  89.     Special Menu:
  90.     -------------
  91.     Alarm .............. Toggle the audible alarm on/ off.
  92.  
  93.  
  94.     ------------
  95.     Preferences:
  96.     ------------
  97.     You can edit the preferences any time the warning window is open
  98.     by selected the "Projects/Preferences..." option.
  99.  
  100.     If 'MemMonitor' is 'hidden' you can use either:
  101.  
  102.     >Run MemMonitor -p
  103.  
  104.        (...or...)
  105.  
  106.     >Run CCFQ ?
  107.  
  108.     ... then enter the task# for 'MemMonitor' followed by PREF.
  109.     (Ie., 'CCFQ 1 PREF')
  110.  
  111.     You can monitor two types of memory blocks: (l)argest and (t)otal.
  112.     The 'largest' option will monitor the largest free 'chunk' of
  113.     memory available and the 'total' option will monitor the total
  114.     amount of free memory available.  If memory becomes too fragmented,
  115.     you could have enough total memory, but not enough contiguous
  116.     ('largest' chunk) memory available.  The best selection would be
  117.     'largest'.
  118.  
  119.     The sizes of memory to monitor are: (b)ytes, (k)ilobytes and
  120.     (m)egabytes.  For most uses, kilobytes will suffice.  Note that
  121.     1024 bytes = 1 kilobyte.
  122.  
  123.     After changing the preferences you can select:
  124.  
  125.     SAVE ..... Use changes for all sessions.
  126.     USE ...... Use changes for this and other sessions.
  127.     DONE ..... Use changes only for this session.
  128.  
  129.     If you click on the close window gadget (button) when editing the
  130.     preferences for 'MemMonitor' then 'MemMonitor' will exit.
  131.  
  132.  
  133.     -----------
  134.     Monitoring:
  135.     -----------
  136.     Each memory type is monitored every 1/30 of a second with a full
  137.     monitoring cycle occuring every 1 second: 2 * .5 = 1.
  138.  
  139.     When the preferences window is displayed, any 'CCFQ' commands will
  140.     be ignored.
  141.  
  142.  
  143.     --------
  144.     Warning:
  145.     --------
  146.     When the established memory limits are exceeded, a warning window
  147.     will display the current memory size being monitored.  When the
  148.     memory returns to 'safe limits' the warning window(s) will close
  149.     allowing 'MemMonitor' to return to the 'hidden' mode of operation.
  150.  
  151.  
  152.     -----
  153.     CCFQ:
  154.     -----
  155.     The following 'ccf' commands are recognized when 'MemMonitor' is
  156.     'hidden':
  157.  
  158.     PREF
  159.     QUIT
  160.  
  161.     (Please refer to the help file(s) for 'CCFQ' for more information.)
  162.  
  163.  
  164.     -----------------------
  165.     Software Configuration:
  166.     -----------------------
  167.     The following variables (flags) are used:
  168.  
  169.     SCREEN TO FRONT
  170.     USE PUBLIC SCREEN
  171.  
  172.     (Please refer to the help file(s) for 'SoftConfig' for more information.)
  173.  
  174.  
  175.     -------------------------------------------------------------------------
  176.     FOR ADVANCED USERS
  177.     -------------------------------------------------------------------------
  178.  
  179.     --------------------
  180.     'WBSTARTUP' Startup:
  181.     --------------------
  182.     Place 'MemMonitor' and it's icon into your current 'SYS:WBSTARTUP'
  183.     drawer to automatically start 'MemMonitor' each time your system
  184.     is booted up.
  185.  
  186.  
  187.     ------------------
  188.     Program 'Crashes':
  189.     ------------------
  190.     For heavy graphic users, 'MemMonitor' can assist in warning when
  191.     graphics memory is getting too low thereby halting rendering, etc.
  192.     Some software will actually 'crash' if memory gets too low.  Using
  193.     'MemMonitor' could assist in 'front-ending' these types of
  194.     programs:  once the warning is initiated, an audible beep could
  195.     sound,  then attending the system,  memory could then be freed
  196.     before continuing using the rendering program or any program that
  197.     might cause a system 'crash' when memory gets too low.
  198.  
  199.  
  200.     ---------------
  201.     Program Starts:
  202.     ---------------
  203.     Programs will not be started if memory is insufficient for the
  204.     system to start them.  This includes AREXX initiated tasks.
  205.  
  206.  
  207.     -----------
  208.     Final Note:
  209.     -----------
  210.     'FKEY' can be used to 'launch' this program via pre-determined
  211.     keystroke(s).
  212.  
  213.  
  214.     -------------------------------------------------------------------------
  215.     CREDITS
  216.     -------------------------------------------------------------------------
  217.  
  218.     This program was designed and coded by Michael Thomas Hurt  of
  219.     MIKE HURT SOFTWARE!, coded in & compiled using Blitz Basic 2.0
  220.     available from Acid Software.
  221.  
  222.     Software testing was done using:
  223.  
  224.       o - Amiga 500 : AmigaDOS 2.1, GVP HD 500+ w/ 2MEGS.
  225.  
  226.       o - Amiga 2000: AmigaDOS 2.1, Microbotics VXL030 w/MMU,
  227.           Microbotics VXLRAM 2MEGS, Microbotics 8-UP! 4MEGS,
  228.           GVP Series II hard card w/ 100MEG HD.
  229.  
  230.       o - Amiga 3000: AmigaDOS 2.1, 6MEGS.
  231.  
  232.       o - Amiga 4000: AmigaDOS 3.0
  233.  
  234.  
  235.     -------------------------------------------------------------------------
  236.     PROGRAM HISTORY
  237.     -------------------------------------------------------------------------
  238.  
  239.     v1.0    07/20/1995    Original program.