home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / pmsysm30.zip / read.me < prev    next >
Text File  |  1996-07-03  |  16KB  |  343 lines
  1.                  ********************************
  2.                  *  SYSTEM MONITOR Version 3.0  *
  3.                  ********************************
  4.  
  5.     Mulithreaded Program running as a status-bar reporting system
  6.     Performance and activity of your machine running OS/2.
  7.  
  8.     The features monitored are freely configurable, so you just see
  9.     what you like :-)
  10.     (Pop-up Menu is brought up by clicking the right mouse-button on the bar)
  11.  
  12.     To provide you with a program that has a unique name, SysMon will from 
  13.     now on be known as pmSysMon (ArchiveName : pmSysMxx.zip).
  14.  
  15. INSTALLING:
  16.     NO CHANGES are made to your CONFIG.SYS and .INI files :-)
  17.  
  18.     EITHER copy the files in a directory you prefer and start PMSYSMON.EXE
  19.         You can create a program object on the desktop, and put it into
  20.         the STARTUP-FOLDER in order to have pmSysMon start every time you boot;
  21.     OR (EVEN EASIER) start the INSTALL.CMD-file, which asks you whether
  22.         you want to copy the important files into a separate directory,
  23.         if you have MMOS2 support, and if you want a program-object on the
  24.         desktop.
  25.  
  26.     If you are updating an older version, just install/unpack pmSysMon into the
  27.     same directory so your old .ini file will be used - so your configuration
  28.     won't be lost. We suggest you backup your old .ini file, because
  29.     the new version adds some items.
  30.     
  31.     Because of the new name you can delete SysMon.EXE and SysMon.HLP.
  32.     pmSysMon will convert you old SysMon.INI to pmSysMon.INI - after that
  33.     you can delete SysMon.INI.
  34.  
  35. UNINSTALLING:
  36.     In the event that you wish to remove pmSysMon from your system:-(
  37.     Simple as can be : Just delete the files and desktop-object (if created)
  38.     We would ask you to send us a short message about why you are doing this.
  39.  
  40. IMPORTANT:
  41.     pmSysMon permanently calibrates the CPU activity, so the longer it runs
  42.     the more accurate the measurements are.
  43.     The value is based on the lowest performance since pmSysMon was started.
  44.     Therefore again: putting pmSysMon in the STARTUP-FOLDER gives the best
  45.     results.
  46.  
  47.     Do not try to measure how many resources pmSysMon needs with IBM's Pulse
  48.     (or a program like that) -  these monitoring tools will just block each 
  49.     other, so the values you get are meaningless.
  50.  
  51. FEATURES
  52.  
  53.     1) Time and Date   - Time and Date in the format you configured OS/2 with
  54.     2) Uptime          - Time since boot
  55.                          (can now optionally be displayed in a more compact way)
  56.     3) CPU - activity  - Shows how busy your system is
  57.                         (graphically as a triangle or pulse and/or text)
  58.     4) AvgCpu          - Average CPU load since program start
  59.     5) VMem            - Amount of free Virtual Memory
  60.     6) Physical Mem    - Amount of free Physical Memory
  61.     7) Swap            - Size of current Swap-File
  62.     8) SwapFree        - Shows how much your swap-file can
  63.                          be enlarged
  64.     9) Nr. of Tasks    - Displays the number of tasks running at the moment.
  65.  
  66.    10) Drives          - You can choose as many drives as you like
  67.                          to be monitored (showing their available space)
  68.     
  69.    11) Especially for LAPTOP users:
  70.                        - Displays the battery status in percent of full charge
  71.  
  72.   Extra Options:
  73.  
  74.     *) Wave            - You can select a wave file which will be played
  75.                          periodically, at time intervals you choose
  76.                          (e.g. none, every quarter hour,...)
  77.     *) UpdateFrequncy  - You can choose after how many seconds
  78.                          the items 3)-8) are to be updated .
  79.     *) Font,Color      - You can change the color of the bar's background,
  80.                          foreground, of the pulse and of the triangle by
  81.                          Drag & Drop.
  82.                          You can also change the font by using Drag & Drop, and
  83.                          the height of the bar will be adapted to the font size.
  84.     *) Borderwidth     - You can adapt the width of border surrounding the bar
  85.                          (which causes the 3-dim. look) to your liking.
  86.     *) NumLock         - If you like, pmSysMon can turn NumLock on
  87.                          at program start.
  88.     *) Shrink          - pmSysMon can now shrink to minimum width, so it only
  89.                          needs as much room on your screen as needed to
  90.                          accommodate the items displayed.
  91.     *) Long Names      - You can choose whether you want long descriptions
  92.                          in the bar e.g. 'Virtual Mem' and 'UpTime',
  93.                          or if you prefer abbreviations e.g. 'VMem','Up'
  94.     *) Show Seconds    - Choose if you want a time display with or without seconds.
  95.     *) DiskSpace in %  - You can select if the free diskspace of the selected
  96.                          drives shall be displayed in bytes or in percent.
  97.     *) Alarm if Low
  98.        on DiskSpace    - You can monitor the free space on any drives you like -
  99.                          if it gets below a certain minimum you can choose,
  100.                          an alarm tone is played and a dialog shows you which
  101.                          drive caused the warning.
  102.                          There you have the possibility of searching this drive
  103.                          for unneeded files (like *.tmp)and for viewing and 
  104.                          deleting them.
  105.                          This is also an easy way to delete the contents of your
  106.                          Undelete and temporary directory.
  107.        
  108.   Utilities:
  109.  
  110.     1) Run             - Easy launching of applications
  111.     
  112.     2) Task            - pmSysMon's own Task List optionally replaces the system
  113.                          Window List, so that pressing both mouse buttons
  114.                          brings it to the top.
  115.  
  116.                          This Tasklist is now more compact and will stay open
  117.                          even after losing the focus, if you configure it like
  118.                          that.
  119.                          The Task List updates itself, even while it is open,
  120.                          if e.g. a program is started or terminated.
  121.  
  122.                          MultitaskSelection is now possible.
  123.                          
  124.                          The size and position of the Tasklist are saved so
  125.                          that it always appears in the same place.
  126.  
  127.                          Lists all running tasks
  128.                           After selecting 'Info' you see:
  129.                              *) the Process ID
  130.                              *) Session
  131.                              *) ProgType (WindowAPI,...)
  132.                              *) Visibility
  133.                           You can:
  134.                              *) Kill any task
  135.                              *) Quit any task (unsaved data won't be lost)
  136.                                      either by pressing Del or with mouse
  137.                              *) Switch to any task
  138.                              *) Minimize any task
  139.  
  140.                              *) Sort by PID or Name
  141.  
  142.                              *) use Filters so that only visible or only
  143.                                 jumpable Tasks are displayed.
  144.  
  145.     3) Disk            - shows information about all drives on your system
  146.                              *) Filesystem (HPFS,CDFS,FAT,..)
  147.                              *) Location (local ,remote...)
  148.                              *) Removable
  149.                              *) Description (fixed disk, not ready , ...)
  150.                              *) Volume label
  151.                              *) Total space
  152.                              *) Free space
  153.                              *) Used space
  154.                          You can also open the corresponding drive-folder here. 
  155.                          
  156.                          Additionally, you can search the selected drive for any files
  157.                          (also by Regular Expression) and then delete the unnecessary 
  158.                          ones or open the directory where the file(s) of your interest
  159.                          reside.
  160.                          This is also a good method to keep your hardisk 'tidy'.
  161.                          
  162.     4) ShutDown        - Performs a system-shutdown
  163.                              You can choose between
  164.                                   *) usual shutdown
  165.                                   *) reboot this OS/2
  166.                                   *) reboot a freely choosable drive
  167.                              The last two options will ignore the boot-manager
  168.                              if one is installed.
  169.                              
  170.     5) Lock            - Locks the system (on demand)
  171.     
  172.     6) Battery         - if the machine is a laptop, pressing this button will
  173.                          display information about :
  174.                            *) 'battery life' - 100% means your battery is fully
  175.                                                     charged,
  176.                                                  0% means it is empty
  177.                            *) battery status - high, low, critical, or charging
  178.                            *) APM enabled    - 'Yes' if there is battery status
  179.                                                 information available
  180.                            *) APM online     - 'Yes' if your laptop is plugged
  181.                                                 into the wall
  182.  
  183.     pmSysMon will now remember it's position, so if you like to have it on top of
  184.     screen, it will appear there the next time it is started.
  185.  
  186.     A much improved help facility is now available from the pop-up menu.
  187.  
  188.     All configuration settings are centralized in a Settings Notebook.
  189.  
  190.  SOUND
  191.    The program will now also run on systems where no sound-support (MMOS2)
  192.    is installed; pmSysMon should be able to find out if MMOS2 is installed
  193.    (if MMOS2 is not installed, all sound features are automatically disabled).
  194.  
  195.    There are no longer any obligatory sounds. You can use the command line
  196.    switch -quiet or /quiet to prevent music.dll from being loaded (which will
  197.    conserve memory).
  198.    If you're sure that you don't want sound, you can even delete music.dll.
  199.  
  200.    If you get an error like MDM.DLL not found, please contact the authors
  201.    and add the -quiet switch.
  202.  
  203. CONTENTS OF ARCHIVE
  204.   The following files are contained in this archive:
  205.  
  206.     pmSysMon.exe   - SystemMonitor v3.0
  207.     pmSysMon.hlp   - Help & Explaination of the features
  208.     register.wav   - wave to be played
  209.                      (must not be deleted in the unregistered vers.)
  210.     read.me        - this file
  211.     liesmich.1st   - this file in German
  212.     order.frm      - SystemMonitor order form
  213.     install.cmd    - Installation-utility (won't touch config.sys and INI-files)
  214.     whats.new      - Changes from previous versions to 3.0 in English
  215.     wasist.neu     - Changes from previous versions to 3.0 in German
  216.     music.dll      - This DLL contains the sound functions -> see above
  217.     sm_hook.dll    - Needed for Task List replacement
  218.  
  219.  
  220. BENEFITS OF REGISTERING
  221.   *) you'll keep the Shareware-idea alive :-)
  222.  
  223.   *) no annoying registration-dialog at startup and end
  224.   *) you are allowed to choose any wave you like
  225.   *) you'll be informed upon release of updates which will work with
  226.      your old registration number
  227.  
  228.      -> Updates are FREE ;-(
  229.  
  230.  
  231. HOW TO REGISTER
  232.   You are licensed to use SystemMonitor for a period of 30 days. After
  233.   this trial period you are asked :-) to register.
  234.  
  235.  
  236.   The registration fee is US$10 or 100 ATS or 15 DM.
  237.   You can send the money in cash (which is cheaper for you)
  238.   or you use a postal order .
  239.   Sorry, we cannot accept other currencies!
  240.  
  241.   If you use postal order, please send the money in Austrian Shillings;
  242.   if you send cash don't send coins!
  243.  
  244.   Don't use any other form of payment (e.g. credit cards, checks)
  245.   as we cannot afford to accept them. (The bank charges nearly 80% of a $10
  246.   check in commission).
  247.  
  248.   We are really honest, so you don't have to worry when sending
  249.   the money in cash.
  250.  
  251.   Of course all of the given information will be treated confidentially.
  252.  
  253.   Take care when filling in order.frm that your first and last name are
  254.   legible and correct, because your registration code is based on
  255.   this information.
  256.   After you enter this number, your version of SystemMonitor is registered.
  257.   It will be much easier if you also send us your Internet E-mail address,
  258.   so we can send you update notices and your registration number faster and
  259.   more easily.
  260.  
  261. To register, fill in the order form and send it with the payment to:
  262.  
  263.       Irmgard Wasinger
  264.  
  265.       Turmburgg. 2/33
  266.       1060 Vienna
  267.       AUSTRIA
  268.       E-mail: e8925005@stud1.tuwien.ac.at
  269.  
  270.   The registration is for personal use only!!!
  271.   Running this program on more than one machine requires special
  272.   registration - contact the authors for special prices.
  273.  
  274.   Students should enquire about special academic prices.
  275.  
  276. REPORTING BUGS
  277.   If you find any bugs, or can suggest improvements in SystemMonitor, we will
  278.   be very happy to hear your remarks. This is the only feedback we have, and
  279.   we rely on it.
  280.  
  281.   Send us a letter or email :
  282.  
  283.    Irmgard Wasinger
  284.       E-mail : e8925005@stud1.tuwien.ac.at
  285.  
  286.    Ramin Nourbakhch
  287.       E-mail : e8925004@stud1.tuwien.ac.at
  288.  
  289.   When you send us a bug report, please include a description of the
  290.   procedure for reproducing the bug and a description of your system
  291.   configuration(hardware and software).
  292.  
  293. KNOWN BUGS:
  294.   The CPU-Monitor is not optimized for laptops, so you should disable it when
  295.   using a battery driven machine.
  296.  
  297.   When closing a shell with pmSysMon's Task List it sometimes happens that
  298.   the confirmation dialog doesn't react when you use the mouse, you have 
  299.   to confirm by using the keyboard.
  300.  
  301.   When changing the font per Drag&Drop pmSysMon resizes automatically, but
  302.   the size of some fonts seems to be different than reported by OS/2. We
  303.   fixed this problem for System Vio (Size 4,8,9), but we can't test all 
  304.   available fonts, so if you experience problems (especially in the buttons)
  305.   please send us a short note.
  306.  
  307. TO COME
  308.   Currently we are working on :
  309.     *) Possibility of a two-line display to show more information.
  310.     *) Scheduler
  311.     *) Build-in ScreenSaver
  312.     *) More information about tasks (like number of threads, their priority,
  313.        parent PID, DLLs installed,...)
  314.     *) Possibility of entering command line parameters while starting an
  315.        application.
  316.     *) Spooling information
  317.     *) And of course your suggestions :-)
  318.  
  319. DISTRIBUTION CONDITIONS
  320.   You are free to distribute this Shareware version of SystemMonitor as long as
  321.   the following conditions are met:
  322.     1) The distributed archive must contain ONLY the files listed above.
  323.     2) The contents of this archive are NOT MODIFIED in any way.
  324.     3) This version is not to be sold.  However, a reasonable disk copying fee
  325.        is permitted.
  326.  
  327. DISCLAIMER  (as usual :-)
  328.   The authors of this program accept no responsibility for damages that
  329.   may be caused by this program and make NO WARRANTY or representation,
  330.   either express or implied, with respect to this software.  This software
  331.   is provided "AS IS," and you, its user, assume the entire risk when you
  332.   use it.
  333.  
  334. Have you already tried MROIDS - this is a asteroids like arcade game written
  335. by a friend of us : FTP.CDROM.COM (or any mirror) in the directory GAMES.
  336.  
  337. Many thanks to Denis Cheong for providing us with the code for Batterystatus.
  338.  
  339. Special thanks to Mr. Stan Goodman who was so kind to correct all our documentation,
  340. since our English is not perfect.
  341.  
  342.  
  343.