home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / LA023.ZIP / QFORM195.ZIP / QFORM.DOC < prev    next >
Encoding:
Text File  |  1990-03-14  |  21.4 KB  |  433 lines
  1.                                                                       <page 1>
  2.  ╔════════════════════════════════════════════════════════════════════════════╗
  3.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  4.  ║▒▒▒████▒▒▒▒▒▒▒▒███▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  5.  ║▒▒██▒▒██▒▒▒▒▒▒██▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  6.  ║▒▒██▒▒██▒▒▒▒▒▒██▒▒▒▒▒▒████▒▒▒██▒███▒▒██▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  7.  ║▒▒██▒▒██▒▒█▒▒████▒▒▒▒██▒▒██▒▒▒███▒██▒███████▒▒▒▒▒ V E R S I O N ▒ 1.95 ▒▒▒▒▒║
  8.  ║▒▒██▒███▒▒▒▒▒▒██▒▒▒▒▒██▒▒██▒▒▒██▒▒██▒███████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  9.  ║▒▒▒████▒▒▒▒▒▒▒██▒▒▒▒▒██▒▒██▒▒▒██▒▒▒▒▒██▒█▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  10.  ║▒▒▒▒▒███▒▒▒▒▒████▒▒▒▒▒████▒▒▒████▒▒▒▒██▒▒▒██▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  11.  ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║
  12.  ╚════════════════════════════════════════════════════════════════════════════╝
  13.  
  14.  
  15.             QFORM v1.95  Copr. 1989, 1990  Dave Williams, GRU Development
  16.  
  17.  
  18.                            Custom Diskette Formatter
  19.  
  20.  
  21.                          shareware - registration $10
  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.         ■ high capacity options: extra tracks or sectors
  31.         ■ fast format (no verify)
  32.         ■ optional "boot through" to hard disk if diskette is in A: drive
  33.         ■ add a volume label automatically during format
  34.         ■ quick /4 and /7 commands force 360k and 720k formats
  35.         ■ batch formatting
  36.  
  37.   QForm uses the ROM BIOS routines to format floppy disks on IBM compatible
  38.  computers. Only floppy disks may be formatted: your hard disk is not
  39.  accessible to QForm. QForm will not format a network floppy drive.
  40.  
  41.   QForm manipulates hardware directly, and allows many machines which have
  42.  difficulty formatting both 1.44mb and 720k diskettes to do so without 
  43.  reconfiguring the drive or CMOS.
  44.  
  45.  
  46.                              ┌─────────┐
  47.                        ┌─────┴───┐     │              (tm)
  48.                      ──│         │o    │──────────────────
  49.                        │   ┌─────┴╨──┐ │  Association of
  50.                        │   │         │─┘  Shareware
  51.                        └───│    o    │    Professionals
  52.                      ──────│    ║    │────────────────────
  53.                            └────╨────┘    MEMBER
  54.  
  55.  
  56. _____________________________________________________________________________
  57.                                                                      <page 2>
  58.  Table of Contents:
  59.  
  60.    Registration and Licensing ............................................. 3
  61.  
  62.    Formatting Options ..................................................... 4
  63.  
  64.    Command Line Parameters ................................................ 5
  65.  
  66.    Error Messages ......................................................... 6
  67.  
  68.    Acknowlegements ........................................................ 7
  69.  
  70.    History and Bug List ................................................... 8
  71.  
  72.  
  73. ______________________________________________________________________________
  74.                                                                       <page 3>
  75.         ======================== Registration ======================== 
  76.  
  77.  
  78.               noncommercial single-user registration fee: $10.00
  79.               commercial or multisystem site license fee: $30.00
  80.  
  81.  
  82.                  Send a check for US funds or company P.O. to:
  83.  
  84.  
  85.                                  Dave Williams
  86.                                 PO Box 181 - B
  87.                           Jacksonville, AR 72076-0181
  88.                                       USA
  89.  
  90.  
  91.              Print the file ORDER.TXT for a ready-made order form.
  92.  
  93.   Registered versions of QForm are normally shipped on 5-1/4 inch diskettes.
  94.  Please specify if you need 3.5 inch diskettes instead (same price).
  95.  Your registered version will not have the brief delay after formatting. 
  96.  Support is available by BBS or through the PCRelay echomail network. 
  97.  Announcements of new versions will be posted in both places.
  98.  
  99.  
  100.           ======================== Licensing ======================== 
  101.  
  102.   QForm is the property of Dave Williams and GRU Development. No other persons
  103.  may sell QForm for a profit. Shareware resellers are allowed to distribute 
  104.  QForm provided 1) they note that Qform is a shareware product; 2) that their
  105.  price per disk does not exceed $5.00: 3) they note that disk's price does not
  106.  count toward the registration price of QForm.
  107.  
  108.  
  109.           ======================== Liability ======================== 
  110.  
  111.   QForm accesses the system hardware at a low level. Though precautions have
  112.  been taken to try to detect unsafe parameters, it is possible to force QForm
  113.  to damage a drive. Dave Williams and GRU Development will not be held liable
  114.  for any damages. If you are unsure of what QForm can do, don't use it!
  115.  
  116.   This program is produced by a member of the Association of Shareware
  117.  Professionals (ASP). The ASP wants to make sure that the shareware principle
  118.  works for you. If you are unable to resolve a shareware-related problem with
  119.  an ASP member by contacting the member directly, ASP may be able to help. The
  120.  ASP Ombudsman can help you resolve a dispute or problem with an ASP member,
  121.  but does not provide technical support for members' products. Please write to
  122.  the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
  123.  message via EasyPlex to ASP Ombudsman 70007,3536
  124.  
  125.  
  126. _____________________________________________________________________________
  127.                                                                       <page 4>
  128.      ======================== Formatting Options ======================== 
  129.  
  130.  
  131.   QForm will generate any standard DOS format. The following table shows you
  132.  what options are correct for specified formats:
  133.  
  134.   Parameter         Space                Drive Type
  135.  ------------  ---------------  ----------------------------------
  136.    /n:9  /t:40       360k        any drive
  137.    /n:9  /t:80       720k        720k 5¼, 720k 3½, 1.2m 5¼, 1.44m 3½
  138.    /n:15 /t:80       1.2m        1.2m 5¼
  139.    /n:18 /t:80       1.44m       1.44m 3½
  140.  
  141.  
  142.   Many machines will also accept diskettes formatted with nonstandard, higher
  143.  capacity formats. Examples of these are:
  144.  
  145.   Parameter         Space                Drive Type
  146.  ------------  ---------------  ----------------------------------
  147.    /n:9  /t:42       380k        any double-sided drive
  148.    /n:9  /t:84       766k        720k 5¼, 720k 3½, 1.2m 5¼, 1.44m 3½
  149.  
  150.    /n:15 /t:84       1.27m       1.2m 5¼, 1.44m 3½
  151.    /n:18 /t:84       1.53m       1.44m 3½
  152.  
  153.  
  154.   QForm will automatically try to format a diskette at the highest capacity
  155.  offered by the drive. If you have a 1.2 or a 1.44 and wish to format a 360
  156.  or 720 you will need to override QForm's autodetection with the command line
  157.  switches.
  158.  
  159.  Please note:
  160.  
  161.   The 42 and 84 track parameters are not specifically supported by many floppy 
  162.  drives. Use of these parameters is strictly "at your own risk." Though these
  163.  parameters have not damaged any of the hardware they have been tested on, it 
  164.  is possible they might cause damage to your drive. If your drive makes any 
  165.  unusual noises, stop at once!
  166.  
  167.  
  168.  
  169. ______________________________________________________________________________
  170.                                                                       <page 5>
  171.  Command Line Parameters
  172.  
  173.   Commands may be entered in upper or lower case. All commands are separated
  174.  by forward slashes (/). Spaces between commands are optional.
  175.  
  176.     Usage is: QForm d: [options]
  177.     Examples: QForm A: /n:9 /t:42 /x
  178.               QForm B: /n:9 /t:80 /b /!
  179.  
  180.         Option    Meaning                                          Version
  181.         ------    ----------------------------------------------  ---------
  182.         d:        drive to be formatted                              v1.0
  183.         /R        show registration information                      v1.91
  184.         /T:nn     format nn tracks                                   v1.0
  185.         /N:nn     format nn sectors per track                        v1.0
  186.         /X        do not verify the diskette (cuts time in half)     v1.0
  187.         /!        make audible signal at end of format               v1.32
  188.         /B        "boot through" to hard disk                        v1.6
  189.         /V        prompt for volume label after format               v1.5
  190.         /V:label  automatically add "label" after format             v1.5
  191.         /4        forces 360k format in any drive                    v1.7
  192.         /7        forces 720k format in 1.44meg drive                v1.7
  193.         /E        384k format on 360k drive                          v1.7
  194.         /S        format a system (bootable) diskette                v1.8
  195.         /#:nn     format nn diskettes                                v1.9
  196.  
  197.  
  198.  Detailed explanation of command parameters:
  199.  
  200.  d:     Floppy drive to format. May be any valid non-networked floppy drive,
  201.         including those with drive letters which appear after the hard drive,
  202.         as with some secondary floppy controllers. QForm will not format
  203.         network drives.
  204.  
  205.  /T:xx  This sets the number of tracks. Standard diskettes format at 40 or 80
  206.         tracks. QForm allows you to format disks with more or fewer tracks.
  207.         You can normally format 40 track drives to 42 tracks, and 80 track
  208.         drives to 84 tracks without problems.
  209.  
  210.  /N:xx  Sets number of sectors per track. QForm defaults to 9, 15, or 18 
  211.         sectors depending on the type of drive and requested format. DOS does
  212.         not normally recognize other values. A future version of QForm will
  213.         include a device driver that will allow use of more sectors than DOS
  214.         presently allows. If you have one of the rare DOS versions that will
  215.         read a 10 sector diskette, you can use QForm to format new diskettes.
  216.  
  217.  /X     Turns off verification during format. This can reduce formatting times
  218.         40-45%. See "TANSTAAFL" below!
  219.  
  220.  /!     Makes an audible signal when format is complete. Handy when you have
  221.         better things to do than babysit the keyboard.
  222.  
  223.  /B     QForm defaults to a standard IBM-type boot sector. With /B, QForm
  224.         writes a special boot sector that lets you leave a diskette in drive A
  225.         when booting off the hard disk. The machine will look at the floppy in
  226.         A, then proceed to boot off the hard disk. The /S option overrides
  227.         this option.
  228.  
  229.  /V     Prompts for a volume label after format. See your DOS manual for a
  230.         discussion of valid volume labels.
  231.  
  232.  /V:xxx Puts label "xxx" on the floppy automatically after format. Spaces are
  233.         not allowed in labels applied with this option.
  234.  
  235.  /4     Forces a 360k format on any drive. This allows you to format a 360k
  236.         diskette and use one of the sector copiers to move copy protected
  237.         software from a 5-1/4 to a 3-1/2 diskette, or to format a 360k 
  238.         diskette in a 1.2 meg drive. Please note: not all 1.2 meg drives are
  239.         capable of writing diskettes which can be read on a 360k drive!
  240.  
  241.  /7     Forces a 720k format on any compatible drive. Saves typing a lot of
  242.         parameters. Useful for 720s in machines with 1.44s with no disk type
  243.         detection (early PS/2s cannot identify a 720 in a 1.44), for old XTs
  244.         with 720k drives (BIOS defaults to 40 tracks).
  245.  
  246.  /E     This option lets you format a standard 360k floppy to 384k by adding
  247.         two more tracks and reducing the number of directory entries from 112
  248.         to 16. This reduces the directory size from 7 sectors to 1 sector. Disk
  249.         space is 384,000 bytes. This format can be read by any MSDOS machine,
  250.         and was pioneered by Eric Tauck (hence the /E parameter). DISKCOPY,
  251.         CHKDSK, and all OEM DOS utilities recognize this format.
  252.  
  253.  /S     Make SYSTEM (bootable) diskette. QForm uses your own DOS' SYS command
  254.         to place the DOS files on your diskette. It initially assumes that the
  255.         drive you ran QForm from was the boot drive and that SYS is in your
  256.         PATH statment. If your system configuration is different, you can add
  257.         the statement BOOT=C:COMMAND.COM (or wherever) to your DOS environment.
  258.         QForm will change to that drive and execute the SYS command.
  259.          An advantage to this is the ability to format a diskette with any DOS
  260.         version you want. For example, you could set BOOT=A:COMMAND.COM to
  261.         format a DOS 2.1 diskette while running DOS 4.0. The drive letter tells
  262.         QForm where to look for the system files. The filename is the name of
  263.         the DOS command interpreter, normally COMMAND.COM, though you might be
  264.         using the popular 4DOS or Command Plus interpreters.
  265.          Why exec the SYS command? There is no simple way to identify the
  266.         system files on your computer. The prime culprit is DR-DOS, which uses
  267.         a very different layout from MSDOS. The SYS command will always work,
  268.         while poking about on your system may not yield the proper results.
  269.          Note that most DOS versions will happily boot off somewhat nonstandard
  270.         diskettes.
  271.  
  272.  
  273.  /#:nn  Batch format of nn diskettes.
  274.  
  275.   QForm takes approximately 24k of RAM while operating. On completion, it will
  276.  return one of the following DOS ERRORLEVEL codes:
  277.  
  278.  errorlevel     1       normal termination
  279.                 2       critical error: aborted by operator
  280.                 3       unrecoverable disk error
  281.                 4       too many bad sectors
  282.                 5       invalid command line parameter
  283.                 6       error writing volume label
  284.  
  285.  
  286.   »» TANSTAAFL: (There Ain't No Such Thing As A Free Lunch)
  287.  
  288.   You'll notice that QForm isn't appreciably faster than DOS' FORMAT.COM. There 
  289.  is a very good reason - the NEC 765 floppy controller chip proceeds at pretty 
  290.  much its own rate regardless of software input. It formats a track, then goes 
  291.  back and rereads the track to look for errors. By turning error-checking 
  292.  (verify) off, you can cut the time in half. That's how most "fast" floppy 
  293.  formatters work. The X parameter will turn off error-checking if you insist.
  294.  I don't recommend using this parameter unless you are reformatting a floppy
  295.  previously known to be good. Think of the X as a skull and crossbones.
  296.  
  297.  
  298. ______________________________________________________________________________
  299.  Error messages:                                                      <page 6>
  300.  
  301.  QForm reports the following error messages:
  302.  
  303.  Error: Drivespec is SUBSTed, ASSIGNed, JOINed, or Network drive.
  304.         meaning: For safety reasons, QForm does not work on these drive types.
  305.  
  306.  Error: No valid drives found.
  307.         meaning: QForm could not find any floppy drives.
  308.  
  309.  Error: Specified device is not a floppy drive.
  310.         meaning: You asked QForm to format something other than a floppy.
  311.  
  312.  Error: Unknown drive type.
  313.         meaning: QForm could not determine the floppy drive type. Qform
  314.                  can still format a disk if you give it the number of tracks
  315.                  and sectors and the proper ID byte.
  316.  
  317.  Error: QForm Terminated: disk error in system area.
  318.         meaning: The disk had a bad spot where QForm needed to write the boot
  319.                  sector and directory information. The disk should be
  320.                  discarded.
  321.  
  322.  Error: QForm terminated. Too many bad sectors.
  323.         meaning: QForm will abort if more than 10% of the disk is bad. The 
  324.                  disk should be discarded.
  325.  
  326.  Error: Diskette cannot be formatted.
  327.         meaning: The diskette controller chip has reported an unknown
  328.                  failure condition and aborted the format. This message can
  329.                  come up with some machines using not-quite-compatible BIOSes.
  330.  
  331.  Error: Too many tracks for detected drive type. Continue (Y/N)?
  332.         meaning: Formatting more than 42 tracks on a 40 track drive or 84
  333.                  tracks on an 80 track drive could damage the drive mechanism.
  334.                  This message may come up on some older XTs with 720k drives.
  335.                  Be careful when overriding this warning - trying to format
  336.                  80 tracks on a 40 track drive can destroy the drive!
  337.  
  338.  
  339. ______________________________________________________________________________
  340.                                                                       <page 7>
  341.  
  342.   Acknowlegements:
  343.  
  344.   Richard Hamming noted, "Isaac Newton could see so far because he was like a
  345.  midget standing on the shoulders of giants. Programmers, however, are like
  346.  midgets standing on the toes of other midgets."
  347.  
  348.   No piece of software is written in a vacuum. QForm's development has been
  349.  influenced by the information available to me as it was written. QForm is
  350.  written in Borland's Turbo Pascal v5.5 and Microsoft's Macro Assembler v5.1.
  351.  
  352.   Portions of code used in QForm were originally developed by Kim Kokkonen of
  353.  Turbo Power Software, 3109 Scotts Valley Dr. #122, Scotts Valley CA 95066,
  354.  and adapted for my purposes. Kim also sells some of the best Turbo Pascal
  355.  programming tools around.
  356.  
  357.   Eric Tauck's BDISK and FORDSK programs, Jacques Pierson's SDF, Peter Norton's
  358.  FCOPY, (remember that one, Peter?), F.M. de Monasterio's NEWBOOT3, Jeff
  359.  Prosise' DISKPREP, B. Gibson's BOOTHRU, Sanford J. Zelkovitz' INTRCPT3, David
  360.  Rifkind's SKEWTEST, and other programs were valuable sources of information.
  361.  
  362.   Much information was gathered from Byte Magazine's BIX system, thanks to
  363.  John Switzer, David Rifkind, Roedy Green, Donn Anderson, and others. Thanks
  364.  again, guys.
  365.  
  366.   Finally, the "authoritative Word" came from the disassembly and inspection of
  367.  good ol' DOS 2.1 and 3.3 FORMAT.COM via V Communications' incredible SOURCER
  368.  code disassembler and by inspection of formatted disks with Central Point's
  369.  CopyIIPC Option Board.
  370.  
  371.  
  372. ______________________________________________________________________________
  373.                                                                       <page 8>
  374.  
  375.   History:
  376.  
  377.  12/03/89  v1.0   first shareware version of QForm
  378.  12/11/89  v1.01  added color support
  379.  01/15/90  v1.1   documentation reflects ASP membership; DOS version check
  380.                   eliminated for proper function on Toshiba 1000 (oops!);
  381.                   added elapsed time counter; fixed cursor-loss on fatal error
  382.  02/07/90  v1.2   fixed a bug which prevented some machines from being able
  383.                   to read 720k 3½" diskettes generated by QForm
  384.  02/21/90  v1.3   added track count, added colon requirement on command line
  385.                   to match Microsoft practice
  386.  02/23/90  v1.31  fixed incomplete display problem for CGA monitors, changed
  387.                   registration price from $15 to $10
  388.  02/24/90  v1.32  added /! switch to put audible signal at end of format
  389.  02/27/90  v1.4   fixed improper media byte problem on some XTs with high
  390.                   density floppy controllers. Substantial code rewriting.
  391.  02/28/90  v1.5   added /V: and /V commands for volume label
  392.  03/01/90  v1.6   added /B "boot through" option
  393.  03/01/90  v1.61  turned control-break checking on for those "uh-oh" times
  394.  03/02/90  v1.62  revamped error messages
  395.  03/02/90  v1.63  now checks state of DOS verify flag, turns verify off while
  396.                   formatting (we're monitoring directly and don't need the DOS
  397.                   overhead) and restores original verify state on exit
  398.  03/04/90  v1.7   added /4 command for 360k in 1.2mb drive, /7 command for
  399.                   720k disk in 1.44 w/o drive detect
  400.  03/05/90  v1.71  added README.EXE to read documentation
  401.  03/09/90  v1.8   added /S command to format system disk, BOOT= environment
  402.                   variable to find system drive
  403.  03/10/90  v1.85  fixed bug that prevented formatting 720k diskettes on older
  404.                   XTs without BIOS support
  405.  03/12/90  v1.9   added /#:nn to batch format diskettes
  406.  03/13/90  v1.91  added /R command for shareware information
  407.  03/14/90  v1.95  enhanced /S option to allow loading of system files and
  408.                   command interpreter from any given drive.
  409.  
  410.   Bug List:
  411.  
  412.  1)  Doesn't always work properly on XT machines with high density floppy 
  413.  controllers and 1.2 or 1.44 drives. Usually just doesn't work at all if
  414.  there's any problem. I've chased this one round and round, and some of the
  415.  BIOSes in the el cheapo cards are... well... icky.
  416.  
  417.  2)  Though I haven't actually come across one yet, it's possible one of the
  418.  OEM customized DOS versions might not work with a nonstandard format. Some
  419.  vendors (like Tandy) modify the actual DOS files heavily and then buy the
  420.  utilities from a place like Phoenix. Toshiba writes their own utilities. If
  421.  the vendor messed with the DOS too much QForm might not work. Same goes for
  422.  the various BIOS versions, especially those oddball Kwai-Chang Klone jobs.
  423.  
  424.  3)  QForm can't reliably tell what sort of diskette is in the floppy drive,
  425.  so it tries to format a diskette as high density if a high density drive
  426.  is present. This may be corrected in a future version. The main problem is
  427.  that some of IBM's PS/2 machines don't have any way to detect a low density
  428.  diskette in a high density drive; the physical hardware isn't there. Again,
  429.  some of those pesky cheapo high density XT controllers don't monitor the
  430.  correct lines of the floppy drive, which may or may not be configured right
  431.  anyway. <heavy sigh>
  432.  
  433.