home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 17A / DESQACCS.ZIP / DESQACCS.DOC < prev    next >
Text File  |  1992-02-14  |  9KB  |  215 lines
  1. ----------------------------------------------------------------------
  2. DESQACCS 1.0  (11 August 1990)
  3.  
  4. Ben Malec
  5. 2008 Woodmar Dr. Apt. D
  6. Houghton, MI 49931
  7. ----------------------------------------------------------------------
  8.  
  9.  
  10. PACKING LIST:
  11.  
  12.      DESQACCS.DOC             What you're reading now!
  13.      DCLOCK.COM               Digital clock for Desqview
  14.      MODMON.COM               Internal modem monitoring program for Desqview
  15.  
  16.  
  17. OVERVIEW:
  18.  
  19.      DESQACCS is a collection of Desqview-specific utility programs.
  20. Currently, there are two utilities included in the package:
  21.  
  22.      DCLOCK (Version 1.00)
  23. and
  24.      MODMON (Version 1.00)
  25.  
  26.      Keep an eye out for subsequent updates.  More utilities will be included
  27. as their code is completed.  Tentatively, a clock/date utility and an analog
  28. clock for Desqview 386 will be added to DESQACCS sometime in Fall 1990.
  29.  
  30.      This software is what I call DONATIONWARE.  That is, if you like and use
  31. the programs regularly and have a few dollars lying around, it would be VERY
  32. appreciated if you make a small donation.  However, if you're as broke as I am,
  33. don't feel guilty about using the software.
  34.  
  35.      The source code, though, is available in the continental U.S. for a
  36. $15 fee.  Both of the programs were written fully in 8088 assembler, compiled
  37. with the Microsoft Macro Assembler 5.1, and linked with the Microsoft Overlay
  38. Linker 3.69.  Purchasing the source has several benefits:
  39.  
  40.      * Reading other people's source code is educational
  41.      * You can make any changes you wish to the programs
  42.      * You can use the procedures in programs of your own, eliminating the
  43.        need to reinvent the wheel
  44.      * You can compile the code yourself, reducing the possibility of a virus
  45.      * And finally, I'll also send the latest version of DESQACCS
  46.  
  47.      If you want the source code, send a check or money order to the address
  48. listed above and specify the disk format which you want the source returned on.
  49. Alternatively, you can contact me via the Hubbell Message and File Board:
  50.  
  51.      Line 1: (906) 296-0031
  52.      Line 2: (906) 296-0002
  53.      Line 3: (906) 296-0512
  54.  
  55.      My user ID is Ben Malec.  The latest versions of DESQACCS will always
  56. be on the Hubbell Board if you're interested.  Finally, I'd like to thank
  57. my wife for putting up with my through-the-night programming sessions and
  58. Louie Koepel of the Hubbell Message and File Board for comments, suggestions,
  59. and some painful Beta testing.
  60.  
  61. ----------------------------------------------------------------------
  62. DCLOCK.COM 1.00
  63.  
  64. User's Guide
  65. ----------------------------------------------------------------------
  66.  
  67.  
  68. OVERVIEW:
  69.  
  70.     Dclock is a small and fast digital clock for the Desqview environment.
  71. However, it does much more than give you the time.  Dclock constantly polls the
  72. realtime clock and makes sure that the system clock (DOS's clock) is synced
  73. with the realtime clock.  This is important for two reasons:  First, when
  74. Desqview is under a heavy load, it appears to skip the timer interrupt
  75. occasionally, making the system clock run slow.  It has been reported to me
  76. the system clock can fall behind over a half hour in a twelve hour (realtime)
  77. period!  Second, some programs trash the system clock if they hang in Desq-
  78. view.  Dclock eliminates these two problems entirely, providing you with a
  79. system time no more than one second off the realtime clock.
  80.  
  81.  
  82. DESQVIEW PROGRAM INFORMATION:
  83.  
  84.      Here are the relevant parameters needed when setting up the clock in Desq-
  85. view:
  86.  
  87.      Memory Size (in K): 2
  88.      Program: dclock.com
  89.      Directory: The directory where you store Dclock
  90.      Writes text directly to screen: No
  91.      Displays graphic information: No
  92.      Virtualize text/graphics: No
  93.      Uses serial ports: No
  94.  
  95. And on the Advanced Options menu:
  96.  
  97.      Script buffer size: 0
  98.      Interrupts: 00 to 00
  99.      Maximum height/Starting height: 1
  100.      Maximum width/Starting width: 11
  101.      Starting row and column: Wherever you want it
  102.      Uses its own colors: No
  103.      Allow close window command: Yes
  104.      Uses math coprocessor: No
  105.  
  106.      The rest of the parameters can be set to your liking (or defaults used).
  107. The clock does dig around in the BIOS data area, so you will generate warnings
  108. if the Protection level is 3.  Note that since this program is Desqview-
  109. specific, the only way to quit the clock is with the Close Window command and
  110. color control is completely done via Rearrange/Change Colors.  Informal tests
  111. show that Dclock uses about 2% of available processor time.  That is, the rest
  112. of the programs running in Desqview will slow down about 2% when Dclock is
  113. loaded.
  114.  
  115. ----------------------------------------------------------------------
  116. MODMON.COM 1.00
  117.  
  118. User's Guide
  119. ----------------------------------------------------------------------
  120.  
  121.  
  122. OVERVIEW:
  123.  
  124.      Modmon gives your internal modem the diagnostic lights of an external
  125. modem.  Although the display is similar to that of Jeff Prosise's LITES.COM
  126. (PC Magazine, 14 March 1989), the code has been written from the ground up
  127. and optimized for Desqview.  However, I am indebted to Mr. Prosise since the
  128. technical information presented in his article formed the groundwork for
  129. Modmon.  Here is a brief description of the screen:
  130.  
  131.  
  132.                    Data carrier detect ----+    +---- Transmission speed
  133.                                            |    |
  134.                        DTR RTS CTS DSR RI DCD  2400 8N1
  135.                 |   |   |   |  |            |||
  136. Data terminal ready ----+   |   |   |  +---- Ring   ||+---- Stop Bits   
  137.         Request to send ----+   |   |               |+---- Even, Odd, or No
  138.               Clear to send ----+   |               |      parity
  139.                  Data set ready ----+               +---- Data Bits
  140.  
  141.      If a mnemonic is not being displayed, then its corresponding register bit
  142. in the UART is low (false).
  143.  
  144.  
  145. DESQVIEW PROGRAM INFORMATION:
  146.  
  147.      Here are the relevant parameters needed when setting up Modmon in Desq-
  148. view:
  149.  
  150.      Memory Size (in K): 2
  151.      Program: modmon.com
  152.      Parameters: The address of the UART (See below)
  153.      Directory: The directory where you store Modmon
  154.      Writes text directly to screen: No
  155.      Displays graphic information: No
  156.      Virtualize text/graphics: No
  157.      Uses serial ports: Yes
  158.  
  159. And on the Advanced Options menu:
  160.  
  161.      Script buffer size: 0
  162.      Maximum height/Starting height: 1
  163.      Maximum width/Starting width: 32
  164.      Starting row and column: Wherever you want it
  165.      Uses its own colors: No
  166.      Allow close window command: Yes
  167.      Uses math coprocessor: No
  168.  
  169.      The rest of the fields, with the exceptions of Parameters, can be left to
  170. their default value or set as desired.  The Parameter field must be set to the
  171. base address of the UART, in hexadecimal.  This approach was used since it
  172. allows many nonstandard serial port configurations.  Usually the values are
  173. as follow:
  174.  
  175.      Port     Address
  176.      ----     -------
  177.      COM1       3F8
  178.      COM2       2F8
  179.      COM3       3E8
  180.      COM4       2E8
  181.  
  182.      If there's any question as to the address of the UART, consult your modem
  183. manual.  If no parameters are specified, 3F8 (COM1) is assumed.  Make sure you
  184. specify the correct address, since Modmon can't determine whether the address
  185. points to a UART or not.
  186.      
  187.      Since this program is Desqview-specific, the only way to terminate it is
  188. via the Close Window command.  The color of the display is controlled by
  189. Rearrange/Change Colors.  *** WARNING: *** This program has been extensively
  190. tested on a single line system, but it crashed a multiline system.  If you have
  191. a multiline system, I strongly suggest not using Modmon until the exact cause
  192. of the incompatibility is determined!  Modmon itself does not notmess with DOS
  193. or the disk BIOS, but an unexpected crash can leave a lot of files ruined.
  194. Be forewarned! 
  195.  
  196.  
  197. A FINAL NOTE
  198.  
  199.      All comments, suggestions, and constructive criticisms are welcome.  You
  200. may contact me either at my home address or through the Hubbell Message and
  201. File Board (See page 1).  Also, new ideas for programs are always appreciated.
  202. Obviously I don't write programs for money, but rather the challenge and 
  203. satisfaction of a program well done.  However, your donations help pay the
  204. rent (literally!) and allow me more time to write programs which you, the user,
  205. can benefit from.  Thank you for examining DESQACCS and keep looking for more
  206. programs and utilities from BenSoft!
  207.  
  208.  
  209. DISCLAIMER
  210.  
  211.      I, Benedict Malec, specifically disclaim all warranties, either expressed
  212. or implied.  The software is provided "as is", and the user assumes all risks.
  213. Furthermore, in no event shall I be placed liable for any loss of profit or any
  214. other commercial damage, including but not limited to special, incidental,
  215. consequential, or other damages.