home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / FLOPPIES / QFORM10.ZIP / QFORM.DOC < prev    next >
Encoding:
Text File  |  1989-12-03  |  9.8 KB  |  244 lines

  1.                                                                       <page 1>
  2.  ╔════════════════════════════════════════════════════════════════════════════╗
  3.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  4.  ║▒▒▒████▒▒▒▒▒▒▒▒███▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  5.  ║▒▒██▒▒██▒▒▒▒▒▒██▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  6.  ║▒▒██▒▒██▒▒▒▒▒▒██▒▒▒▒▒▒████▒▒▒██▒███▒▒██▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  7.  ║▒▒██▒▒██▒▒█▒▒████▒▒▒▒██▒▒██▒▒▒███▒██▒███████▒▒▒▒▒ V E R S I O N ▒ 1 . 0 ▒▒▒▒║
  8.  ║▒▒██▒███▒▒▒▒▒▒██▒▒▒▒▒██▒▒██▒▒▒██▒▒██▒███████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  9.  ║▒▒▒████▒▒▒▒▒▒▒██▒▒▒▒▒██▒▒██▒▒▒██▒▒▒▒▒██▒█▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  10.  ║▒▒▒▒▒███▒▒▒▒▒████▒▒▒▒▒████▒▒▒████▒▒▒▒██▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  11.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  12.  ╚════════════════════════════════════════════════════════════════════════════╝
  13.  
  14.  
  15.             QFORM v1.0   Copr. 1989, Dave Williams, GRU Development
  16.  
  17.  
  18.                            Custom Diskette Formatter
  19.  
  20.  
  21.                          shareware - registration $15
  22.  
  23.  
  24.   QForm is a custom diskette formatter. When invoked with the proper command 
  25.  line, QForm can format virtually any type of diskette. You can use QForm to
  26.  format a disk quickly or with a special format.
  27.  
  28.   QForm features:
  29.  
  30.         ■ Smart XT/AT BIOS and drive detection
  31.         ■ high capacity options: extra tracks or sectors
  32.         ■ selectable ID bytes
  33.         ■ fast format (no verify)
  34.  
  35.   QForm uses the ROM BIOS routines to format floppy disks on IBM compatible
  36.  computers. Only floppy disks may be formatted: your hard disk is not
  37.  accessible to QForm. QForm will not format a network floppy drive.
  38.  
  39.   QForm manipulates hardware directly, and allows many machines which have
  40.  difficulty formatting both 1.44mb and 720k diskettes to do so without 
  41.  reconfiguring the drive or CMOS.
  42.  
  43.  
  44. _____________________________________________________________________________
  45.                                                                      <page 2>
  46.  
  47.  Table of Contents:
  48.  
  49.  
  50.    Registration and Licensing ............................................. 3
  51.  
  52.    Formatting Options ..................................................... 4
  53.  
  54.    Command Line Parameters ................................................ 5
  55.  
  56.    Error Messages ......................................................... 6
  57.  
  58.    Acknowlegements ........................................................ 7
  59.  
  60.  
  61. ______________________________________________________________________________
  62.                                                                       <page 3>
  63.         ======================== Registration ======================== 
  64.  
  65.  
  66.               noncommercial single-user registration fee: $10.00
  67.               commercial or multisystem site license fee: $40.00
  68.  
  69.  
  70.                  Send a check for US funds or company P.O. to:
  71.  
  72.  
  73.                                  Dave Williams
  74.                                   PO Box 181
  75.                           Jacksonville, AR 72076-0181
  76.                                       USA
  77.  
  78.  
  79.              Print the file ORDER.TXT for a ready-made order form.
  80.  
  81.   Registered versions of QForm are normally shipped on 5-1/4 inch diskettes.
  82.  Please specify if you need 3.5 inch diskettes instead (same price).
  83.  Your registered version will not have the brief delay after formatting. 
  84.  Support is available by BBS or through the PCRelay echomail network. 
  85.  Announcements of new versions will be posted in both places.
  86.  
  87.  
  88.           ======================== Licensing ======================== 
  89.  
  90.   QForm is the property of Dave Williams and GRU Development. No other persons
  91.  may sell QForm for a profit. Shareware resellers are allowed to distribute 
  92.  QForm provided 1) they note that Qform is a shareware product; 2) that their
  93.  price per disk does not exceed $5.00: 3) they note that disk disk price does 
  94.  not count toward the registration price of QForm.
  95.  
  96.  
  97.           ======================== Liability ======================== 
  98.  
  99.   QForm accesses the system hardware at a low level. Though precautions have
  100.  been taken to try to detect unsafe parameters, it is possible to force QForm
  101.  to damage a drive. Dave Williams and GRU Development will not be held liable
  102.  for any damages. If you are unsure of what QForm can do, don't use it!
  103.  
  104.  
  105. _____________________________________________________________________________
  106.                                                                       <page 4>
  107.      ======================== Formatting Options ======================== 
  108.  
  109.  
  110.   QForm will generate any standard DOS format. The following table shows you
  111.  what options are correct for specified formats:
  112.  
  113.   Parameter         Space                Drive Type
  114.  ------------  ---------------  ----------------------------------
  115.    /n9  /t40         360k        any drive
  116.    /n9  /t80         720k        720k 5¼, 720k 3½, 1.2m 5¼, 1.44m 3½
  117.    /n15 /t80         1.2m        1.2m 5¼
  118.    /n18 /t80         1.44m       1.44m 3½
  119.  
  120.  
  121.  
  122.   Many machines will also accept diskettes formatted with nonstandard, higher
  123.  capacity formats. Examples of these are:
  124.  
  125.   Parameter         Space                Drive Type
  126.  ------------  ---------------  ----------------------------------
  127.    /n9  /t42         380k        any drive
  128.    /n9  /t84         766k        720k 5¼, 720k 3½, 1.2m 5¼, 1.44m 3½
  129.  
  130.    /n15 /t84         1.27m       1.2m 5¼
  131.    /n18 /t84         1.53m       1.44m 3½
  132.  
  133.  
  134. ______________________________________________________________________________
  135.                                                                       <page 5>
  136.  
  137.  Command Line Parameters
  138.  
  139.  
  140.     Usage is: QForm d: [options]
  141.      Example: QForm A: /n9 /t42
  142.  
  143.  
  144.         Option   Meaning
  145.         ------   ----------------------------------------------
  146.         d:       drive to be formatted
  147.         /Tnn     format nn tracks
  148.         /Nnn     format nn sectors per track
  149.         /X       do not verify the diskette (cuts time in half)
  150.  
  151.  
  152.  
  153.   QForm takes approximately 24k of RAM while operating. On completion, it will
  154.  return one of the following DOS ERRORLEVEL codes:
  155.  
  156.  errorlevel     1       normal termination
  157.                 2       critical error: aborted by operator
  158.                 3       unrecoverable disk error
  159.                 4       too many bad sectors
  160.                 5       invalid command line parameters
  161.                 6       incorrect DOS version
  162.  
  163.  
  164.  
  165.   »» TANSTAAFL: (There Ain't No Such Thing As A Free Lunch)
  166.  
  167.   You'll notice that QForm isn't appreciably faster than DOS' FORMAT.COM. There 
  168.  is a very good reason - the NEC 765 floppy controller chip proceeds at pretty 
  169.  much its own rate regardless of software input. It formats a track, then goes 
  170.  back and rereads the track to look for errors. By turning error-checking 
  171.  (verify) off, you can cut the time in half. That's how most "fast" floppy 
  172.  formatters work. The X parameter will turn off error-checking if you insist.
  173.  I don't recommend using this parameter.
  174.  
  175.  
  176. ______________________________________________________________________________
  177.  Error messages:                                                      <page 6>
  178.  
  179.  QForm reports the following error messages:
  180.  
  181.  Error: Drivespec is SUBSTed, ASSIGNed, JOINed, or Network drive.
  182.         meaning: QForm does not work on these drive types.
  183.  
  184.  Error: No valid drives found.
  185.         meaning: QForm could not find any floppy drives.
  186.  
  187.  Error: Specified device is not a floppy drive.
  188.         meaning: You asked QForm to format something other than a floppy.
  189.  
  190.  Error: Unknown drive type.
  191.         meaning: QForm could not determine the floppy drive type. Qform
  192.                  can still format a disk if you give it the number of tracks
  193.                  and sectors and the proper ID byte.
  194.  
  195.  Error: Qform Terminated: disk error in system area.
  196.         meaning: The disk had a bad spot where QForm needed to write the boot
  197.                  sector and directory information. The disk should be
  198.                  discarded.
  199.  
  200.  Error: More than xxx sectors unreadable. QForm terminated.
  201.         meaning: QForm will abort if more than 10% of the disk is bad. The 
  202.                  disk should be discarded.
  203.  
  204.  Error: Number of heads must be 1 or 2.
  205.         meaning: Select one head for single sided, two heads for double sided.
  206.  
  207.  Error: Zero tracks requested. Format terminated.
  208.         meaning: At least one track is required to format a disk.
  209.  
  210.  Error: DOS supports only 1 or 2 sectors per cluster.
  211.         meaning: DOS would not recognize the disk if formatted with more than
  212.                  two sectors per cluster.
  213.  
  214.  Error: Too many root directory entries.
  215.         meaning: DOS accepts a maximum of 112 or 224 entries in the root
  216.                  depending on disk type.
  217.  
  218.  Error: Diskette cannot be formatted.
  219.         meaning: The diskette controller chip has reported an unknown
  220.                  failure condition and aborted the format.
  221.  
  222.  Caution! That many tracks could cause damage to your drive.
  223.         meaning: Formatting more than 42 tracks on a 40 track drive or 84
  224.                  tracks on an 80 track drive could damage the drive mechanism.
  225.  
  226.  Head: (head) Track: (track) marked bad
  227.         meaning: QForm found a bad place at the indicated location.
  228.  
  229.  
  230. ______________________________________________________________________________
  231.                                                                       <page 7>
  232.  
  233.   Acknowlegements:
  234.  
  235.   QForm is written in Borland's Turbo Pascal v5.5 and Microsoft's Macro 
  236.  Assembler v5.1. Portions of code were developed by Kim Kokkonen of Turbo
  237.  Power Software, 3109 Scotts Valley Dr. #122, Scotts Valley CA 95066, and
  238.  adapted for my purposes. Kim has most kindly allowed his code to be used;
  239.  he also sells some of the best Turbo Pascal programming tools around.
  240.  
  241.  
  242.  
  243.  
  244.