home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / bsplit.zip / BSPLIT.DOC < prev    next >
Text File  |  1993-05-04  |  4KB  |  96 lines
  1. Documentation of BSPLIT.EXE and BCOMB.EXE
  2.  
  3.      ╔════════════════════════════╗  ╔════════════════════════════╗
  4.      ║    BINARY FILE SPLITTER    ║  ║    BINARY FILE COMBINER    ║
  5.      ║     OS/2 Version  5/93     ║  ║     OS/2 Version  5/93     ║
  6.      ║   (c) 1993  Klaus Topole   ║  ║   (c) 1993  Klaus Topole   ║
  7.      ╚════════════════════════════╝  ╚════════════════════════════╝
  8.  
  9.    BSPLIT and BCOMB are two utilities to split and combine any binary
  10.    and ASCII files. I often had the problem to somehow save large ZIP
  11.    files on diskettes to pass them to other computers or simply for
  12.    backup purposes. That's why I wrote my own utilities to do just that
  13.    in a very efficient way.
  14.  
  15.  
  16.    BSPLIT splits any large file into any number of smaller files of any
  17.    desired size. You can tell BSPLIT a maximum file size in KB for the
  18.    produced files. BSPLIT then splits the original file - of course
  19.    without erasing it - into the appropriate number of smaller files.
  20.    All file sizes are handled in increments of 0.5 KB (= 512 bytes). The
  21.    maximum file size (in KB) can be passed on the command line using any
  22.    integer or real number.
  23.  
  24.    Use BSPLIT on the command line as follows:
  25.  
  26.           BSPLIT filename [MaxKB]
  27.  
  28.     where MaxKB is any integer or real number or
  29.           MaxKB = 1.4M  for 3.5"  HD Diskettes (default)'
  30.           MaxKB = 1.2M  for 5.25" HD Diskettes'
  31.           MaxKB = .72M  for 3.5"  DD Diskettes'
  32.           MaxKB = .36M  for 5.25" DD Diskettes'
  33.  
  34.    BSPLIT uses the following file nomenclature:
  35.    The characters A,B,C,.. will be appended to the extension of all
  36.    output files in consecutive order. If the original file already has a
  37.    three character extension, the last character of the file extension
  38.    will be replaced with A,B,C,.. and so forth. If any output file name
  39.    would be identical with the name of the original file, the original
  40.    file will be renamed by truncating the last character of its extension.
  41.  
  42.  
  43.    Example 1:
  44.       Original File:   TEST1.ZIP    File Size:  842.0 KB
  45.       Command:         BSPLIT TEST1.ZIP 400
  46.       Output Files:    TEST1.ZIA    File Size:  400.0 KB
  47.                        TEST1.ZIB    File Size:  400.0 KB
  48.                        TEST1.ZIC    File Size:   42.0 KB
  49.  
  50.    Example 2:
  51.       Original File:   TEST2.DOC    File Size: 3000.0 KB
  52.       Command:         BSPLIT TEST2.DOC
  53.       Output Files:    TEST2.DOA    File Size: 1423.5 KB
  54.                        TEST2.DOB    File Size: 1423.5 KB
  55.                        TEST2.DOC    File Size:  153.0 KB
  56.       Original File  TEST2.DOC  is renamed to TEST2.DO
  57.  
  58.  
  59.  
  60.    BCOMB combines the files created with BSPLIT to its original file.
  61.    No matter how big or how many files must be combined, BCOMB
  62.    automatically locates all split files and combines them in the
  63.    right order from one single command. The combined file will have
  64.    the name of the split files without the last character of the file
  65.    extension.
  66.  
  67.    Use BCOMB on the command line as follows:
  68.  
  69.        BCOMB filename
  70.  
  71.     with  filename = Filename of Any of the Split
  72.                      Files Including Extension
  73.  
  74.  
  75.    Example 1:
  76.       Original Files:  TEST1.ZIA    File Size:  400.0 KB
  77.                        TEST1.ZIB    File Size:  400.0 KB
  78.                        TEST1.ZIC    File Size:   42.0 KB
  79.       Command:         BCOMB TEST1.ZIA
  80.       Output File:     TEST1.ZI     File Size:  842.0 KB
  81.  
  82.    Example 2:
  83.       Original Files:  TEST2.DOA    File Size: 1423.5 KB
  84.                        TEST2.DOB    File Size: 1423.5 KB
  85.                        TEST2.DOC    File Size:  153.0 KB
  86.       Command:         BCOMB TEST2.DOB
  87.       Output File:     TEST2.DO     File Size: 3000.0 KB
  88.  
  89.  
  90.    I tossed these utilities out into the shareware world. Feel free
  91.    to make copies and give them on to friends. Please keep the
  92.    documentation with the programs. For any comments you can contact
  93.    me via     E-Mail: KGT9276@RIGEL.TAMU.EDU
  94.                Phone: (409) 764-1104
  95.                                                         Klaus Topole
  96.