home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 500 / 490 / snatchit.doc < prev    next >
Text File  |  1986-03-28  |  10KB  |  264 lines
  1.  
  2.                   SNATCH-IT
  3.  
  4.  
  5.               (C) Copyright, 1986
  6.  
  7.              Software Pirates, INC.
  8.  
  9.  
  10.             The COPY-II PC utility program
  11.  
  12.  
  13.           SNATCH-IT is provided to you free of charge by the
  14.      generous people of Software Pirates, Inc.  You are
  15.      encourage to distribute this program to all of your
  16.      friends.  If you like SNATCH-IT, then you can send a
  17.      $5.00 donation (or whatever you think its worth) to THE
  18.      AMERICAN CANCER SOCIETY, in the name of SOFTWARE
  19.      PIRATES, Inc.    Send your donations to:
  20.  
  21.                AMERICAN CANCER SOCIETY
  22.                90 PARK AVENUE
  23.                NEW YORK, NY 10016
  24.  
  25.           SNATCH-IT provides you with three very powerful
  26.      advantages over just using COPY-II PC.  First (and most
  27.      important), any disk that can be copied by COPY-II PC,
  28.      can be converted into a DOS file, where it can be sent
  29.      via a modem or copied easily using DOS' copy command.
  30.      Protected disks no longer have to be "cracked" in order
  31.      to send them over the phone!  The second advantage is
  32.      that you can free up many of your floppy disks dedicated
  33.      just to a single program.  Now those programs can be
  34.      stored on your hard disk, where they can be ARChived to
  35.      save space.  The third advantage is when the entire
  36.      program being copied fits into memory at one time, you
  37.      can repeatably write target disks or files WITHOUT
  38.      having to re-read the source everytime.
  39.  
  40.           The image files created by SNATCH-IT are NOT
  41.      executable files.  These files contain the data
  42.      necessary to re-construct the diskette to its original
  43.      form.    Converting the diskette to a DOS file allows you
  44.      to by-pass the normal copy-protection restrictions and
  45.      manipulate the files in ANY way you desire.  The image
  46.      files MUST be re-constructed back to a diskette before
  47.      the program(s) can be executed.
  48.  
  49.            For your information, SNATCH-IT has been specially
  50.      designed so that COPY-II PC does NOT get modified at
  51.      all. You can use COPY-II PC right out of the box.
  52.  
  53.      Requirements:
  54.  
  55.         DOS 2.0 or higher
  56.         PC, PC-XT, PC-AT, (and MAYBE some compatibles.)
  57.         1 diskette drive
  58.         196k bytes of system memory with 140k bytes free.
  59.         COPY-II PC (designed for versions 1.7 to 3.02+. It has
  60.                 only been tested up to 3.02, but there is
  61.                 no reason to believe it won't work on new
  62.                 releases.)
  63.  
  64.      Additional Support:
  65.  
  66.         Snatch-It supports all valid DOS drive types
  67.      (including RAM disks and Hard disks).
  68.  
  69.      Snatch-It will use all free memory upto 640K bytes.
  70.  
  71.      Pre-Operation setup:
  72.  
  73.           To use SNATCH-IT you must do the following:
  74.      COPY-II PC must be in the default directory of the
  75.      default drive, so that SNATCH-IT can find it. Also,
  76.      SNATCH-IT must be located somewhere in your path so that
  77.      DOS can find it.
  78.  
  79.      Running SNATCH-IT:
  80.  
  81.           Start your PC and at the DOS prompt enter SNATCHIT.
  82.      Once SNATCH-IT is loaded into memory it will then load
  83.      COPY-II PC into memory.  Normally, COPY-II PC starts by
  84.      reading a source diskette and then writing the data to a
  85.      target diskette.  Now, SNATCH-IT intercepts COPY-II PC's
  86.      request for a source diskette and gives you the
  87.      opportunity to read a source diskette or the extra
  88.      option of reading a DOS compatible source file (this
  89.      option is used when you want to re-contruct a disk).
  90.      When COPY-II PC is ready to write to a target diskette,
  91.      SNATCH-IT again intercepts and gives you the opportunity
  92.      to write to a target diskette or the extra option of
  93.      writing to a DOS compatible file.  At the completion of
  94.      the write routines, COPY-II PC normally asks if you want
  95.      to make another copy.    A "yes" answer forces the read of
  96.      a new diskette.  SNATCH-IT knows when the write routines
  97.      are complete and does a special memory verification to
  98.      calculate the size of the resulting diskette image or
  99.      file.    If the entire diskette image or the entire file
  100.      fits in memory then SNATCH-IT gives you a set of special
  101.      options.  The special options allow you to return to
  102.      DOS, return to the read a new source (diskette or file),
  103.      or return to the write target routines (file or
  104.      diskette).  If the entire diskette image or file is not
  105.      in memory then SNATCH-IT just asks you if you want to
  106.      make another copy.  A "yes" answer gives you the chance
  107.      to read a new diskette and also gives you the chance to
  108.      read another DOS file.
  109.  
  110.  
  111.      File Storage:
  112.  
  113.           SNATCH-IT uses DOS file naming convention for its
  114.      image files.  You will be requested to name the file for
  115.      the source or target image files.  The file name can
  116.      contain a drive specifier, a path, a filename and an
  117.      extension.  If the drive specifier is not included,
  118.      SNATCH-IT will use the default drive.    If a path is not
  119.      specified, SNATCH-IT will use the default directory.  If
  120.      a file extension is not specified, SNATCH-IT will add
  121.      its default extension of CP2 to the filename.
  122.  
  123.           From our experiments, we have found that many image
  124.      files will be larger than the capacity of a double-sided
  125.      diskette.  This happens because the image file not only
  126.      contains the programs data, it also contains the
  127.      information necessary for COPY-II PC to re-construct the
  128.      disk back to its original form.  Due to this fact and
  129.      the fact that some systems only have floppy disk
  130.      drives, we have allowed SNATCH-IT to break the images
  131.      files into pieces.  SNATCH-IT will utilize all the
  132.      available space of that diskette and then prompt for a
  133.      new file name on another diskette.  This should provide
  134.      enough flexibility to for those systems with little disk
  135.      space.  SNATCH-IT can break an image file into a maximum
  136.      of 10 pieces.    SNATCH-IT will mark the order of the
  137.      files so the image can be reconstructed properly, later.
  138.  
  139.           SNATCH-IT also marks the image files so that an
  140.      illegal file can not be used as a source of a SNATCH-IT
  141.      image.
  142.  
  143.           SNATCH-IT image files can be stored on a diskette
  144.      or a hard drive.  SNATCH-IT image files can be copied
  145.      from one diskette to another by use of the DOS copy
  146.      command.  SNATCH-IT image files are DOS compatible
  147.      backups of your important diskettes.  SNATCH-IT image
  148.      files can also be transmitted over a modem or via a LAN
  149.      or other network.
  150.  
  151.  
  152.      Passing Parameters:
  153.  
  154.           SNATCH-IT allows the passing of 1 drive specifier
  155.      and a single side diskette specifier.    The drive
  156.      specifier passed to SNATCH-IT will be used for both
  157.      source diskette and target diskette.  The drive
  158.      specifier will not be used for the source file or the
  159.      target file.  The single side specifier will be used
  160.      only for reading a source diskette. When the /1 option
  161.      is selected, only the source diskette is affected. A
  162.      source file in that drive will be treated exactly as is.
  163.      (if the file is stored on a double sided diskette and
  164.      the drive is double sided then the file will be read
  165.      from both sides.)
  166.  
  167.  
  168.        1.    SNATCHIT A:        Both source diskette and
  169.                     target diskette will be
  170.                     the A drive. A 2-sided
  171.                     source diskette will be
  172.                     read.
  173.  
  174.        2.    SNATCHIT A: B:        Same as 1.
  175.  
  176.        3.    SNATCHIT B:        Both source diskette and
  177.                     target diskette will be
  178.                     the B drive. A 2-sided
  179.                     source diskette will be
  180.                     read.
  181.  
  182.        4.    SNATCHIT B: A:        Same as 3.
  183.  
  184.        5.    SNATCHIT A:/1        Both source diskette and
  185.                     target diskette will be
  186.                     the A drive. A 1-sided
  187.                     source diskette will be
  188.                     read.
  189.  
  190.        6.    SNATCHIT A: B:/1    Same as 5.
  191.  
  192.        7.    SNATCHIT B:/1        Both source diskette and
  193.                     target diskette will be
  194.                     the B drive. A 1-sided
  195.                     source diskette will be
  196.                     read.
  197.  
  198.        8.    SNATCHIT B: A:/1    Same as 7.
  199.  
  200.  
  201.        If a drive specifier is not given, then
  202.      SNATCH-IT will use the default drive as both the source
  203.      and target. If the default drive is not a diskette
  204.      drive, then SNATCH-IT will use the A drive for both the
  205.      source and target.
  206.  
  207. CAVEATS:
  208.  
  209.      Snatch-It has not been tested on any systems whose total
  210.      memory is not a multiple of 64K bytes.
  211.  
  212.      If you are using Sidekick, de-install it before starting
  213.      SNATCHI-IT. SNATCH-IT and Sidekick are incompatible. You
  214.      can de-install Sidekick by getting the selection menu
  215.      displayed (ALT-CTRL) and then pressing CTRL and HOME and
  216.      then CTRL and END. When shifting from CTRL-HOME to
  217.      CTRL-END, do not release the CTRL key.
  218.  
  219.      SNATCH-IT works on a PC, XT, and AT. It has not been
  220.      tried or tested on a JR. or any IBM compatibles. Due to
  221.      the extensive use of interrupts we feel that many
  222.      compatibles will not work correctly. However, we have
  223.      not tested any of these, so your system MIGHT work ok.
  224.  
  225.      Image file created with COPY-II PC versions prior to
  226.      version 2.xx can NOT re-constructed with later versions
  227.      of COPY-II PC. Differences in the way COPY-II PC
  228.      1.xx handles the data, make it incompatible with versions
  229.      2.xx and 3.xx. SNATCH-IT will identify this condition
  230.      with an error message and give you a choice whether to
  231.      proceed or not. We recommend that you do NOT proceed.
  232.  
  233. CHANGE HISTORY:
  234.  
  235.      1.00 -  Initial Release
  236.      1.01 -  Fixed bug that caused SNATCH-IT to sometimes hang the
  237.          system when loaded. This was only a problem on PCs and XTs,
  238.          not ATs (which is what this was written on).
  239.  
  240.          When returning to DOS after displaying an error message,
  241.          SNATCHIT would clear the screen before you have a chance
  242.          to read the message. This has been fixed.
  243.  
  244.          Version 1.00 would not allow you to re-contruct a disk
  245.          from an image file that was created with a version of
  246.          COPY-II PC which had a different major version number. For
  247.          example, if you created an image file using version 2.43,
  248.          SNATCH-IT would not allow COPY-II PC version 3.xx, to
  249.          re-construct it, even though it MIGHT have worked. Now,
  250.          SNATCH-IT will display a warning message saying that the
  251.          re-construction MAY not work and giving you a choice to
  252.          proceed or not.
  253.  
  254.              Call these fine boards for more fine programs
  255.                     the DATA EXPRESS 312-560-0559
  256.                     THE PIRATE SHIP  312-383-9482 
  257.  
  258.  
  259.         And if you use this program PLEASE contribute some $$
  260.         to the AMERICAN CANCER SOCIETY you may one day be
  261.                        glad you did......
  262.  
  263.  
  264.