home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 February / PCO2_97.ISO / filesbbs / os2 / awacs301.arj / AWACS.DOC < prev    next >
Encoding:
Text File  |  1996-12-19  |  18.3 KB  |  458 lines

  1. [Beta Release][19-Dec-96]
  2.  
  3. AWACS 3.00
  4. Copyright (C)1997 Cornel Huth
  5.  
  6. Part 1.  Overview.
  7. Part 2.  Files included.
  8. Part 3.  Installation.
  9. Part 4.  Command switches.
  10. Part 5.  Tips and traps.
  11. Part 6.  Registering.
  12.  
  13.  
  14. Part 1. Overview
  15. ----------------
  16.  
  17. AWACS is a basic system state monitor for display to either a MDA (mono,
  18. digital) screen or to a PM window on the desktop (or both at the same
  19. time).  Figure 1 shows a typical screen shot from the author's system.
  20. The monitor stations are:
  21.  
  22. 1.  Swap file size, and amount of swap used.
  23. 2.  RAM installed and the amount: free, locked, and resident.
  24. 3.  Working set desired and minimum memory needed to run that instant.
  25.  
  26. The Swap used % is just that, the amount of used up swap file space.  For
  27. RAM and working set, the % figure is relative to installed RAM.  Requires
  28. AWACST2.DLL and THESEUS2.SYS.  If an ISA-busmaster DASD controller is
  29. used (Adaptec 1542, for example) a message pops up indicating that only
  30. the first 16MB of memory will be used for user programs (unless the -noAbout
  31. is used).  The memory above 16MB is then added to the Swap file size.  This
  32. is the way OS/2 works, and it's determined by your .ADD driver.
  33.  
  34.  
  35. 4.  AWACS control state:
  36.  
  37.     a.  System status priority (LOW, MID, HIGH, HOLD) and check interval.
  38.     b.  Working set status priority (same as Sys) and check interval.
  39.     c.  Caller ID check priority (LOW, MID, HIGH, CLOSED) and check interval.
  40.  
  41. The check interval is in seconds.  The swap file is checked at an interval
  42. synchronized to the System interval (see -swapX: AWACS switch).
  43.  
  44. The status priorities are thread priorities:
  45.  
  46.          Set    CLASS   LEVEL
  47.          ----  -------  -----
  48.          LOW   idle      31
  49.          MID   normal     0
  50.          HIGH  critical   0
  51.          HOLD  idle       1  (CID is "CLSD", since the com port is closed)
  52.  
  53.  
  54. 5.  CPU idle reserves.
  55.  
  56. The more dots the less idle time is available.  When pegged at 100%, this
  57. means that the CPU is busy all the time.  This does not mean, necessarily
  58. that the computer will respond slowly.  It only means that there's no idle
  59. time.  For an accurate reading, no other pulse-like program should run at
  60. the same time as AWACS.  If you were, for example, to run Warp's Pulse, the
  61. AWACS CPU idle reserve status would indicate 50% or so, as it should since
  62. there are now two idle+0 processes, each getting half the CPU (if nothing
  63. else significant is running).  Warp's Pulse, however, is not so accurate.
  64. This pulse is in 1-second intervals and is on the same priority as "Sys".
  65.  
  66.  
  67. 6.  A 24-hour clock, in large numerals.
  68.  
  69.  
  70. 7.  COM port status line:
  71.  
  72. This show the async device's state, in real-time.  This requires COM40.SYS.
  73.  
  74. The status line is available at any time, no matter which program has the
  75. com port open if an MDA (mono) screen is used; the status is updated
  76. directly by the async driver as it happens.
  77.  
  78. If an MDA (mono) screen is not being used, the PM window can be still be
  79. updated every second if MONYiii.SYS has been installed with the -c
  80. MONY switch.  If the mony driver is not installed, then the status line
  81. can only be monitored when AWACS has the port open, which limits the
  82. usefulness.
  83.  
  84. Therefore, if COM40.SYS is installed, and:
  85.  
  86.   An MDA (mono) screen is used with the MONYiii.SYS driver, the COM status
  87.   line is updated instantly no matter who owns the COM port begin monitored.
  88.  
  89.   If a PM window is used with the MONYiii.SYS driver installed using
  90.   the -c MONY switch, the COM status line is updated within a second, no
  91.   matter who owns the COM port begin monitored.
  92.  
  93.   If a PM window is used -without- the MONYiii.SYS driver installed,
  94.   the COM status line is updated within a second, but only when AWACS owns
  95.   the COM port.
  96.  
  97.  
  98. 8.  Caller-ID:
  99.  
  100. If your modem has a caller-ID feature, you can use AWACS to see who's calling.
  101. The top line is the most recent caller.  Up to nine calls can be logged if
  102. the working set graphics is turned off (see -gc:0), or up to two calls if the
  103. graph is displayed.  Not all calling areas provide caller-ID info (inbound
  104. or outbound).  Contact your telco for details.  When an incoming call is from
  105. an area that does not provide caller-ID, a "NOT AVAILABLE" is shown.  If a
  106. caller blocks his caller-ID info, "NOT AVAIL/SNEAK" is shown.
  107.  
  108.  
  109. 9.  Working set graphic:
  110.  
  111. The last minute or so of the working set usage is logged.  Use the included
  112. allocmem.exe program to watch how it works.  The numbers along the right are
  113. the memory level, in MB.  Amounts over 96MB are limited to the first 96MB.
  114.  
  115.  
  116. Figure 1: Typical Screen Shot on either MDA or PM Window.
  117. ┌─────────────────┬─────────────┬──────────────────────────────────────────────┐
  118. │Swap: 32768      │Sys· LOW  3.0│ COM2:02F8 115200 8N1 DCD  ·  DSR CTS RTS DTR │
  119. │used:     0 ≈  0%│Wks  LOW  2.0│ FOYT A J        (713)555-1212 12/19/96 07:45 │
  120. ├─────────────────┤CID  LOW  1.0│                                              │
  121. │ RAM: 48768      ├─────────────┤                                            48│
  122. │free: 26052 ≈ 53 │10   ::      │                                            42│
  123. │lckd:   284 ≈  0 │     :: .    │                                            36│
  124. │rsdt:  5480 ≈ 11 │. : ::: :. . │                                      :::   30│
  125. │                 ├─────────────┤                                      :::   24│
  126. ├─────────────────┤┌─┐┌─┐ ┌  ┌─┐│                                      :::   18│
  127. │wMin   6412 ≈ 13%││ │  │:└─┼│ ││        ::                          ..:::   12│
  128. │wSet:  6900 ≈ 14 │└─┘  ┘   ┴└─┘│........::..........................:::::...06│
  129. └─────────────────┴─────────────┴──────────────────────────────────────────────┘
  130.  AWACS 3.0                      1 day, 08:56                    Thu 19 Dec 1996
  131.  
  132.  
  133. The last line shows the version, OS running time (to 999 days) and the date.
  134.  
  135.  
  136.  
  137. Part 2.  Files included
  138. -----------------------
  139.  
  140. The following files are included in this AWACS package.  Specific installation
  141. instructions follow in the next part.  This file you are reading is awacs.doc.
  142.  
  143. 1.  awacs.exe
  144.  
  145. AWACS.EXE is the Warp 3 or later, PM executable.  It provides a simple
  146. interface to set the priorities and interval times.  All other settings are
  147. made on the command-line, or from a program object's Settings' entry for
  148. Parameters.
  149.  
  150.  
  151. 2.  monyiii.sys
  152.  
  153. MONYiii.SYS serves two functions:  1) it's an MDA (mono) screen driver, and
  154. 2) it provides an interface to the COM port status when using the PM window.
  155. See "Part 1.  Overview", "7.  COM port status line" for more.  It is
  156. recommended that this be installed whether you have an MDA or not.  If MDA
  157. (mono) hardware is not available, use the -c MONY switch.
  158.  
  159.  
  160. 3a.  theseus2.sys
  161. 3b.  awacst2.dll
  162.  
  163. THESUES2.SYS and AWACST2.DLL handle the monitoring of the swap, system, and
  164. working set state.  It is recommended that they be used.  Both must be used
  165. together; rename AWACST2.DLL to awacst2.dxx if you do not intend to use them,
  166. or use both the -noSys and -noWks AWACS switches.
  167.  
  168.  
  169. 4.  awacst32.dll
  170.  
  171. AWACST32.DLL handles the PM window updating.  If you intend to only use the
  172. MDA (mono) dispaly, this is not needed.  Either rename it or use the -noVio
  173. AWACS switch.
  174.  
  175.  
  176. 5a.  com40.sys
  177. 5b.  vcom40.sys
  178.  
  179. COM40.SYS handles the regular async duties (it is based on the Warp 4 COM.SYS
  180. driver) and adds caller-ID and com port status monitoring.  VCOM40.SYS is a
  181. standard replacement for VCOM.SYS and adds no features.
  182.  
  183. Even if you do not have a caller-ID modem, or caller-ID telco service, you can
  184. still use COM40.SYS to monitor the com port.  See "Part 1.  Overview", "7.  COM
  185. port status line" for more.
  186.  
  187.  
  188. 6.  monypage.exe
  189.  
  190. Auxilliary program that is useful for programmers using a licensed version of
  191. the Mony MDA driver.  It requires MONYiii.SYS.  It's purpose is to switch to
  192. any of the up-to 8 mony video pages, or to disable the MDA (mono) screen.
  193.  
  194.  
  195. 7.  allocmem.exe
  196.  
  197. Auxilliary program that allocates, commits, then touches memory pages.  Useful
  198. for exercising the working set analysis features.
  199.  
  200.  
  201. 8.  zocevent.cm_
  202.  
  203. A sample of using the -close and -open switches to control AWACS's com port
  204. use.
  205.  
  206.  
  207.  
  208. Part 3.  Installation
  209. ---------------------
  210.  
  211. Copy AWACS.EXE to a directory in your PATH= statement.  Also copy ALLOCMEM.EXE
  212. to the same directory (optional).  \OS2\APPS\ is a good location, if it's in
  213. your PATH.
  214.  
  215. Copy the AWACST2.DLL and AWACST32.DLL to a directory in your LIBPATH=
  216. statement.  \OS2\APPS\DLL\ is a good location, if it's in your LIBPATH.
  217.  
  218. Copy the four .SYS files to your boot drive's root directory.  If any of these
  219. files already exist, save your old ones and use the ones provided in this
  220. package.
  221.  
  222. If you want MDA (mono) screen support, or even if you don't, but you do want
  223. real-time COM port status monitoring, add the line:
  224.  
  225.         DEVICE=monyiii.sys  [-p#] [-q] [-c] [-f]
  226.  
  227.   -p# is not required unless you plan on using AWACS on Mony page other than
  228.       the default (page 0).  This is not useful unless you have a Mony license
  229.       and are using page 0 already (e.g., -p8).
  230.  
  231.   -q quiets the bootup message copyright.
  232.  
  233.   -c should be used if you do NOT have MDA hardware, but you do want the
  234.      real-time COM status monitoring feature for your PM window.
  235.  
  236.   -f forces the MDA (mono) hardware to always be found.  The Mony driver
  237.      checks for MDA hardware by checking the MDA cursor.  If for some reason
  238.      the check fails (unlikely), -f may be used.  Do not use it if you don't
  239.      have an MDA.
  240.  
  241.      A typical config.sys entry would be
  242.  
  243.          DEVICE=G:\monyiii.sys -q     (if you have MDA hardware)
  244.  
  245.      or, DEVICE=G:\monyiii.sys -q -c  (if you do NOT have MDA hardware)
  246.  
  247.  
  248. Add this entry to config.sys:
  249.  
  250.         DEVICE=G:\THESEUS2.SYS
  251.  
  252.  
  253. First, find your current async drivers.  They most likely will be named
  254. COM.SYS and VCOM.SYS.  Comment their lines out and directly below each,
  255. put the new ones in.  Be sure your MOUSE drivers come before.
  256.  
  257.         DEVICE=G:\OS2\BOOT\MOUSE.SYS SERIAL=COM1
  258.         DEVICE=G:\OS2\MDOS\VMOUSE.SYS
  259.  
  260.         ...
  261.  
  262.         rem rem DEVICE=G:\OS2\BOOT\COM.SYS
  263.         DEVICE=G:\COM40.SYS
  264.  
  265.         ...
  266.  
  267.         rem rem DEVICE=G:\OS2\MDOS\VCOM.SYS
  268.         DEVICE=G:\VCOM40.SYS
  269.  
  270.  
  271.  
  272. In order for these new files to be loaded, you have to reboot.  Be sure to have
  273. an OS/2 boot floppy nearby with an editor available in case you have to re-edit
  274. you CONFIG.SYS file if, for whatever reason, your system no longer boots.
  275. After the reboot, you are ready to start up AWACS.
  276.  
  277. AWACS' default state is for just about everything to be OFF.  You can control
  278. everything from command-line parameters, covered in the next part.  The PM
  279. control box lets you adjust priorities and intervals, and you can reset the
  280. working-set and caller-ID sub-systems.
  281.  
  282.  
  283. Note:  The PM window has a title bar and a minimize button, but these are
  284. obscured.  To move the PM window, grab where the title bar would be and
  285. drag the PM window about.  To minimize it, push where the minimize button
  286. would be.  To restore the PM window, select the AWACS control box and click
  287. anywhere on the control box (except the title bar line).
  288.  
  289.  
  290.  
  291. Part 4.  Command swiches
  292. ------------------------
  293.  
  294. It's recommended that you create a program object so that you can start up
  295. AWACS with just the click-click of a mouse button.  To do this, open up the
  296. TEMPLATES folder and drag a Program object onto the desktop.  The Settings
  297. page pops up.  Fill out the path.  For the Parameter entries, consult the
  298. following.  An example would be something like:
  299.  
  300.   -com2 -bell -sys:3L -wks:2L -cid:1L -swapX:5 -cHeight:8
  301.  
  302. If you have MDA hardware, you probably want to add -noVio, and use -cls.
  303. After a while you'll probably want to use -min and -noAbout.
  304.  
  305.  -cHeight:n     Specifies the PM window character size.  For 1024x768
  306.                 displays, the default is fine (8).  For 640x480, a
  307.                 cell height of 14 is about right.  If you see "white"
  308.                 space below the PM window's background, you need to
  309.                 increase the cHeight value; if some lines are chopped
  310.                 off, you need to decrease it.  See Figure 1. for how
  311.                 the full display appears.  The range for n is 6 to 32.
  312.                 For example: -cHeight:14
  313.  
  314.  -com#          Specifies com port to use for both monitoring and CID use com0
  315.                 to disable monitor and any CID (the default is disabled).  For
  316.                 example, -com2  (no colon).
  317.  
  318.  -istr:aaa      Specifies init string for caller ID, raw format.
  319.                 The default is -istr:AT#CID=2
  320.  
  321.  -bell          Sound bell on CID.
  322.  
  323.  -noSys         Disable performance monitoring ("Sys" becomes ghosted).
  324.  
  325.  -noWks         Disable working set analysis ("Wks" becomes ghosted).
  326.  
  327. Note:  If both -noSys and noWks are specified. AWACST2.DLL is not loaded.
  328. Swap file stats are also disabled if -noSys.
  329.  
  330.  -noCID         Disables caller ID monitoring ("CID" becomes ghosted).
  331.  
  332.  -noPulse       Disables pulse graphic.
  333.  
  334.  -sys:TP        T=1 to 9 secs, P=h,l,m,x for hold, low, medium,
  335.                 time-critical priority for System monitoring.  Finer
  336.                 timing is available from the PM control box.  For
  337.                 example, -sys:3L
  338.  
  339.  -wks:TP        As -sys:TP
  340.  
  341.  -cid:TP        As -sys:TP, except hold results in closed com port if hold
  342.                 is true longer than 1.5 seconds
  343.  
  344.  -gc:n          If n is 0, working set graphic is disabled and caller ID
  345.                 logging extends to 9 entries (rather than 2).  If n is 1
  346.                 (default), graphic uses . and : for markers.  If n is 2,
  347.                 block/half-block are used.  For example, -gc:0
  348.  
  349.  -rst:ddd       ddd is the working set calls to do before resetting.  The
  350.                 default is 120.  No real need to change this, but the limit
  351.                 is 250.
  352.  
  353.  -page:n        The Mony (with MDA hardware) page to use for display.  n=0-7,
  354.                 but must be valid mony page from DEVICE=monyiii.sys -pn.  This
  355.                 page is 0-based, wherease DEVICE= line is 1-based. No effect
  356.                 on PM window.  For example, -page:0 (the default).
  357.  
  358.  -cls           Clears the MDA (mono) screen on startup.  No effect on PM
  359.                 window.
  360.  
  361.  -noAbout       Skips driver versions' box at startup; also skips ISA/16MB
  362.                 busmaster driver limit notice (if applicable).
  363.  
  364.  -min           Start the PM control box minimized.
  365.  
  366.  -swapX:n       Rate at which the swap file status is check relative the "Sys"
  367.                 rate.  The default is 2 (swap checked every other "Sys" check.
  368.                 n=1 to 99, where n=1 causes a swap-check at every system check,
  369.                 n=2 (default) every other system check.
  370.  
  371.  -bg:n          PM window background color, n=0 to 15, default=0 (black).
  372.  
  373.  -fg:n          PM window foreground color, n=0 to 15, default=6, yellow).
  374.  
  375.  -hi:n          PM window intense color, n=0 to 15, default=14, bright yellow).
  376.  
  377.  -noMony        Do not use the Mony MDA hardware.  Useful only if MDA is
  378.                 actually installed.
  379.  
  380.  -noVio         Do not use the PM window.  Also causes the AWACST32.DLL to
  381.                 not be loaded.
  382.  
  383. Note:  Using both -noMony and -noVio results in no display.  Not very useful.
  384.  
  385.  -minVio        Start PM window minimized.
  386.  
  387. Note:  The PM window has a title bar and a minimize button, but these are
  388. obscured.  To move the PM window, grab where the title bar would be and
  389. drag the PM window about.  To minimize it, push where the minimize button
  390. would be.  To restore the PM window, select the AWACS control box and click
  391. anywhere on the control box (except the title bar line).
  392.  
  393.  
  394. AWACS only runs one instance of itself.  Additional attempts just exit unless
  395. one of the following, mutually-exclusive switches are used:
  396.  
  397.  -close         Closes the open com port (see the included zocevent.cm_ file).
  398.  
  399.  -open          Re-opens the previously-closed com port (see same file).
  400.  
  401.  -exit          Exit AWACS.
  402.  
  403.  
  404.  
  405. 5.  Tips and Traps
  406. ------------------
  407.  
  408. 1.  If you are in other than 1024x768 the PM window may not appear to
  409. fill the display properly.  Use -cHeight:14 for 640x480.  The range is
  410. from 6 to 32.
  411.  
  412. 2.  The working set analysis can use up lots of CPU time. or more specifically,
  413. keep interrupts off for longer than you'd like.  If you have problems
  414. downloading files (get CRC error, for example), consider turning Wks to HOLD
  415. while downloading.  The more main memory you have, the more work needs to be
  416. done.  Also, the more active processes, the more work needed.  However, if
  417. you have a very fast CPU, or not a lot of memory (32MB or less), you may not
  418. notice.
  419.  
  420. 3.  If you use LOW priority (as I almost always do), you may notice that when
  421. the CPU is really busy, AWACS appears to stop.  It stops, indeed, because LOW
  422. priority is the same as idle, and if there's no idle time, AWACS just doesn't
  423. get any timeslices.  If this is a problem, for example, you need to monitor a
  424. heavy CPU-use process, just bump up the priority to MID or HIGH.  Another
  425. possibility is to set PRIORITY=ABSOLUTE in CONFIG.SYS (for this to make a
  426. difference, you still need to use MID or HIGH).  You may also want to reduce
  427. the interval:  1.0 seconds is the lowest.  I use Sys:3L, Wks:2L, CID:1L and
  428. SwapX:5 most of the time.
  429.  
  430. 4.  If the Pulse seems to no longer respond, except in drastic changes (0%
  431. most of the time, but if you move a big window, then 30%, but just for a
  432. second), then you just exit and restart AWACS.  I've seen it, though it
  433. doesn't happen often.
  434.  
  435.  
  436.  
  437. 6.  Registration
  438. ----------------
  439.  
  440. Why register?  Because if you don't, you can only use AWACS for 30 minutes at
  441. a time, and only for the first 2 hours after booting.   If you want to
  442. get rid of those time limits you need to register.  The cost is $17.50 plus
  443. $2.50 shipping and handling.  Payment may be check, money-order, or cash.
  444. Payment must be in US funds drawn on a US bank.  Send $20 to:
  445.  
  446.         Cornel Huth
  447.         6402 Ingram Rd
  448.         San Antonio TX 78238
  449.         USA
  450.  
  451. Questions on registering?  Contact info@40th.com  or call the 40th Floor BBS
  452. at 1(210)684-8065.   If you have registered AWACS 1.x already (before 1997)
  453. contact me and I'll get you a free 3.0 registration.  For those that only
  454. need an MDA (mono) version, AWACS 2.10 is still available at no cost (at most
  455. OS/2 BBSes and internet sites).  Sorry, no credit cards (it's only $20!).
  456.  
  457. ^A
  458.