home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / p / split45.lbr / SPLIT45.DZC / SPLIT45.DOC
Encoding:
Text File  |  1993-10-25  |  4.3 KB  |  96 lines
  1.  
  2.               SPLIT v 4.5
  3.  
  4. SPLIT45 divides a file, at specified  points, into smaller files.
  5. Prompts for source filename and output file basename are displayed
  6. at the start.  Output files all have the same basename and a series
  7. of increasing numeric output file extensions beginning with ".001".
  8. The source filename may be entered as a command line parameter.  Bad
  9. filename entries result in a prompt for a new filename.  Source file
  10. size is displayed in 128-byte records.    You may split files manually
  11. at specified split points or let "auto-split" determine the split points
  12. automatically.
  13.  
  14. In manual splitting values from 0 to the source file size are entered
  15. for the first and last records of each new output file.  A zero as the
  16. last record aborts the program.  Records up to and including the last
  17. record number are copied to a new file, "outfile.EXT".    "EXT" is the
  18. numeric file extension, which is also entered manually.  After each
  19. group of records is copied, a new extension number, starting point, and
  20. ending point are requested for another output file.  A new file is
  21. created and the next group of records is copied to it.    This repeats
  22. until the program is ended by entry of an invalid ending  point:  A
  23. number less than the starting record, a number outside the number of
  24. records in the file, or a RETURN causes the rest of the source file to
  25. be copied to a final file with the last entered extension.
  26.  
  27. The program's operation is the same for the "auto-split" options, except
  28. that split points and extension numbers are determined automatically.
  29. The three "auto-split" options    are:
  30.  
  31.    1)  split source file into a specified number of nearly-equal files
  32.    2)  specify the number of 128-byte records in each new file
  33.    3)  specify the number of TEXT lines in each new file.
  34.  
  35.  
  36. To put the file back together, use PIP:
  37.  
  38.     1) for text files:
  39.  
  40.         A>PIP NEWFILE.TXT=FILE.001,FLE.002, ...
  41.  
  42.     2) for binary object files (must use "O" option):
  43.  
  44.         A>PIP NEWFFILE.BIN=FILE.001[O],FILE.002[O], ...
  45.  
  46. This concatenates the pieces back into a single file.
  47.  
  48.  
  49. USES:  Backing up large files from a hard disk to floppies or
  50.        from double-sided to single-sided disks.  The file is
  51.        split where you want and is easily put back together.
  52.  
  53. ------------------------------------------------------------------------
  54.  
  55. SPLIT v 4.5   (modified 3/87):
  56.  
  57. Inspiration for SPLIT45 was SPLITTER, a program by Mike Nault.    Because
  58. the source was unavailable, the program was re-written in Turbo Pascal
  59. and compiled with the following changes:
  60.  
  61. 1. End Address set to to run with smallest possible CP/M TPA.
  62.  
  63. 2. Source and output file drives may be specified allowing the splitting
  64.    of files from one drive to another.    The system may be reset after
  65.    each new file is closed, allowing each new file to be written to a
  66.    different separate disk.
  67.  
  68. 3. Larger 16k or 24k transfer buffer makes copying much faster.  A run-
  69.    ning tally is displayed as blocks are copied.
  70.  
  71. 4. Command parameters allow entry of the source filename on the command
  72.    line when program is called:
  73.  
  74.         A>SPLIT filename
  75.  
  76. 5. "Auto-split" option either divides source into nearly-equal files,
  77.    files of a specified block length, or text files with a specified
  78.    number of lines each.
  79.  
  80. 6. During manual splitting BOTH the first and last records in the block
  81.    being copied to the new file are specified.    In the event of a crash
  82.    or a partial file being copied to a full disk this allows re-creating
  83.    one or more of your file pieces without splitting the entire source
  84.    file again.
  85.  
  86. 7. Extensive I/O error-checking is now included.  If the disk fills up
  87.    while an output file is being written, the file is closed, partially-
  88.    written but intact, and the program aborts with an error message.
  89.    The same holds true for a full directory.  The convention for bad
  90.    filenames is very strict.  User areas may NOT be used in filenames
  91.    (no copying    between user areas, in other words).  All this is an
  92.    effort to avoid disastrous  losses  of data during file copying.  You
  93.    will appreciate these little details when they save you later.
  94.  
  95.                     - Mike Dingacci  March 20, 1987
  96.