home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / deskaces / raid12.arc / RAID.DOC < prev    next >
Encoding:
Text File  |  1988-11-08  |  9.9 KB  |  257 lines
  1.  
  2.  
  3.                       Resident AID Version 1.2
  4.  
  5.                          Copyright (C) 1988
  6.  
  7.                        Ross Neilson Wentworth
  8.  
  9.                         All Rights Reserved
  10.  
  11.  
  12.  
  13. Warranty
  14. ========
  15.  
  16. This software is provided without warranty of any kind, expressed
  17. or implied.  If you don't like it, don't use it - you didn't pay
  18. for it!
  19.  
  20. Overview
  21. ========
  22.  
  23. Resident AID (RAID) is a resident popup program (TSR) designed to help
  24. programmer's with a few menial tasks.  This program provides four
  25. functions:
  26.  
  27.            1. ASCII table, a display of the entire character set with
  28.               the codes in both hexadecimal and decimal, plus a display
  29.               of what that particular value would look like if it were
  30.               used as an attribute.
  31.            2. Memory dump, any memory location may be displayed in one
  32.               of several formats, hexadecimal byte, hexadecimal word
  33.               decimal byte, decimal word, signed integer (two bytes),
  34.               and address (four bytes).
  35.            3. Find file, this function will search all subdirectories
  36.               on the disk for a given file, wild cards are allowed.
  37.            4. Scan code, pressing a key will display its scan code.
  38.               Extended scan codes will be returned if an enhanced
  39.               keyboard is detected.
  40.  
  41. Hardware Requirements
  42. =====================
  43.  
  44. Any 100% compatible will work.  This program also requires three pages
  45. (49k) of expanded memory (EMM 3.2, 4.0, or EEMS).  The bulk of this
  46. program is placed in the expanded memory.  Only about 1k of conventional
  47. memory is consumed.  This is one popup that you can afford to leave in
  48. memory all of the time!
  49.  
  50. Installation
  51. ============
  52.  
  53. Copy RAID.COM and RAID.EMS to your boot disk in any subdirectory on your
  54. 'PATH='.  Place in your AUTOEXEC.BAT file the command 'RAID' (without the
  55. quotes).  You should place this after the PATH= directive (if you have one).
  56. When you boot your system the program will be loaded.  When RAID.COM is
  57. run it will search the current subdirectory and along the path for the
  58. RAID.EMS file.  Under DOS 3.x it will also look in the same subdirectory
  59. that RAID.COM is in.
  60.  
  61. The following error messages mean that the program was not loaded into
  62. program memory:
  63.  
  64.     'Program already loaded.'
  65.  
  66.         The program was already found in memory.  Multiple copies are
  67.         redundant.
  68.  
  69.     'Expanded memory driver not installed.'
  70.  
  71.         Expanded memory is required for this program to run.  Make sure
  72.         that you are properly loading the expanded memory driver before
  73.         attempting to load RAID.
  74.  
  75.     'Expanded memory driver not working.'
  76.  
  77.         The expanded memory driver has reported a fault with the
  78.         expanded memory board or with the driver.  If you have
  79.         an expanded memory diagnostics program you should run it.
  80.  
  81.     'Invalid EMS version number, requires version 3.2 or later.'
  82.  
  83.         This program requires EMS version 3.2 or 4.0, or EEMS.  The version
  84.         detected is none of these three.  Contact your EMS board maker for
  85.         a software update.
  86.  
  87.     'Insufficient expanded memory to load program.'
  88.  
  89.         Not enough expanded memory is available.  Other resident program's
  90.         may be using all or most of the expanded memory or you simply
  91.         don't have enough memory installed on the board.
  92.  
  93.     'Error in initialization.'
  94.  
  95.         This error is most probably caused by a conflict with another
  96.         resident program.  Try changing your load order.  If running
  97.         DOS 2.x, make sure that you load RAID before PRINT.COM.
  98.  
  99.     'Overlay file not found:  RAID.EMS'
  100.  
  101.         The file RAID.EMS could not be found in the current subdirectory
  102.         or anywhere on the 'PATH'.  Check your PATH directive and make
  103.         sure you have properly copied RAID.EMS.
  104.  
  105.  
  106. Operation
  107. =========
  108.  
  109. Once the program is properly loaded into memory you can pop up its main
  110. menu by pressing CONTROL-5 (that's the '5' located on the numeric keypad
  111. in the center).  You can exit out of each level of the program by pressing
  112. ESC, pressing ESC enough will exit out of RAID entirely, right back to
  113. where you were.
  114.  
  115. A fast alternate way to exit from RAID back to the underlying program
  116. is to press ALT-X.  The next time you invoke RAID you will be back to
  117. whichever operation you left.
  118.  
  119. The features of RAID can be divided into five distinct catagories:
  120.  
  121.   1. Main menu, with clock/calander
  122.   2. Ascii/Attribute table
  123.   3. Memory dump
  124.   4. File finder
  125.   6. Keyboard scan code
  126.  
  127. Main Menu
  128. =========
  129.  
  130. This window will display four selections, by pressing the first letter of
  131. each selection (between the '()') you can select one of the operations of
  132. RAID.  The current time and date are also displayed.
  133.  
  134. Ascii/Attribute Table
  135. =====================
  136.  
  137. Selection this operation displays a window of 32 characters, the hexadecimal
  138. and decimal code for that character, and the display attribute if that number
  139. code were used as an attribute.  On the far right of the window is a descrip-
  140. tion of the color for the foreground.  On the bottom of the window is the
  141. background color description.  Both of these are suitable for use within a
  142. Turbo Pascal source listing (e.g. TextColor(Blue)).
  143.  
  144. Users of monochrome displays will gain little from the attribute feature of
  145. this window.
  146.  
  147. Pressing PgUp, PgDn, UpAr, or DnAr will page through the character set.
  148. Pressing ESC will bring you back to the main menu.
  149.  
  150. Memory Dump
  151. ===========
  152.  
  153. This operation will display a dump of memory, 256 bytes at a time.  You can
  154. use the cursor keys to page through memory or you can directly enter a memory
  155. address by first pressing F1.  Another feature of this operation is the
  156. ability to change how the memory is displayed.  There are 6 different display
  157. modes available:
  158.  
  159.         Format                Range
  160.         ----------------      ------------------------
  161.      1. Hexadecimal byte      00h thru FFh
  162.      2. Hexadecimal word      0000h thru FFFFh
  163.      3. Decimal byte          0 thru 255
  164.      4. Decimal word          0 thru 65535
  165.      5. Decimal integer       -32768 thru 32767
  166.      6. Address               0000:0000 thru FFFF:FFFF
  167.  
  168. To change the display mode press F2 to go to the next display format, or
  169. F3 to use the previous display format.
  170.  
  171. Below the memory dump is a list of keyboard commands that are available.
  172.  
  173. File Finder
  174. ===========
  175.  
  176. This operation will search all subdirectories on a disk for a specified
  177. file.  Wildcards are fully supported, this allows the searching of
  178. similar files that are scattered throughout your disk drive.  For example,
  179. entering *.WKS will search for all of your spreadsheet files, while RAID.*
  180. will find all of the files named RAID regardless of the extension.
  181.  
  182. You can halt a search by pressing ESC.  Pressing ESC while being prompted for
  183. a file name will take you back to the main menu.
  184.  
  185. Keyboard Scan Code
  186. ==================
  187.  
  188. This operation simply prompts you for a key and displays its scan code.  For
  189. example, pressing ESC will display 011B, pressing F1 will display 3B00.  To
  190. return to the main menu you must press ESC twice.
  191.  
  192. Information
  193. ===========
  194.  
  195. This program was written using Turbo Pascal Version 5.0, Turbo Assembler
  196. Version 1.0, and Microsoft MASM Version 5.1.  Two different assemblers
  197. were used because it was originally written with MASM 5.1 and it hasn't
  198. been fully rewritten yet.  All of the assembler routines that require
  199. customization have been converted to TASM.
  200.  
  201. I would appreciate hearing you comments, suggestions, and bug reports.
  202. Is there some feature that you would love to see implemented?  Anyone
  203. who makes a suggestion that I use will receive via U.S. mail a free
  204. update disk.  You can receive the latest version by sending $10 to the
  205. address below to cover postage and handling.  I am not planning on
  206. making any money on the sell of this program.  Even though $10 is
  207. more than the stand mail rates, it helps pay for the time I must
  208. spend to mail the buggers (I'm a self-employed programmer, and not
  209. rich).  It also means I won't be swamped by requests, I would rather
  210. you get the program from the bulletin boards.
  211.  
  212.  
  213.                         Ross Neilson Wentworth
  214.                         Serendipity Software
  215.                         1422 Elkgrove Circle, #3
  216.                         Venice, CA  90291
  217.  
  218. I can also be reached through the Fido/Opus network at 1:102/345.  I am
  219. especially active on the PASCAL echo-mail area.  This board is always
  220. the first to receive the latest versions of all of my software.
  221.  
  222. WANT AD
  223. =======
  224.  
  225. As mentioned above, I am a self-employed programmer.  I have been
  226. independent for less than a year (it is now NOV 1988, who knows when
  227. you are reading this).  I have yet to build up a large client base so
  228. I still have lots of available time.  If you need an expert Pascal,
  229. preferrably Turbo Pascal, and expert assembler programmer for short-term
  230. or long-term contract work, please contact me.  Either write (to the
  231. above address), send net-work mail (again, see above) or call:
  232.  
  233.         (213)399-1244  10am - 7pm Pacific Time
  234.  
  235. I have worked on databases, graphics, CAM, menuing systems, resident programs,
  236. programmer's toolkits -- to name just a few.
  237.  
  238. Letters of references are available.  Sample source code is available
  239. as well.
  240.  
  241. NOTE, the above phone number is only for paying work, either made-for-hire,
  242. custom, or purchase of current work.  It is not for technical support of
  243. this program or any other program I have written and placed on the
  244. bulletin board systems - unless you have registers!
  245.  
  246.  
  247. Version History
  248.  
  249. 1.1  4 November 1988
  250.  
  251.      Corrected minor bug in the cursor shape restoration.  Dumps memory
  252.      as it is before interrupt vectors are changed when the program
  253.      temporarily grabs hold.  Added saving of the screen in the FIND FILE
  254.      routine so that you can pop out and back into the same list of files.
  255.  
  256. 1.0  Original Version
  257.