home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Boldly Go Collection
/
version40.iso
/
TS
/
12B
/
SPLIT60C.ZIP
/
SPLIT60C.DOC
< prev
Wrap
Text File
|
1992-08-15
|
15KB
|
292 lines
SPLIT.EXE version 6.0c (August, 1992)
Command
Purpose: SPLIT divides a file, at specified points, into smaller files and
can re-unite them back into the original file, if needed. Files may
be processed as either binary or text files. When text files are
split according to the number of lines in each new file, lines are
truncated at 256 characters. Source file size is displayed in
bytes. Output files all have the same basename and a series of
increasing numeric file extensions beginning with ".001".
Files may be re-united with crc check using the SPLIT/u option.
(See "Unsplit" instructions below).
______________________________________________________________
Splitting Files: Command line from batch file or menu-driven.
--------------------------------------------------------------
Input and output filenames and options may be entered on the
command line. Bad filenames result in a prompt for a new filename.
Format: SPLIT [fnm1] [fnm2] [opt] [num] [y/n]
"fnm1" is the name of input file to be split, including the
extension and pathname, where needed.
"fnm2" is the output file basename (no extension), including
pathname, where needed.
"opt" is the split option. Choices are: (F)iles, (B)ytes,
(L)ines, or (M)anual.
"num" is the number of files, bytes, or lines in each output file.
"y/n" is yes/no option to pause for new disk with each output file.
Example: To split BIG.FIL into three equal files named LITTLE.001,
LITTLE.002, LITTLE.003, and no pause for new disk after each
new outuput file, you would type the following:
SPLIT big.fil little f 3 n
Simply entering "SPLIT" on the command line results in prompts for
the filenames and options. The "split by" options on the menu are:
F: Specify the number of (F)iles, equal size, to split source into,
B: Specify the number of (B)ytes in each new output file, or
L: Specify the number of (L)ines of text in each new file.
A blank line entered at "split by" option prompt results in "F" as the
default type of file splitting.
The following option is NOT listed on the menu:
M: Copy blocks of bytes (M)anually from source to output file.
Although not listed in the menu, manual file splitting is available to
ADVANCED users by choosing option "M" at the "split by" prompt or placing
"m" in the command line as described above. Manual splitting copies a
specific block of bytes from within the source file into the output file.
Starting and ending bytes are entered for the block of source file bytes
to be copied to the output file. Values from zero to source file size are
entered as the first and last bytes of each new block to be copied to an
output file. If the second byte number is zero or is lower than the first
byte, the program aborts. Bytes up to and including the second byte number
are copied to the new file. The numeric output file extension is also
entered manually.
After each group of bytes is copied, a new extension number, starting point,
and ending point are requested for another output file. A new file is
created and the next group of bytes is copied to it. This repeats until the
end of the source file or the program is ended by entry of an ending byte
value less than the starting byte. A blank line entered for any requested
value results in the default for that value. Default for file extension is
the previous extension number plus one. Default for the starting byte is the
next byte after the last file split left off. Default for the second byte
number is the last byte in the source file. Be careful! Manual file
splitting is for ADVANCED users.
_____________________________________________________________________________
Unsplit files: SPLIT.EXE with the "/u" switch re-unites binary or text files.
-----------------------------------------------------------------------------
Format: SPLIT/u fnm [outfil] [/x]
"Fnm" is the input file basename (no extension), including
pathname, where needed. If this is the only filename entered,
the resulting re-united file will be named "Fnm.RE$".
"Outfil" is the output filename or basename. If no extension is
given, extension ".RE$" is provided to make output filename
"Outfil.RE$". If a fully qualified filename ("Outfil.ext") is
given, the re-united file keeps that name. (See examples).
"/X" given as the last command parameter results in deletion
of the input files as the output file is being re-constructed.
The unsplit function works from the command line only, not menu-driven.
Re-unites the entire series fnm.001 thru fnm.### into a single file.
if "SPLIT/u fnm" is entered, the default output file is "fnm.RE$"
If original file CRC was stored in the control file, SPLIT/u will
verify that the re-united file has the same CRC as the original.
Examples:
SPLIT/u Infile -> Infile.RE$ created from series
SPLIT/u Infile /X -> Infile.RE$ & infiles deleted
SPLIT/u Infile Outfil.txt -> Outfil.txt created from series
SPLIT/u Infile Outfil /X -> Outfil.RE$ & infiles deleted
(Run SPLIT/u without command parameters for examples/instructions)
*-* OR *-*
Use DOS COPY:
-------------
1) For text files, just use the copy command:
COPY fnm2.* fnm1.all
or
COPY fnm2.001 + fnm2.002 + fnm2.003 fnm1.all
2) For binary files use the /B switch:
COPY/b fnm2.* fnm1.all
or
COPY/b fnm2.001 + fnm2.002 + fnm2.003 fnm1.all
This concatenates the pieces back into a single file. Unlike with
SPLIT/u, no comparison to the original file crc is made. Check your
DOS manual for file concatenation conventions.
Installing (setup) SPLIT.EXE:
-----------------------------
Format: SPLIT /s
When SPLIT is first run, you are asked whether you want to install the RAM
swap to disk/EMS during shell to dos and whether you want crc file integrity
check for split/unite functions. To change setup, type SPLIT /s.
RAM swapping: If you have limited free conventional RAM, the TRUE option for
swapping RAM to disk/EMS on shell might be best. If your EMS or disk space
is limited or a program conflict exists, the FALSE option might be best.
CRC Checking: With slower computers (8088,XT), crc verification may slow
splitting/uniting significantly and you may wish to choose 'F' (FALSE) for
CRC file checking. For 8-10mhz 80286/AT and faster processors, crc checking
causes no significant slowing and 'T' or 'X' are the best crc options.
Options: 'T' = New Crc32 check (Zmodem, PKZIP, more secure method).
'X' = Crc-CCITT check (Xmodem, older SPLIT commpatibility).
'F' = Disables any CRC checking.
After the program is installed, you may change RAM swap and CRC options
at any time by running SPLIT in "SETUP" mode. (Format: SPLIT /s).
Uses for SPLIT.EXE:
-------------------
o Backing up large files from a hard disk to floppies or from
high-capacity to low-capacity disks.
o Making smaller text files out of larger ones for use with limited
capacity editors like Sidekick's notepad.
o Split a specific block of bytes out from the middle of a binary file
(useful in patching some kinds of executable and archive files).
o Files are split where you want and are easily put back together.
Features of SPLIT.EXE :
-----------------------
o If destination disk is full, SPLIT adjusts size of current output file
to number of bytes remaining on destination disk and prompts for new
disk in the output drive.
o 10-03-89: v4.9 & later. Manual Split, binary files. Binary file splits
incremented in bytes, text file splits incremented in lines of text.
Self-test at startup detects damaged or altered program.
o 12-01-90: v4.99 - Point-and-shoot file select directory if input file
not found. Wild card file names ("*" & "???") ok. Scroll limit = 512.
LZEXE compression for smaller executable SPLIT.EXE program.
o 01-15-91: v 5.11 - UNITE.EXE no longer needed. SPLIT.EXE re-unites
files with /u parameter. Control file created with last file split tells
SPLIT how many files there were. Type "SPLIT/u" for usage instructions.
o SHELL to DOS during binary split operation to change directory, format
disk, etc. In v 5.x, Shell to Dos can swap program in RAM to disk
(file "$PLIT.$$$" in root directory contains RAM image) or to EMS
memory. Swapping is toggled with "SPLIT /s" setup option. For DOS
shell, type "exit" at filename prompt or select "<Go To DOS>" from
light-bar file selector. Then type "EXIT" at the DOS command line to
return to SPLIT from DOS. (SHELL is disabled for TEXT processing).
o 02-17-91: v 5.12 - RAM image file $PLIT.$$$ in root directory ONLY and
has a normal file attribute. In prior versions, $PLIT.$$$ was a SYSTEM
file which could be left behind as an un-erasable file in the current
directory if the computer was turned off without EXIT back to SPLIT
from DOS SHELL. Remove these old files by running an old SPLIT.EXE from
v5.00 to v5.11 and shell to DOS from each directory where $PLIT.$$$ was
left behind. "EXIT" at DOS prompt to return to SPLIT, from each shell
should remove the extra file. New versions can't remove $PLIT.$$$ from
SUBDIRECTORIES because it is now deleted from the ROOT directory ONLY.
o 02-18-91: v 5.13 - CRC of original binary file is saved in control
file and compared to crc of re-united file. If no stored crc or no
control file, crc comparison is not attempted.
o 02-25-91: v 5.14 - Program now self-installs. CRC and RAM swap toggle
options prompted from initial run. Run "SPLIT /s" to change setup
toggles later.
o 08-25-91: v 5.16 - CRC options expanded: Crc32 or Xmodem CRC
(backwardly compatible to v5.13). Crc32 is more secure crc used by
PKZIP and ZMODEM. Faster public domain CRC assembler code.
o 09-02-91: v 5.17 - Sort file selector directory. Minor Fix: selector
list scrolls first 512 filenames correctly when total exceeds 512.
o 11-24-91: v 5.18 - Stack fix for file selector dirsort re: prevent
stack overflow. Now allows /s and /u options from filename prompt on
opening screen.
o 12-07-91: v 5.19 - /H or /? command parameter gives help screen.
Re-unite progress displays in opening screen window. If first fragment
(fnm2.001) of re-uniting file is in the same directory as the control
file, SPLIT/u uses the same CRC algorithm as for original file split.
o 03-18-92: v 5.20 - Self-config routine fine tuned. "/s" entered at
Output File name prompt could have appended SPLIT config data to the
active INPUT file if setup function was run at this point in the
program. Now ONLY appends data to SPLIT program.
o 04-02-92: v 5.21 - Shell image file name now fully qualified. image
files were previously left in root of drive when exiting back to SPLIT
from a different drive. Filename search now more sophisticated for
dirname, *.*, and on shell return.
o 07-21-92: v 6.0b - Now compiled with TP6 Compiler. Date display
on startup. Displays obsolete message in two years.
o 08-15-92: v 6.0c - Minor upgrade: New file "SPLIT.TIP" has usage
tips & shortcuts. Far calls avoid shell problems. Smaller program
and changes in sound effects. Identical in function to v 6.0b.
File splitter update history for MS-DOS/PC-DOS versions.
-----------------------------------------------------------------------
SPLIT60c * 08-15-92 -- Far calls on SHELL, tips file, sound changes.
SPLIT60b * 07-21-92 -- TP6 compiler, date display, obsolete message.
SPLIT521 * 04-02-92 -- Fix filename check, delete shell image file.
SPLIT520 * 03-18-92 -- Fix setup, append data ONLY to SPLIT program.
SPLIT519 * 12-07-91 -- Help display; SPLIT/u now in main window.
SPLIT518 11-24-91 -- Fix Stack; Allow "/" options on screen prompt.
SPLIT517 * 09-02-91 -- Fix: Selector correctly shows first 512 files.
SPLIT516 * 09-01-91 -- Fast CRC32 or Old CRC check; Sorted directory.
SPLIT514 * 02-24-91 -- Self-configure toggles on/off CRC & RAM swap.
SPLIT513 * 02-18-91 -- Check crc-ccitt of re-united vs original file.
SPLIT512 02-17-91 -- RAM swap to root dir, $PLIT.$$$ attrib = norm.
SPLIT511 * 01-15-91 -- Re-unite function now included in SPLIT.EXE.
SPLIT500 * 01-01-91 -- UNITE.EXE added to re-unite files w/ctrl file.
SPLIT499 12-01-90 -- Light bar file selector, swap RAM to EMS/DISK.
SPLIT49Z * 07-19-90 -- LZEXE compression added, self-check retained.
SPLIT497 * 10-28-89 -- Full cmd parse, fix numeric i/o, DOS 2.x ok.
SPLIT496 * 10-03-89 -- Better shell/ioerr, v49C display bugs fixed.
SPLIT49C * 09-30-89 -- Faster self-check. Had minor display bugs.
SPLIT492-95 07-09/89 -- Improved video, shell, i/o check routines.
SPLIT491 06-27-89 -- Manual splitting returned (dumped in 46m).
SPLIT480 * 01-15-89 -- Add directory, dos shell (1st public release).
SPLIT47 01-30-88 -- Clean up input, change records to bytes.
SPLIT46M 01-29-88 -- First msdos rewrite, similar to cp/m version.
-----------------------------------------------------------------------
* = version released to public.
-----------------------------------------------------------------------
Inspiration for SPLIT was "SPLITTER", a CP/M program by Mike Nault.
Thanks and credit to the following:
o Steve Ogden for the opening window routines.
o Jim Luckas for parts of the "point-and-shoot" selector.
o TurboPower for the ExecSwap option when shelling to DOS.
With the exception of the ExeSwap routine, source code was derived either
from public domain sources or written originally for this program.
** SPLIT.EXE has NO warranty, expressed or implied. The person using this
software bears all risk as to unwanted or unexpected effects on data or
equipment and as to the quality and performance of the software.
- M. Dingacci, 8/15/92 -