home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / FILE / SPLIT517.ZIP / SPLIT517.DOC < prev   
Encoding:
Text File  |  1991-09-03  |  13.2 KB  |  275 lines
  1. SPLIT.EXE version 5.17                             (September, 1991)
  2. Command
  3.  
  4. Purpose: SPLIT divides a file, at specified points, into smaller files and
  5.          can re-unite them back into the original file, if needed. Files may
  6.          be processed as either binary or text files. When text files are
  7.          split according to the number of lines in each new file, lines are
  8.          truncated at 256 characters. Source file size is displayed in
  9.          bytes. Output files all have the same basename and a series of
  10.          increasing numeric file extensions beginning with ".001".
  11.  
  12.          Files may be re-united with crc check using the SPLIT/u option.
  13.          (See "Unsplit" instructions below).
  14. ______________________________________________________________
  15. Splitting Files: Command line from batch file or menu-driven.
  16. --------------------------------------------------------------
  17.          Input and output filenames and options may be entered on the
  18.          command line. Bad filenames result in a prompt for a new filename.
  19.  
  20. Format:  SPLIT [fnm1] [fnm2] [opt] [num] [y/n]
  21.  
  22.          "fnm1" is the name of input file to be split, including the
  23.          extension and pathname, where needed.
  24.  
  25.          "fnm2" is the output file basename (no extension), including
  26.          pathname, where needed.
  27.  
  28.          "opt" is the split option.  Choices are: (F)iles, (B)ytes,
  29.          (L)ines, or (M)anual.
  30.  
  31.          "num" is the number of files, bytes, or lines in each output file.
  32.  
  33.          "y/n" is yes/no option to pause for new disk with each output file.
  34.  
  35.  
  36. Example: To split BIG.FIL into three equal files named LITTLE.001,
  37.          LITTLE.002, LITTLE.003, and no pause for new disk after each
  38.          new outuput file, you would type the following:
  39.  
  40.          SPLIT big.fil little f 3 n
  41.  
  42. Simply entering "SPLIT" on the command line results in prompts for
  43. the filenames and options.  The "split by" options on the menu are:
  44.  
  45.      F: Specify the number of (F)iles, equal size, to split source into,
  46.      B: Specify the number of (B)ytes in each new output file, or
  47.      L: Specify the number of (L)ines of text in each new file.
  48.  
  49. A blank line entered at "split by" option prompt results in "F" as the
  50. default type of file splitting.
  51.  
  52. The following option is NOT listed on the menu:
  53.  
  54.      M: Copy blocks of bytes (M)anually from source to output file.
  55.  
  56. Although not listed in the menu, manual file splitting is available to
  57. ADVANCED users by choosing option "M" at the "split by" prompt or placing
  58. "m" in the command line as described above.  Manual splitting copies a
  59. specific block of bytes from within the source file into the output file.
  60. Starting and ending bytes are entered for the block of source file bytes
  61. to be copied to the output file. Values from zero to source file size are
  62. entered as the first and last bytes of each new block to be copied to an
  63. output file. If the second byte number is zero or is lower than the first
  64. byte, the program aborts. Bytes up to and including the second byte number
  65. are copied to the new file.  The numeric output file extension is also
  66. entered manually.
  67.  
  68. After each group of bytes is copied, a new extension number, starting point,
  69. and ending point are requested for another output file.  A new file is
  70. created and the next group of bytes is copied to it.  This repeats until the
  71. end of the source file or the program is ended by entry of an ending byte
  72. value less than the starting byte.  A blank line entered for any requested
  73. value results in the default for that value. Default for file extension is
  74. the previous extension number plus one. Default for the starting byte is the
  75. next byte after the last file split left off. Default for the second byte
  76. number is the last byte in the source file. Be careful!  Manual file
  77. splitting is for ADVANCED users.
  78.  
  79. _____________________________________________________________________________
  80. Unsplit files: SPLIT.EXE with the "/u" switch re-unites binary or text files.
  81. -----------------------------------------------------------------------------
  82. Format:  SPLIT/u fnm [outfil] [/x]
  83.  
  84.          "Fnm" is the input file basename (no extension), including
  85.          pathname, where needed.  If this is the only filename entered,
  86.          the resulting re-united file will be named "Fnm.RE$".
  87.  
  88.          "Outfil" is the output filename or basename.  If no extension is
  89.          given, extension ".RE$" is provided to make output filename
  90.          "Outfil.RE$". If a fully qualified filename ("Outfil.ext") is
  91.          given, the re-united file keeps that name. (See examples).
  92.  
  93.          "/X" given as the last command parameter results in deletion
  94.          of the input files as the output file is being re-constructed.
  95.  
  96.     The unsplit function works from the command line only, not menu-driven.
  97.     Re-unites the entire series fnm.001 thru fnm.### into a single file.
  98.     if "SPLIT/u fnm" is entered, the default output file is "fnm.RE$"
  99.  
  100.     If original file CRC was stored in the control file, SPLIT/u will
  101.     verify that the re-united file has the same CRC as the original.
  102.  
  103. Examples:
  104.                                                                                 
  105.     SPLIT/u Infile            -> Infile.RE$ created from series
  106.     SPLIT/u Infile /X         -> Infile.RE$ & infiles deleted
  107.     SPLIT/u Infile Outfil.txt -> Outfil.txt created from series
  108.     SPLIT/u Infile Outfil /X  -> Outfil.RE$ & infiles deleted
  109.  
  110.    (Run SPLIT/u without command parameters for examples/instructions)
  111.  
  112.  
  113. *-* OR *-*
  114.  
  115. Use DOS COPY:
  116. -------------
  117.    1) For text files, just use the copy command:
  118.  
  119.        COPY fnm2.* fnm1.all
  120.              or
  121.        COPY fnm2.001 + fnm2.002 + fnm2.003 fnm1.all
  122.  
  123.    2) For binary files use the /B switch:
  124.  
  125.        COPY/b fnm2.* fnm1.all
  126.              or
  127.        COPY/b fnm2.001 + fnm2.002 + fnm2.003 fnm1.all
  128.  
  129.    This concatenates the pieces back into a single file.  Unlike with
  130.    SPLIT/u, no comparison to the original file crc is made.  Check your
  131.    DOS manual for file concatenation conventions.
  132.  
  133.  
  134. Installing (setup) SPLIT.EXE:
  135. -----------------------------
  136. Format:  SPLIT /s
  137.  
  138. When SPLIT is first run, you are asked whether you want to install the RAM
  139. swap to disk/EMS during shell to dos and whether you want crc file integrity
  140. check for split/unite functions.  To change setup, type SPLIT /s.
  141.  
  142. RAM swapping: If you have limited free conventional RAM, the TRUE option for
  143. swapping RAM to disk/EMS on shell might be best. If your EMS or disk space
  144. is limited or a program conflict exists, the FALSE option might be best.
  145.  
  146. CRC Checking: With slower computers (8088,XT), crc verification may slow
  147. splitting/uniting significantly and you may wish to choose 'F' (FALSE) for
  148. CRC file checking.  For 8-10mhz 80286/AT and faster processors, crc checking
  149. causes no significant slowing and 'T' or 'X' are the best crc options.
  150.  
  151. Options: 'T' = New Crc32 check (Zmodem, PKZIP, more secure method).
  152.          'X' = Crc-CCITT check (Xmodem, older SPLIT commpatibility).
  153.          'F' = Disables any CRC checking.
  154.  
  155. After the program is installed, you may change RAM swap and CRC options
  156. at any time by running SPLIT in "SETUP" mode. (Format:  SPLIT /s).
  157.  
  158.  
  159. Uses for SPLIT.EXE:
  160. -------------------
  161.   o Backing up large files from a hard disk to floppies or from
  162.     high-capacity to low-capacity disks.
  163.   o Making smaller text files out of larger ones for use with limited
  164.     capacity editors like Sidekick's notepad.
  165.   o Split a specific block of bytes out from the middle of a binary file
  166.     (useful in patching some kinds of executable and archive files).
  167.   o Files are split where you want and are easily put back together.
  168.  
  169. Features of SPLIT.EXE :
  170. -----------------------
  171.   o Split binary files manually with v4.9 and later.
  172.  
  173.   o Binary file splits are incremented and listed in bytes. Text file splits
  174.     are incremented and listed in lines of text.
  175.  
  176.   o Self-test at startup detects damaged or altered program.
  177.  
  178.   o Point-and-shoot file selection directory if input file not found. Wild
  179.     card file names using "*" and "???" are ok.  File scroll limit = 512.
  180.  
  181.   o If destination disk is full, SPLIT adjusts the size of current output
  182.     file to the number of bytes remaining on destination disk and prompts
  183.     for new disk in the output drive.
  184.  
  185.   o LZEXE compression for smaller executable SPLIT.EXE program.
  186.  
  187.   o 01-15-91: v 5.11 - UNITE.EXE no longer needed.  SPLIT.EXE re-unites
  188.     files with /u parameter. Control file created with last file split tells
  189.     SPLIT how many files there were. Type "SPLIT/u" for usage instructions.
  190.  
  191.   o SHELL to DOS during binary split operation to format disk, change
  192.     directory, etc. In v 5.x, program and data in RAM can be swapped to disk
  193.     or EMS memory on shell to DOS. On swap to disk, file "$PLIT.$$$" in the
  194.     root directory of the current drive contains the RAM image. Swap feature
  195.     can be enabled/disabled with "SPLIT /s" setup option.  For DOS shell,
  196.     type "exit" at any filename prompt or select "<Go To DOS>" from the
  197.     light-bar file selector.  Then type "EXIT" at the DOS command line to
  198.     return to SPLIT. (SHELL to DOS is disabled for TEXT processing).
  199.  
  200.   o 02-17-91: v 5.12 - RAM image file $PLIT.$$$ will now have a normal file
  201.     attribute. Previously, $PLIT.$$$ was a system file and could be left
  202.     behind as an un-erasable file in the current directory if the computer
  203.     was turned off without EXIT-ing back to SPLIT from DOS. To remove these
  204.     old files, shell to DOS with your old version of SPLIT in any directory
  205.     where $PLIT.$$$ was left behind. Then type "exit" at the DOS prompt to
  206.     return to SPLIT. This removes the extra files. Versions later than 5.11
  207.     won't remove these files from SUBDIRECTORIES because swap files are now
  208.     written in and erased from the ROOT directory ONLY.
  209.  
  210.   o 02-18-91: v 5.13 - CRC of the original file is now saved in the control
  211.     file. When SPLIT/u re-unites the files, the crc stored in the control
  212.     file is is compared to crc of re-united file (for binary files only).
  213.     If no stored crc or no control file, crc comparison is not attempted.
  214.     (with v5.14, Crc can be enabled/disabled with "SPLIT/s" setup option.)
  215.  
  216.   o 02-25-91: v 5.14 - Program now self-installs to activate/de-activate CRC
  217.     and RAM swapping options. Initial run prompts for setup options. These
  218.     can later be changed by running "SPLIT /s".
  219. New:
  220. ----
  221.   o 08-25-91: v 5.16 - CRC options expanded on self-install:  Allows
  222.     new Crc32 or old Xmodem CRC-CCITT (backwardly compatible to v5.13).
  223.     Crc32 is the a much more secure crc check used by PKZIP and ZMODEM.
  224.     Fast public domain Assembler code is now used for CRC routines.
  225.  
  226.   o 09-01-91: v 5.16 - Light-bar selector now has sorted directory.
  227.  
  228.   o 09-02-91: v 5.17 - Minor Fix: selector list for directories with
  229.     over 512 listings. Before, if a directory had (512 + X) listings,
  230.     selector would scroll only the first (X) files in the directory.
  231.     Now scrolls the first 512 files correctly when total exceeds 512.
  232.  
  233. File splitter update history for MS-DOS/PC-DOS versions.
  234. -----------------------------------------------------------------------
  235. SPLIT46M    01-29-88 -- First msdos rewrite, similar to cp/m version.
  236. SPLIT47     01-30-88 -- Clean up input, change records to bytes.
  237. SPLIT480 *  01-15-89 -- Add directory, dos shell (1st public release).
  238. SPLIT482    01-15-89 -- Same as v480 with crc self-check.
  239. SPLIT482-90 01-06/89 -- Minor technical bugs worked out.
  240. SPLIT491    06-27-89 -- Manual splitting returned (dumped in 46m).
  241. SPLIT492-95 07-09/89 -- Improved video, shell, i/o check routines.
  242. SPLIT49C *  09-30-89 -- Faster self-check. Had minor display bugs.
  243. SPLIT496 *  10-03-89 -- Better shell/ioerr, v49C display bugs fixed.
  244. SPLIT497 *  10-28-89 -- Full cmd parse, fix numeric i/o, DOS 2.x ok.
  245. SPLIT49Z *  07-19-90 -- LZEXE compression added, self-check retained.
  246. SPLIT499    12-01-90 -- Light bar file selector, swap RAM to EMS/DISK.
  247. SPLIT500 *  01-01-91 -- UNITE.EXE added to re-unite files w/ctrl file.
  248. SPLIT511 *  01-15-91 -- Re-unite function now included in SPLIT.EXE.
  249. SPLIT512    02-17-91 -- RAM swap to root dir, $PLIT.$$$ attrib = norm.
  250. SPLIT513 *  02-18-91 -- Check crc-ccitt of re-united vs original file.
  251. SPLIT514 *  02-24-91 -- Self-configure toggles on/off CRC & RAM swap.
  252. SPLIT516 *  09-01-91 -- Fast CRC32 or Old CRC check; Sorted directory.
  253. SPLIT517 *  09-02-91 -- Fix: Selector correctly shows first 512 files.
  254. -----------------------------------------------------------------------
  255. *  = version released to public.
  256. -----------------------------------------------------------------------
  257. Inspiration for SPLIT was "SPLITTER", a CP/M program by Mike Nault.
  258.  
  259. Thanks and credit to the following:
  260.  
  261.   o  Steve Ogden for the opening window routines.
  262.   o  Jim Luckas for parts of the "point-and-shoot" selector.
  263.   o  TurboPower for the ExecSwap option when shelling to DOS.
  264.  
  265. With the exception of the ExeSwap routine, source code was derived either
  266. from public domain sources or written originally for this program.
  267.  
  268. ** SPLIT.EXE has NO warranty, expressed or implied. The person using this
  269.    software bears all risk as to unwanted or unexpected effects on data or
  270.    equipment and as to the quality and performance of the software.
  271.  
  272.  
  273.  - M. Dingacci, 09/02/91 -
  274.  
  275.