home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / assemblr / library / sampler0 / freecopy.doc < prev    next >
Text File  |  1985-06-06  |  29KB  |  1,428 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                    THIS IS THE BEGINNING OF THE DOCUMENT
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.                      ****** FREECOPY Users Guide *****             Page   1.
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.                  ---------------------------------------------------
  92.  
  93.                                   F R E E C O P Y
  94.  
  95.                     A Disk Utility for the IBM Personal Computer
  96.  
  97.                       Users Guide by Donald L. Buresh, C.D.P.
  98.  
  99.                                     Version 1.10
  100.  
  101.                 (C)Copyright 1984, 85  Squire Buresh Associates, Inc.
  102.  
  103.                            $25.00 Requested Contribution
  104.  
  105.                  ---------------------------------------------------
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.                      ****** FREECOPY Users Guide *****             Page   2.
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.                              TABLE OF CONTENTS
  150.  
  151.  
  152.                                                                Page
  153.  
  154.  
  155.         I. To the Users of FREECOPY                              3
  156.  
  157.        II. Running FREECOPY                                      5
  158.  
  159.       III. Notes on FREECOPY
  160.               a. The Parameters                                  6
  161.               b. Fragmented Data                                 7
  162.               c. Disk Errors                                     8
  163.  
  164.        IV. Messages from FREECOPY
  165.               a. Informative Messages                           10
  166.               b. Error Messages                                 13
  167.  
  168.         V. Remarks on User Supported Software                   17
  169.  
  170.        VI. Acknowledgements                                     19
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.                      ****** FREECOPY Users Guide *****             Page   3.
  205.  
  206.  
  207.  
  208.  
  209.  
  210.         I. To the Users Of FREECOPY
  211.  
  212.            This is a short summary describing what is on the FREECOPY
  213.  
  214.         diskette.  FREECOPY is a disk utility that is functionally
  215.  
  216.         equivalent to DISKCOPY which is distributed with IBM PC DOS.
  217.  
  218.            I am releasing this software into the public domain because I
  219.  
  220.         believe that the time has come for users to see and criticize 
  221.  
  222.         professional quality source code.  I welcome all comments on 
  223.  
  224.         FREECOPY, particularly about any bugs you discover in the code.
  225.  
  226.            In developing FREECOPY, I reversed engineered DISKCOPY and made
  227.  
  228.         sure that I did not violate the proprietary rights of either IBM or
  229.  
  230.         Microsoft.  In fact, I took great pains to ensure that FREECOPY
  231.  
  232.         is better than DISKCOPY.
  233.  
  234.            The three (3) files that are on this diskette are:
  235.  
  236.                   o FREECOPY.COM - The executable code
  237.  
  238.                   o FREECOPY.ASM - The source code
  239.  
  240.                   o FREECOPY.DOC - A users guide
  241.  
  242.  
  243.           The executable code is a binary .COM file that comes in machine
  244.  
  245.         readable format.  The source code is structured assembly language
  246.  
  247.         with lots of comments.  This users guide is a short document
  248.  
  249.         describing how to run FREECOPY.
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.                      ****** FREECOPY Users Guide *****             Page   4.
  271.  
  272.  
  273.  
  274.            FREECOPY is the first of a series of assembly language programs
  275.  
  276.         that I am distributing on a user supported basis.  I will create
  277.  
  278.         significant programs for the PC community.  These programs will 
  279.  
  280.         appear in conjunction with the articles that I am writing for the
  281.  
  282.         disk-based magazine PC FIRING LINE edited by Bill Salkin.  I am
  283.  
  284.         writing the PC DOS/ROM column.
  285.  
  286.             If you find FREECOPY helpful, please give the package to other
  287.  
  288.         users without alteration so that I can answer people's questions. 
  289.  
  290.         I am requesting a $25.00 contribution.  If you want a copy, send a
  291.  
  292.         self-addressed postage-paid mailer along with a formatted diskette
  293.  
  294.         to us.  No exceptions, please.
  295.  
  296.             Regardless of the contribution, users are encouraged to copy and
  297.  
  298.          share the program with other users.
  299.  
  300.  
  301.  
  302.  
  303.  
  304.                                        - Donald L. Buresh, C.D.P. -
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.                      ****** FREECOPY Users Guide *****             Page   5.
  337.  
  338.  
  339.  
  340.  
  341.  
  342.         II. Running FREECOPY
  343.  
  344.            FREECOPY copies the source diskette on a track by track basis
  345.  
  346.         to the target diskette  formatting and then writing to the target
  347.  
  348.         diskette.  The utility does not check the drive letter to see
  349.  
  350.         if you specified a hard disk drive.
  351.  
  352.            Before invoking FREECOPY, examine the PC DOS prompt (e.g.,
  353.  
  354.         A> for drive A:) that denotes the default drive.  To execute
  355.  
  356.         FREECOPY, enter the command:
  357.  
  358.                               FREECOPY X: Y:/1
  359.  
  360.         where the first parameter X: specifies the source drive, the second
  361.  
  362.         parameter Y: indicates the target drive and the /1 parameter
  363.  
  364.         instructs the utility to copy only the top side of the source
  365.  
  366.         diskette.
  367.  
  368.            The disk drives X: and Y: may or may not be the same.  If they
  369.  
  370.         are equal to each other or omitted altogether, FREECOPY copies the
  371.  
  372.         source diskette using a single drive.  The program prompts you to
  373.  
  374.         insert the appropriate diskette at the correct time.
  375.  
  376.            When FREECOPY finishes copying a diskette, the program asks
  377.  
  378.         you if you want to continue.  If you press Y(es), FREECOPY starts
  379.  
  380.         the process all over again with the same parameters that you
  381.  
  382.         specified when invoking the program.  If you press N(o), FREECOPY
  383.  
  384.         returns to PC DOS.  The program ignores all other answers except
  385.  
  386.         Control-C or Control-Break which also transfers control to PC DOS. 
  387.  
  388.  
  389.  
  390.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.                      ****** FREECOPY Users Guide *****             Page   6.
  403.  
  404.  
  405.  
  406.  
  407.  
  408.         III. Notes on FREECOPY
  409.  
  410.            These notes on FREECOPY demonstrate to the user the features
  411.  
  412.         and/or limitations of the program.
  413.  
  414.         a. The Parameters
  415.  
  416.             If you do not specify both disk drive parameters, FREECOPY
  417.  
  418.         copies the source diskette using only the PC DOS default drive.
  419.  
  420.         For exammple, if the PC default drive is B:, and you invoke
  421.  
  422.         FREECOPY with the command:
  423.  
  424.                               B>FREECOPY
  425.  
  426.         the program copies the source diskette onto the target diskette
  427.  
  428.         using only drive B:.
  429.  
  430.            If you specify only one disk drive parameter, FREECOPY assumes
  431.  
  432.         that it is the source drive and that the target drive is the PC DOS
  433.  
  434.         default drive.  For example, if A: is the PC DOS default drive and
  435.  
  436.         you enter the command:
  437.  
  438.                               A>FREECOPY B:
  439.  
  440.         the program assumes that the source drive is B: and the target drive
  441.  
  442.         is A:.  If the default drive is the same as the drive that you
  443.  
  444.         indicated when you entered the command, FREECOPY copies the source
  445.  
  446.         diskette using a single drive.  This command might look like:
  447.  
  448.                               B>FREECOPY B:
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.                      ****** FREECOPY Users Guide *****             Page   7.
  469.  
  470.  
  471.  
  472.  
  473.            If you enter distinct source and target disk drivers, FREECOPY
  474.  
  475.         will follow your command exactly.  For example, if A: is the PC DOS
  476.  
  477.         default drive and you enter:
  478.  
  479.                               A>FREECOPY A: B:
  480.  
  481.         the program copies the the source diskette in drive A: to the target
  482.  
  483.         diskette in drive B:.  However, if you have only one disk drive on
  484.  
  485.         your system, FREECOPY is smart enough to use one drive.
  486.  
  487.            If you employ the /1 parameter when invoking FREECOPY, the program
  488.  
  489.         copies the top side of the source diskette.  If the source drive is
  490.  
  491.         single sided, FREECOPY recognizes that this parameter is not
  492.  
  493.         necessary.
  494.  
  495.         b. Fragmented Data
  496.  
  497.            While using a diskette, the sectors that contain your data may
  498.  
  499.         not be in sequential order.  This situation occurs because PC DOS
  500.  
  501.         uses the first available sector when writing files regardless of its
  502.  
  503.         position on the diskette.
  504.  
  505.            A diskette with fragmented files degrades the performance of
  506.  
  507.         PC DOS causing excessive head movement when reading and/or writing
  508.  
  509.         a file.  If so, you may want to use the COPY command to copy the
  510.  
  511.         files from the source diskette to the target diskette.
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.                      ****** FREECOPY Users Guide *****             Page   8.
  535.  
  536.  
  537.  
  538.  
  539.  
  540.         c. Disk Errors
  541.  
  542.            There are many reasons for a diskette error.  The two (2) most
  543.  
  544.         common reasons are:
  545.  
  546.                   o The mylar for a given track wears out; or
  547.  
  548.                   o The contents of the diskette are copy protected
  549.                     by the software manufacturer.
  550.  
  551.             All things have a finite lifespan, including diskettes.  When the
  552.  
  553.         mylar of a track can no longer retain the data, FREECOPY can do very
  554.  
  555.         little to recover the information.  We recommend that you always
  556.  
  557.         maintain a backup diskette of your important data.
  558.  
  559.            It is unfortunate that some software manufacturers make it
  560.  
  561.         difficult, if not impossible, to copy their programs. It is our
  562.  
  563.         opinion that copy protection assumes that everyone will attempt to
  564.  
  565.         violate the software manufacturer's rights.  One of the fundamental
  566.  
  567.         principles of FREEWARE is that the user has the right to
  568.  
  569.         examine the quality of the source code before deciding whether
  570.  
  571.         or not they want to purchase it.  FREECOPY is consistent with the
  572.  
  573.         FREEWARE concept and it does not currently break any copy protection
  574.  
  575.         schemes.
  576.  
  577.            FREECOPY always displays the head and track number that it is
  578.  
  579.         currently processing.  If the program encounters a disk error,
  580.  
  581.         it displays the appropriate message on the screen.  Section IV of
  582.  
  583.         this manual describes the messages in great detail.
  584.  
  585.  
  586.  
  587.  
  588.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.                      ****** FREECOPY Users Guide *****             Page   9.
  601.  
  602.  
  603.  
  604.  
  605.  
  606.         If FREECOPY encounters a disk error for either the source or
  607.  
  608.         target diskette, that diskette may or may not be usable, depending
  609.  
  610.         on whether the affected track contains valid data.
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.                      ****** FREECOPY Users Guide *****             Page   10.
  667.  
  668.  
  669.  
  670.  
  671.  
  672.         IV. Messages from FREECOPY
  673.  
  674.            The messages that FREECOPY displays on the screen come in two
  675.  
  676.         varieties: informative messages and error messages.
  677.  
  678.         a. Informative Messages
  679.  
  680.            Copy another diskette (Y/N)?
  681.  
  682.               If you want to copy another diskette, enter Y(y) and FREECOPY
  683.               prompts you to insert a diskette in the source drive.  If you
  684.               reply N(n), the program returns control to PC DOS.  FREECOPY
  685.               ignores any other answer except Control-C, Control-Break and
  686.               Control-Alt-Del.
  687.  
  688.  
  689.            Copy is complete.
  690.  
  691.               FREECOPY has successfully copied the contents of the source
  692.               diskette onto the target diskette.
  693.  
  694.  
  695.            Copying X sectors per track, Y side.
  696.  
  697.               This message tells you that a source diskette is a PC DOS 1.0,
  698.               1.1 or 2.0 diskette, single or double sided.
  699.  
  700.  
  701.            Correct, and press any key to continue.
  702.  
  703.               This message appears when FREECOPY is unable to validate a
  704.               source diskette for one or more of the following reasons:
  705.  
  706.                         o The diskette is unformatted;
  707.  
  708.                         o The first byte of the File Allocation Table (FAT)
  709.                           is invalid;
  710.  
  711.                         o A double sided diskette is placed in a single
  712.                           sided source drive and the user did not ask
  713.                           FREECOPY to copy only the first side.
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.                      ****** FREECOPY Users Guide *****             Page   11.
  733.  
  734.  
  735.  
  736.  
  737.  
  738.            A diskette is not in drive X:.
  739.  
  740.               FREECOPY displays this message on the screen when there is
  741.               no diskette in either the source or target drive.
  742.  
  743.  
  744.            Insert source diskette in drive X:.
  745.  
  746.               This message tells you when to insert the source diskette
  747.               into the source drive.
  748.  
  749.  
  750.            Insert target diskette in drive Y:.
  751.  
  752.               This message appears on the screen when FREECOPY is ready to
  753.               copy the source diskette onto the target diskette.
  754.  
  755.  
  756.            Insufficient memory.
  757.  
  758.               FREECOPY puts this message on the screen when there is not
  759.               enough free memory on the machine to contain:
  760.  
  761.                         o A complete copy of COMMAND.COM, including the
  762.                           resident portion in low memory and the transient
  763.                           portion in high memory (PC DOS 1.0 and 1.1 only);
  764.  
  765.                         o A copy of the ES:BX table that holds the beginning
  766.                           addresses of each track stored in memory;
  767.  
  768.                         o A copy of the CHRN table that is used when the 
  769.                           target diskette is unformatted;
  770.  
  771.                         o A copy of the File Allocation Table (FAT) of the
  772.                           source diskette;
  773.  
  774.                         o At least one (1) track of the source diskette.
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.                      ****** FREECOPY Users Guide *****             Page   12.
  799.  
  800.  
  801.  
  802.  
  803.  
  804.            Invalid parameter(s) specified.
  805.  
  806.               FREECOPY issues this message when a colon did follow a drive
  807.               letter, a file name appears after a drive letter and a colon,
  808.               or a /1 occurs in the wrong position.
  809.  
  810.  
  811.            Invalid default floppy disk drive.
  812.  
  813.               The program issues this message when the PC DOS default drive
  814.               is invalid.  It can occur when a system has more than four (4)
  815.               logical disk drives that reside on a hard disk.
  816.  
  817.  
  818.            Note: Copying diskette on a single drive.
  819.  
  820.               FREECOPY displays this message and sounds the bell to inform
  821.               you that it is using one (1) drive to copy the source diskette.
  822.  
  823.  
  824.            Press any key when ready.
  825.  
  826.               This message is self-explanatory. Press any key except
  827.               Control-C or Control-Break to continue the processing.
  828.  
  829.  
  830.            Reading track (XX)  head (Y).
  831.  
  832.               The program issues this message when it is reading the source
  833.               diskette.
  834.  
  835.  
  836.            Returning to PC DOS.
  837.  
  838.               FREECOPY puts this message on the screen whenever it transfers
  839.               control back to PC DOS.
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.                      ****** FREECOPY Users Guide *****             Page   13.
  865.  
  866.  
  867.  
  868.  
  869.  
  870.            Write source diskette again (Y/N)?
  871.  
  872.               This message asks a user if he/she wants another copy of the
  873.               source diskette.  It appears only  when the computer can
  874.               store the source diskette completely in memory.
  875.  
  876.  
  877.            Writing track (XX)  head (Y).
  878.  
  879.               This message tells you the track and head that FREECOPY is
  880.               writing onto the target diskette.
  881.  
  882.  
  883.         b. Error Messages
  884.  
  885.            Address mark was not found.
  886.  
  887.               When this message appears, INT 13H was not able to find the
  888.               CHRN entry that is standard for PC DOS diskettes.  The diskette
  889.               is probably copy-protected by the manufacturer.
  890.  
  891.  
  892.            Bad command passed to the disk interrupt 13H.
  893.  
  894.               This is a diagnostic message that was used in debugging
  895.               FREECOPY.
  896.  
  897.  
  898.            Cyclic redundancy check (CRC) error.
  899.  
  900.               FREECOPY displays this message on the screen when the 16 bit
  901.               CRC character is invalid.  This word immediately follows the
  902.               CHRN entry on a diskette and is generated by the polynomial:
  903.  
  904.                                16    12    5
  905.                        P(X) = X   + X   + X  + 1
  906.  
  907.               where X is any byte of a given sector except the CRC or ID
  908.               byte.
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.                      ****** FREECOPY Users Guide *****             Page   14.
  931.  
  932.  
  933.  
  934.  
  935.  
  936.            Disk controller has failed.
  937.  
  938.               The program issues this message when the disk controller chip
  939.               is no longer working.  This chip can be the Intel 8272 or
  940.               the NEC 765.  They are functionally equivalent.
  941.  
  942.  
  943.            DMA overrun on an I/O operation.
  944.  
  945.               This is a diagnostic message used in debugging FREECOPY.  It
  946.               means that the disk controller chip (i8272 or NEC 765) tried
  947.               to use more memory than what was allocated to it by FREECOPY.
  948.  
  949.  
  950.            Double sided diskette in a
  951.            single sided disk drive.
  952.  
  953.               This message appears when you place a double sided diskette in
  954.               a single sided drive and you did not tell FREECOPY to copy only
  955.               the top side of the diskette.
  956.  
  957.  
  958.            First byte of the FAT does not
  959.            match any known diskette type.
  960.  
  961.               FREECOPY checks the first byte of the File Allocation Table
  962.               (FAT) for validity. If it is not equal to 0FCH, 0FDH, 0FEH
  963.               or 0FFH, the program displays this message.
  964.  
  965.  
  966.            Memory control block destroyed.
  967.  
  968.               This was used in implementing and testing the PC DOS memory
  969.               allocation function calls.  It should not appear when
  970.               normally using FRECOPY.
  971.  
  972.  
  973.            Requested sector not found.
  974.  
  975.               This message occurs when the sectors of a given track for 
  976.               the source diskette are not in sequential order, starting at
  977.               one (1) and ending at eight (8) or nine (9).  The source
  978.               diskette is probably copy-protected by the manufacturer.
  979.  
  980.  
  981.  
  982.  
  983.  
  984.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  985.  
  986.    
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.                      ****** FREECOPY Users Guide *****             Page   15.
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.            Seek operation has failed.
  1001.  
  1002.               This message appears when FREECOPY attempts to read or write
  1003.               physical tracks greater than number forty-one (41) or seeks
  1004.               a valid physical track number with an invalid logical track
  1005.               number.  If the first case is true, FREECOPY contains a
  1006.               bug.  This should not be the case.  Probably a valid physical
  1007.               track is holding an invalid logical track number in the CHRN
  1008.               table.  If so, the source diskette is copy-protected by the
  1009.               manufacturer.
  1010.  
  1011.  
  1012.            Target diskette is write protected.
  1013.  
  1014.               If this message appears, remove the write protection tab on the
  1015.               target diskette.
  1016.  
  1017.  
  1018.            Tried DMA across a 64K boundary.
  1019.  
  1020.               Since the Intel 8088 processor chip breaks up memory into
  1021.               64K segments, this message appears when FREECOPY tries to
  1022.               write a track of the source diskette into memory across a
  1023.               64K boundary.  This is a diagnostic message that was used
  1024.               to debug FREECOPY.
  1025.  
  1026.  
  1027.            Unrecoverable format error on target.
  1028.  
  1029.               FREECOPY puts this message on the screen when it is unable
  1030.               to format the target diskette.  You should use another
  1031.               target diskette.
  1032.  
  1033.  
  1034.            Unrecoverable I/O error.
  1035.  
  1036.               This message appears when an error occurs and FREECOPY is
  1037.               unable to determine the nature of the error.
  1038.  
  1039.  
  1040.            Unrecoverable read error on source.
  1041.  
  1042.               The program displays this message when it cannot read the
  1043.               source diskette.  FREECOPY tries four (4) times before this
  1044.               statement appears on the screen.
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.                      ****** FREECOPY Users Guide *****             Page   16.
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.            Unrecoverable write error on target.
  1069.  
  1070.               This message indicates that FREECOPY could not write the
  1071.               data on the source diskette onto the target diskette.  You
  1072.               should use another target diskette.
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.                      ****** FREECOPY Users Guide *****             Page   17.
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.         V. Remarks on User Supported Software
  1135.  
  1136.            According to Andrew Fluegelman, user supported software is based
  1137.  
  1138.         on the following three (3) principles:
  1139.  
  1140.                   o The utility of software can only be ascertained by a
  1141.                     user on their own system;
  1142.  
  1143.                   o The development of personal computer software should
  1144.                     be encouraged by the computing community; and
  1145.  
  1146.                   o The duplication of software should be encouraged rather
  1147.                     than restricted by copy-protection schemes.
  1148.  
  1149.         The basic assumption behind these principles is that software
  1150.  
  1151.         developers will rely on the individuals in the computing community 
  1152.  
  1153.         to support them financially.  However, most developers are committed
  1154.  
  1155.         to selling their wares through standard market channels.
  1156.  
  1157.            The market for personal computing software is growing without
  1158.  
  1159.         bound.  Advertising and documentation costs are now a significant
  1160.  
  1161.         barrier to the would be entrepreneur.  The shelf space of major
  1162.  
  1163.         distributors is commanding premium dollars.  This means that within
  1164.  
  1165.         a short period of time, we may see very few new programs on the
  1166.  
  1167.         market.  The small software developer will be driven from the
  1168.  
  1169.         marketplace.
  1170.  
  1171.            On the other hand, a computer program is a mechanism to process
  1172.  
  1173.         data and form information.  Information is a commodity that is
  1174.  
  1175.         neither non-renewable nor recycleable.  It is expandable.  If I
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.      Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.                      ****** FREECOPY Users Guide *****             Page   18.
  1195.     
  1196.  
  1197.  
  1198.  
  1199.  
  1200.         have information and give or sell it to you, we both have it.
  1201.  
  1202.         The net effect of the transaction is positive.  The net effect
  1203.  
  1204.         of all other transactions in human history has been zero.  If you
  1205.  
  1206.         and I trade two goods, I lose what I have to gain what you have and
  1207.  
  1208.         vice versa.
  1209.  
  1210.            The FREEWARE concept admits that the exchange of software is an
  1211.  
  1212.         informational transaction where both parties gain and yet retain what
  1213.  
  1214.         they had before the transaction.  Software developers who are selling
  1215.  
  1216.         through standard market channels are attempting to make an
  1217.  
  1218.         informational transaction into an exchange transaction with a zero
  1219.  
  1220.         net effect.  This is impossible in the long run.    
  1221.  
  1222.            I am writing user supported software because I believe that it
  1223.  
  1224.         is a viable alternative to selling my wares through the standard
  1225.  
  1226.         market channels.  I believe that user supported software will 
  1227.  
  1228.         supply the computing community with significant computer programs
  1229.  
  1230.         as soon as professional developers recognize that they can thrive
  1231.  
  1232.         by selling their programs in this fashion.
  1233.  
  1234.            Therefore, I am pleased to offer FREECOPY to the computing
  1235.  
  1236.         community and I welcome other authors to try their hand at creating
  1237.  
  1238.         professional quality software.
  1239.  
  1240.  
  1241.  
  1242.  
  1243.                                        - Donald L. Buresh, C.D.P. -
  1244.  
  1245.  
  1246.  
  1247.  
  1248.       Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.                      ****** FREECOPY Users Guide *****             Page   19.
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.         VI. Acknowledgements
  1267.  
  1268.            This is where I thank the people who made FREECOPY possible.
  1269.  
  1270.         My first round of thanks go out to Andrew Fluegelman for inventing
  1271.  
  1272.         the FREEWARE concept.  I would like to thank Marshall Goldberg for
  1273.  
  1274.         convincing me that the computing community needs public domain
  1275.  
  1276.         software.  I want to thank Patricia Smith and Jim Button for
  1277.  
  1278.         demonstrating to me that an individual can thrive on user supported
  1279.  
  1280.         software provided that they have the right product.  My thanks
  1281.  
  1282.         go out to Bill Salkin for creating PC Firing Line and for the
  1283.  
  1284.         many hours of conversation about the magazine.
  1285.  
  1286.            From a technical perspective, I want to thank Brian Markey
  1287.  
  1288.         for indicating how to overcome DMA boundary errors and Harry Keller
  1289.  
  1290.         for demonstrating how to calculate the amount of available free
  1291.  
  1292.         memory.  I also think that Keith Beal deserves credit for showing
  1293.  
  1294.         me a documentation system for assembly language programs.
  1295.  
  1296.            The trademarks that I have mentioned in this users guide are
  1297.  
  1298.         listed below.
  1299.  
  1300.                   o IBM and PC DOS are registered trademarks of International
  1301.                     Business Machines, Inc.
  1302.  
  1303.                   o FREEWARE is a trademark of The Headlands Press, Inc.
  1304.  
  1305.                   o PC Firing Line is a trademark of ABComputing
  1306.  
  1307.  
  1308.                                        - Donald L. Buresh, C.D.P. -
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.       Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.                      ****** FREECOPY Users Guide *****             Page   20.
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.         VII. List of Bugs 
  1333.  
  1334.            Since the first release of FREECOPY, I have corrected a
  1335.  
  1336.         number of bugs.  Some were small and some were not.
  1337.  
  1338.  
  1339.                   o Ensured that FREECOPY runs on PC with lots of
  1340.                     memory.
  1341.  
  1342.                   o Flushed the standard keyboard buffer to prevent
  1343.                     a user from unwantly typing ahead.
  1344.  
  1345.                   o Modified the command line parser to process the
  1346.                     TAB character.
  1347.  
  1348.                   o Completely revampled the memory management scheme
  1349.                     so that FREECOPY uses the PC DOS function calls
  1350.                     when running versions of the operating system
  1351.                     greater than 2.0
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.       Squire Buresh Associates, Inc.   P.O. Box 112   Millbury, MA  01527
  1379.  
  1380.                     
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.                         THIS IS THE END OF THE DOCUMENT
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.