home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 2 / agavol2.iso / c / scsi-tester.doc < prev    next >
Text File  |  1995-08-17  |  14KB  |  356 lines
  1. -----------------------------------------------------------------------------
  2.                            SCSI-TESTER V2.0
  3.                          © 1994 by John Yeager
  4.                           All Rights Reserved
  5. -----------------------------------------------------------------------------
  6.  
  7.                        THIS PROGRAM IS SHAREWARE.
  8.  
  9.  
  10. I HAVE SPENT MANY COUNTLESS HOURS IN DEVELOPING THIS SOFTWARE, SO PLEASE, IF 
  11. YOU FIND THIS SOFTWARE USEFUL --- REGISTER --- AND KEEP AMIGA PROGRAMMERS
  12. DEVELOPING SOFTWARE THAT IS USEFUL AND AFFORDABLE.
  13. (See end of this doc file for registration info.)
  14.  
  15.  
  16. WHILE BEING SHAREWARE, THIS SOFTWARE IS FREELY DISTRIBUTABLE AS LONG AS
  17. ALL FILES IN THE ARCHIVE ARE LEFT INTACT AND ONLY A NOMINAL FEE IS CHARGED
  18. FOR ITS DISTRIBUTION.
  19.  
  20. THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
  21. EXPRESSED OR IMPLIED. BY USING IT, YOU AGREE TO ACCEPT THE ENTIRE RISK AS TO
  22. THE QUALITY AND PERFORMANCE OF THE PROGRAM.
  23.  
  24.  
  25. THE LOG FILE IS *NOT* CREATED IN THE *UNREGISTERED VERSION* OF SCSI-TESTER
  26. EVEN THOUGH THE PROMPTS IN THE PROGRAM MAY TELL YOU IT IS...
  27. (See the example log files in this archive for sample output.)
  28.  
  29.  
  30.  
  31.  
  32. Program Description:
  33. ~~~~~~~~~~~~~~~~~~~
  34.  
  35. SCSI TESTER was written for the purpose of exercising your hard drives,
  36. your SCSI controller, your SCSI cabling, SCSI device driver code and more
  37. to determine if there are any faults present on your SCSI bus
  38. and/or hard drives.
  39.  
  40.  
  41. Program Requirements:
  42. ~~~~~~~~~~~~~~~~~~~~
  43.  
  44. KickStart and WB 2.04+ are REQUIRED for this program to run.
  45. If you try to start the program on any system with LESS than version
  46. 37 of the system libraries it will inform you of that, and then just exit.
  47.  
  48.  
  49. Program Startup:
  50. ~~~~~~~~~~~~~~~
  51.  
  52. The program may be started via the CLI or from WorkBench.
  53.  
  54.  
  55. If started from the CLI you'll need to enter the SCSI device driver name
  56. that you want to use. If not supplied on the command line, the program
  57. will not start. Example usage is:
  58.  
  59. SCSI-TESTER gvpscsi.device
  60.  
  61.  
  62. If started from Workbench via the supplied tool icon, SCSI-TESTER uses the
  63. ToolType name of DRIVERNAME=xxxxxxxx.device to start the program.
  64. The DRIVERNAME tooltype, if not supplied in the icon, WILL DEFAULT to
  65. GVP'S driver name of gvpscsi.device when the program starts.
  66.  
  67. *************
  68. **IMPORTANT**
  69. *************
  70. The SCSI device driver name *IS* case sensitive as is the ToolType of
  71. DRIVERNAME= . 
  72.  
  73. DRIVERNAME= must be all upper case with the equal sign right after the E
  74. and right before the start of the actual SCSI device driver name as in:
  75. DRIVERNAME=scsi.device .
  76.  
  77. The actual driver name *MUST* be case specific when supplied to either the
  78. CLI startup or the Workbench startup. I.E.:
  79.  
  80. Correct ===> gvpscsi.device OR scsi.device
  81. INCorrect => GvpScsi.device OR Scsi.Device
  82.  
  83. *************
  84. **IMPORTANT**
  85. *************
  86. To prevent a non-crashing innocuous Enforcer hit when starting
  87. SCSI-TESTER from WorkBench, a stack size of 8K, (8,192 bytes), *MUST*
  88. be set and saved in the icon. This is due to the Workbench startup code
  89. and will be modified and fixed in the next release. 
  90.  
  91.  
  92. Program Gadgets, Requesters & Display Operations:
  93. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94.  
  95. There are 8 gadgets in the program window. They are:
  96.  
  97. ----------------------------------
  98. o SCSI Device Driver:
  99. o Test Intensity:
  100. o SCSI ID:
  101. o BOARD:
  102. o LUN:
  103. o START
  104. o CANCEL
  105. o THE USUAL CLOSE WINDOW GADGET...
  106. ----------------------------------
  107.  
  108. o The SCSI Device Driver gadget is a string gadget that you can use to
  109.   change the device driver name without having to exit and then restart
  110.   the program. Just make sure you follow the guidelines laid out in the 
  111.   "Program Startup" section above in regards to case specificity for the
  112.   driver name. This gadget is ghosted and not usable while the test is
  113.   running.
  114.  
  115. o The Test Intensity gadget is a cycle gadget that sets the intensity of
  116.   the head seeks between the two data reads that always
  117.   occur for each sector on the hard drive.
  118.   I.E:
  119.  
  120.   NOHEAD --> Does NOT do any head seeks between disk read compares.
  121.   NORMAL --> Does 1 seek between disk read compares.
  122.   HEAVY1 --> Does 3 seeks between disk read compares.
  123.   HEAVY2 --> Does 15 seeks between disk read compares.
  124.  
  125.   As you will notice, progressing from NOHEAD thru HEAVY2 will slow
  126.   the entire run down. However, as an example, HEAVY2 will more thoroughly
  127.   test your hardware than NOHEAD will.
  128.   This gadget is active at all times and may be cycled as you wish.
  129.  
  130. o The SCSI ID cycle gadget is used to select the SCSI ID that you wish to
  131.   test. The range is from 0 to 7. This gadget is only active prior to
  132.   starting a run and then ghosted.
  133.  
  134. o The BOARD cycle gadget is used to select from multiple SCSI controllers
  135.   you might have installed in your machine. Currently, this gadget
  136.   cycles from 0 to 6. (I can't believe that too many people could have
  137.   more than 7 separate and distinct SCSI controllers in their Amiga,
  138.   however, if this is inadequate, please let me know!) This gadget is 
  139.   only active prior to starting a run and then ghosted.
  140.  
  141. o The LUN cycle gadget is used to select from 0 to 7 different LUN's,
  142.   (Logical Unit Numbers), that may exist with your type of SCSI controller.
  143.   This gadget is only active prior to starting a run and then ghosted.
  144.  
  145. o The START button gadget starts the run of the program after the above
  146.   other gadgets have been set. This gadget will ghost when SCSI-TESTER
  147.   is actually testing a device.
  148.  
  149. o The CANCEL button gadget will cancel a run in progress. This gadget
  150.   starts off as ghosted before a run and then unghosts while a test
  151.   is in progress. CANCELLING A PROGRAM RUN IN PROGRESS WILL NOT BE
  152.   DESTRUCTIVE IN ANY WAY... THE PROGRAM IS ONLY PERFORMING READS AND SEEKS
  153.   ON THE SCSI DEVICE IN QUESTION!!!!
  154.  
  155. o The CLOSE gadget that is in the upper left corner of the program window
  156.   acts as a normal close gadget in WB2.04+. By clicking here you will
  157.   exit the program. The close gadget is only active while the program is
  158.   sitting idle, (i.e. before or after a test run).
  159.    
  160. o The area above the start button gadget where the program name, 
  161.   copyright date, and my name is displayed while the program is idle
  162.   will change to drive information data once a test is started on a 
  163.   device.
  164.  
  165. o As the test progresses, a "Percent Completed" status line will be updated
  166.   and the percentage calculated as the number of blocks tested is 
  167.   compared with the total number of blocks on the device.
  168.  
  169. o The status bar indicator also increases for every 1% of completion.
  170.  
  171. o The bevel box area in the center left of the program window will
  172.   display important information about the test in progress as will certain
  173.   program requesters that pop up. The messages are pretty much self
  174.   explanatory as is the information in the requesters.  
  175.  
  176.  
  177. Program Operation:
  178. ~~~~~~~~~~~~~~~~~
  179.  
  180. What the program does is to do a physical test of each and every sector 
  181. on your hard drive, and the SCSI bus in general, and to report any errors
  182. via program requester and program window information and a log file.
  183.  
  184. SCSI-TESTER will, using scsi-direct commands, read a sector of data, then, 
  185. optionally move the heads, then re-read the same sector of data and then do 
  186. a compare of that data sector in memory. Any sense errors and/or sector
  187. data errors are reported as directed in the above paragraph.
  188.  
  189. Data sector sizes used in the program are determined at run
  190. time by interrogating the SCSI device directly.
  191.  
  192. The amount of head movement between data reads is controlled by the
  193. Gadget labeled "Test Intensity". The details of that gadget are as follows:
  194.  
  195. NOHEAD --> Does NOT do any head seeks between disk read compares.
  196. NORMAL --> Does 1 seek between disk read compares.
  197. HEAVY1 --> Does 3 seeks between disk read compares.
  198. HEAVY2 --> Does 15 seeks between disk read compares.
  199.  
  200. This gadget is activated for the entire run of the program and you may
  201. toggle it as you wish *DURING* any operation.
  202.  
  203.  
  204. This program is NON-DESTRUCTIVE and only performs reads to the 
  205. particular SCSI device ID selected. However, I do NOT place a inhibit on the 
  206. logical partitions on the particular SCSI device being tested. 
  207. In light of this I would strongly suggest that SCSI-TESTER be run without
  208. any other disk access to that particular SCSI device.
  209.  
  210. The CANCEL gadget may be hit at any time during the run with no ill
  211. effects. All you will have done is to verify the sectors up to
  212. the point you hit cancel.
  213.  
  214. *************
  215. **IMPORTANT**
  216. *************
  217.  
  218. If you are testing on a SCSI bus that has numerous problems SCSI-TESTER
  219. *MAY* hang on the bus waiting for a response to it's message ports. This
  220. may cause your whole machine to hang. *BEWARE* If this happens, just reset
  221. your machine.
  222.  
  223. A log file is *REQUIRED* for the program to operate. Some very detailed
  224. information is written here and I urge you to review this ASCII file
  225. after a test run has completed. I *STRONGLY SUGGEST* that you use a device
  226. to store the log file that *IS NOT* on the SCSI bus you are testing such
  227. as your RAM: disk or Floppy drives. The ASL requester is used to prompt
  228. for the log file.
  229.  
  230. 2 log file ASCII examples are included for familiariaztion.
  231.  
  232.  
  233.  
  234. Other Program Information And Other Shareware Information:
  235. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  236. *****************
  237. **PERSONAL NOTE**
  238. *****************
  239.  
  240. I have owned an Amiga since 1987 and have been a long time beta tester of
  241. JRComm and currently I am beta testing Jack Radigan's soon to be released
  242. successor, TERMINUS.
  243.  
  244. I have also written many other programs in Aztec C and SAS C
  245. that I am using myself. Please let me know if there are other projects
  246. you wish to see worked on and I'll do my best to see if they are worth
  247. pursuing...
  248.  
  249.  
  250.  
  251.  
  252. REGISTRATION FEES ARE AS FOLLOWS:
  253.  
  254. 1) NON-COMMERCIAL INDIVIDUAL FEE:
  255.    $15.00 U.S.
  256.  
  257. 2) COMMERCIAL USER SITE LICENSE AND/OR COMMERCIAL USER FEE BY CPU:
  258.    CONTACT ME FOR MORE INFORMATION. 
  259.  
  260.  
  261. REGISTERED USERS WILL RECEIVE:
  262.  
  263. 1) FREE TECHNICAL SUPPORT THRU THE CONTACTS I HAVE LISTED AT THE END OF
  264.    THIS DOC FILE.
  265.  
  266. 2) PHONE SUPPORT!!!
  267.  
  268. 3) ONE (1) FREE UPDATE TO A MAJOR REVISION. MAILED DIRECTLY IF
  269.    NEEDED. (I.E. V2.0 TO 3.0).
  270.  
  271. 4) BUG FIXES AS NEEDED THRU ELECTRONIC DISTRIBUTION, OR FOR NOMINAL SHIPPING
  272.    AND HANDLING CHARGES, THRU OTHER DELIVERY SYSTEMS.
  273.  
  274. 5) MY COMMITTMENT TO YOU TO FOLLOW UP AND FIX PROBLEMS THAT MAY ARISE AND
  275.    TO BE OPEN TO YOUR ENHANCEMENT SUGGESTIONS OF FUTURE VERSIONS.
  276.  
  277. 6) SCSI-TESTER THAT IS OPTIMIZED FOR YOUR PARTICULAR PROCESSOR(S) TO
  278.    INCREASE PROGRAM PERFORMANCE.
  279.  
  280. 7) A LOG FILE THAT IS ACTIVATED.
  281.  
  282.  
  283. TO REGISTER SEND $15.00 IN U.S. DOLLARS IN THE FORM OF CASH, CHECK
  284. DRAWN ON US BANK OR A POSTAL MONEY ORDER. PAYEE ON CHECK OR MONEY ORDER
  285. SHOULD BE MADE OUT TO ==> THERESA YEAGER
  286.  
  287. SEND TO THIS ADDRESS:
  288.  
  289. THERESA YEAGER
  290. 35 SURREY WAY
  291. EXTON  PA   19341-1670
  292.  
  293.  
  294. CASH PAYMENTS WILL HAVE A RECEIPT MAILED WITH THEIR DISK. MONEY ORDER
  295. AND CHECK CONTRIBUTORS WILL HAVE EITHER THEIR CANCLLED CHECK OR THEIR
  296. MONEY ORDER RECEIPT AS PROOF OF PAYMENT. 
  297.  
  298.  
  299.  
  300.  
  301.  
  302. INQUIRIES, BUG REPORTS, COMMERCIAL LICENSING AGREEMENTS, PROGRAM SUPPORT,
  303. SUGGESTIONS, ETC, CAN BE OBTAINED BY THE FOLLOWING METHODS:
  304.  
  305.  
  306. ELECTRONIC MEANS VIA E-MAIL:
  307.  
  308. |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  309. |PAUG (Philadelphia Amiga Users Group) BBS   USA                            |
  310. |                                                                           |
  311. |MODEM:  +1 215-551-1485  9600 > 14.4 BAUD (USR Dual Standard)      Line #1 |
  312. |        +1 215-551-6113  2400 > 14.4 BAUD (USR HST)                Line #2 |
  313. |        +1 215-551-1120  2400 > 14.4 BAUD (SupraFaxModem v.32bis)  Line #3 |
  314. |        +1 215-551-1121  2400 > 14.4 BAUD (USR HST)                Line #4 |
  315. |                                                                           |
  316. |FIDONET Address: 1:273/912                                                 |
  317. |                                                                           |
  318. |                                                                           |
  319. |Address Mail To: John Yeager                                               |
  320. |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  321.  
  322.  
  323. OR
  324.  
  325. |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  326. |Genie Local Mail:                                                          |
  327. |Address Mail To: J.Yeager5                                                 |
  328. |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  329.  
  330. OR
  331.  
  332. |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  333. |Internet Mail:                                                             |
  334. |Address Mail To: j.yeager5@genie.geis.com                                  |
  335. |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  336.  
  337. OR, Lastly
  338.  
  339. |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  340. |The U.S. Mail                                                              |
  341. |                                                                           |
  342. |JOHN YEAGER                                                                |
  343. |35 SURREY WAY                                                              |
  344. |EXTON  PA   19341-1670                                                     |
  345. |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
  346.  
  347.  
  348. I have tested the program extensively on my system with a PP&S 68040
  349. equipped A2000 with a GVP Series II hard card and three hard drives, 
  350. (Quantum 40Q, Seagate ST296N, and a Maxtor 213SY), with version
  351. 3.15 of the gvpscsi.device. It has also been tested in 68000 mode.
  352. Tests in '040 mode were made with Enforcer V37.35 activated.
  353.  
  354. It has also been tested on an A2000 with a GVP 68030 accelerator with
  355. a GVP Series II controller with no problems.
  356.