O6 WA 2 W The Grund Utilities W Version 1.1 - January 5, 1990 W Grund Software Services W Omaha, Nebraska WA 2A2 W GThe Grund UtilitiesHA 2 W GTable of ContentsHA*2 W Table of Contents........................................... 2A 2 W The Big Picture............................................. 3 W ChkVol - Check Volume ID of Diskette........................ 4 W Coffee - Coffee Game........................................ 7 W DiskUse - Disk Usage Display ............................... 8 W DocUtil - Documentation Utility ............................ 9 W Edir - Enhanced Directory...................................12 W Gotcha - DOS Command Line Simulator.........................14 W ListT - Source Text Lister..................................16 W NotBack - List All Files Not Backed Up......................17 W PCtl - Printer Control......................................19 W SDN - Sorted Directory w/Notes - Directory Annotator........20 W SimpEdit - Simple Text Editor...............................24 W SJ - Split/Join Files.......................................25 W Stamp - Print Date and Time.................................28 W The Borland Binary Editor ..................................29 W Technical Support...........................................31 W Disclaimer..................................................32 W Package Enhancements/Modifications .........................33 W ShareWare Registration .....................................34 W ShareWare Registration Order Form...........................36AU2 A>2 W - 2 - WA 2A2 W GThe Grund UtilitiesHA 2 W GThe Big PictureHA*2 W The Grund Utilities are a collection of utility programs, tools,A 2 W and short diversions that I have put together over the years. I W felt it was time to distribute these time-savers as a package. W The programs included in this package are not meant to be earth- W shattering achievements. I wrote them because there was a need W for -each- and -every- one of these little gems. I use all of these W programs in my week-to-week operations. W Each of these programs serves a specific purpose. I feel that W many of these purposes are needs that the every-day user may W have; from the low-tech home computer user to the high-end W tekkie. W This package is being distributed as shareware. Please feel free W to distribute and share -unmodified- and -complete- sets of this W package. But I urge you to register your copy, using the liberal W registration guidelines outlined later in this manual.AI2 W - 3 - WA 2A2 W GThe Grund UtilitiesHA 2 W GChkVol - Check Volume ID of DisketteHA*2 W Current Version: Vers 1.0, December 12, 1989A2 W Function W The purpose of ChkVol is to ensure that youA 2 W are backing files up to the correct volume W ID. W Description W In a batch file, you specify the volume ID W that -must- be contained on the target diskette W in order for the command to set a return code W of zero (case is not important; lower case W letters are converted to upper case before W the command is processed). This return code W can then be checked via the DOS errorlevel W statement. W The volume ID on the target diskette cannot W contain embedded blanks (although legal by W DOS standards). It can be modified using the W DOS "label" command. W The command will normally print messages to W the screen. This is normal DOS output, and W can be redirected. If you don't want these W messages to appear anywhere, simply suffix W the command line with "> NUL" (excluding the W quotes). W Command Usage W ChkVol [drive] [VolumeID] > NUL W drive- The first command line parameter must W be a valid drive letter, and therefore can be W only one character. Do not specify the W following colon. W VolumeID- The second command line parameter W represents the volume ID that will be matched W against the target diskette. Case is not W important. W Again, DOS output may be redirected via W regular means. W Return codes W 0: The volume ID on the command line matches W the volume ID on the target diskette.AB2 W - 4 - WA 2A2 W GThe Grund UtilitiesHA 2 W GChkVol - Check Volume ID of DisketteHA*2 W 1: The volume ID on the command line does NOTA 2 W match the volume ID on the target diskette. W 2: There is no volume ID on the target W diskette. W 3: The target diskette cannot be read, for W some reason: invalid drive; drive door open, W etc. W 4: One of the command line parameters is W invalid. W 5: There must be exactly two command line W parameters W Example W The following batch file will W a) Tell the user to insert the backup disk; W b) wait for him to do so; W c) Check to see that it is the "correct" one; W d) erase files that are not needed; W e) copy all modified files. W f) List the directory of the backup disk W echo off W rem BKUP.BAT - Copy all changed files W echo Copying all changed files for backup W echo ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» W echo º Put the Quattro backup disk º W echo º in drive A º W echo ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ W Pause W ChkVol A QuattroBkup > NUL W If errorlevel 5 goto RC5 W If errorlevel 4 goto RC4 W If errorlevel 3 goto RC3 W If errorlevel 2 goto RC2 W If errorlevel 1 goto RC1 W Erase \Quattro\*.Bak W Erase \Quattro\*.baq W XCopy \Quattro\*.* A: /M W Edir A: W goto endit W :RC1 W Echo Volume IDs do not match! W goto endit W :RC2 W Echo No Volume ID on backup disk!A*2 W - 5 - WA 2A2 W GThe Grund UtilitiesHA 2 W GChkVol - Check Volume ID of DisketteHA*2 W goto enditA2 W :RC3A 2 W Echo Cannot read diskette! W goto endit W :RC4 W Echo Invalid command line parameters! W goto endit W :RC5 W Echo Not enough command line parameters! W goto endit W :Endit W Modification History W Vers 1.0, Dec 12, 1989- Originally written W Planned W Enhancements W (none)AU2 A&2 W - 6 - WA 2A2 W GThe Grund UtilitiesHA 2 W GCoffee - Coffee gameHA*2 W Current Version: Vers 1.1, December 15, 1989A2 W FunctionA 2 W This is the classic Coffee game. The computer W picks a random number, and two computer W operators take turns trying not to guess it. W The one who does, buys the coffee. W Command Usage W Coffee W There are no command line parameters. W Return codes W (not applicable) W Modification History W Vers 1.0, Jan. 28, 1989- Originally written W Vers 1.1, Dec. 15, 1989- Minor improvements W Planned W Enhancements W (none)AU2 A2 W - 7 - WA 2A2 W GThe Grund UtilitiesHA 2 W GDiskUse - Disk Usage DisplayHA*2 W Current Version: Vers 1.0, December 30, 1989A2 W FunctionA 2 W The purpose of DiskUse is to determine how W much hard disk and diskette space is W used/needed for all different diskette types. W Description W Based on the path name/file mask provided in W the command line, the program will determine W how many 512-byte clusters are used. It will W then determine how many of these clusters W would be needed for any given diskette medium W (high density, low-density, etc). This can W help you make an intelligent decision as to W which diskette type and/or how many diskettes W are needed to backup a given set of files. W Command Usage W DiskUse pathname /s /d W DiskUse: The program name. You may rename it W to whatever you are comfortable with, if you W wish. W PathName: The name of the path of file mask W is to be processed. If a file mask is not W specified, *.* is used. W /s- Process subdirectories as well. This W feature is active only when *.* is specified W in the file mask. W /d- List files counted W Return codes W ... are not used. W Modification History W Vers 1.0, Dec. 30, 1989- Originally written W Planned W Enhancements W Process the file mask that is specified on W the command line through subdirectories when W the /s switch is used.A-2 W - 8 - WA 2A2 W GThe Grund UtilitiesHA 2 W GDocUtil - Documentation UtilityHA*2 W Current Version: Vers 1.1, December 15, 1989A2 W FunctionA 2 W The purpose of DocUtil is to perform various W operations on text files, namely, W documentation. Currently, its only function W is to print a text file into odd- and even- W numbered pages. W Description W The program will "print" the input file into W two output disk files. One file will contain W all of the odd-numbered pages that would have W printed, had the output been going to a W hardcopy printer. The other file will contain W all of the even-numbered pages. W The resultant files can them be copied to PRN W (or LPT1). Copy the odd-numbered pages file W to the printer first. Then, take the paper W out of the printer, turn it around, reinsert W it, and copy the even-numbered pages file to W the printer. W The output is intended to be printed on W continuous-form 8.5 X 11" paper. Therefore, W the maximum line width that can be processed W is 80 minus the size of the margin. The W program will first check the input file to W see if any lines would exceed the line W length. If so, a warning message is printed, W and the user is given the opportunity to let W the program continue, or quit. W If the program continues, any lines that W exceed the maximum line length are chopped at W the maximum, and the remainder of the line is W written on subsequent lines. W If your input document exceeds the maximum W line length, you may want to reformat it W (cutting the right margin, for example), W before running it back through this program. W Command Usage W DocUtil Inputfilename OddFileName W EvenFileName ff=y ms=6 dc=y lp=60 W pn=tAN2 W - 9 - WA 2A2 W GThe Grund UtilitiesHA 2 W GDocUtil - Documentation UtilityHA*2 W DocUtil: The program name. You may rename itA 2 W to whatever you are comfortable with, if you W wish. W InputFileName: The name of the text file that W is to be processed. W OddFileName: The name of the file to which W the odd-numbered pages will be written. This W operand is required. W EvenFileName: The name of the file to which W even-numbered pages will be written. This W operand is required. W ff: Honor formfeeds that appear in the input W file? Answer 'y' or 'n' (without the quotes). W The default is 'y'. When this switch is set W to 'y', the program will treat formfeeds as W they were intended. Headings will be W processed whenever a formfeed is encountered. W When this switch is set to 'n', formfeeds are W simply ignored. W ms: Margin size, in tenths of an inch. The W default is 6. This margin will appear on the W left side of odd-numbered pages, and on the W right side of the even-numbered pages. This W way, you can safely add hole-punches to the W document. W dc: Honor dot commands? Answer 'y' or 'n' W (without the quotes). The default is 'y'. W When this switch is set to 'y', the dot W commands will be processed as intended. When W this switch is set to 'n', dot commands are W treated as text. W lp: Lines per page. The default is 60. This W is the number of lines the program will count W before it skips to a new page. W Dot commands W Dot commands can appear anywhere in the body W of the input file, as long as they start a W line. When a valid dot command appears, it W sets the values that will be used later in W the program. For example, setting H1 (heading W line 1) will cause that line to print the W -next- time headings are printed.A62 W - 10 - WA 2A2 W GThe Grund UtilitiesHA 2 W GDocUtil - Documentation UtilityHA*2 W Currently, the only valid dot commands areA 2 W .H1, .H2, and .H3, representing heading line W one through three, respectively. W Return codes W ... are not used. W Modification History W Vers 1.0, Feb. 27, 1989- Originally written W Vers 1.1, Dec. 15, 1989- Minor enhancements W Planned W Enhancements W (none)AQ2 W - 11 - WA 2A2 W GThe Grund UtilitiesHA 2 W GEDir - Enhanced DirectoryHA*2 W Current Version: Vers 1.3, December 16, 1989A2 W FunctionA 2 W EDir is a directory listing utility program. W When invoked, EDir will display a directory W listing in ascending sequence by file name. W Description W When EDir is first invoked, it will sort the W directory. On my particular machine, this W happens so fast that you don't even realize W that the directory is being sorted. If the /s W switch is supplied, then grand totals are W printed at eoj. W Command Usage W EDir path or filename /h /s /p /t W -EDir- - The command name. You may rename it to W whatever you prefer: "EDir" may not be the W quickest combination of keystrokes for W invoking this command. W -path or filename-- The name of the directory W or file name to process. Wildcards are W supported if the /s switch is omitted. If W nothing is specified, the current directory W will be processed. W /h - Display a help screen (command syntax) W /s - Process the specified directory and all W all subdirectories within. This feature is W active only when *.* is specified in the file W mask. W /p - Will cause the program to pause after W every screenful of output W /t - Totals only (no detail will be printed) W All output can be redirected via normal DOS W commands: W "EDir > prn" will send the listing to the W printer W "EDir > dir.lst" will send the listing to W disk as "dir.lst" W Return codes W Return codes are not supportedA*2 W - 12 - WA 2A2 W GThe Grund UtilitiesHA 2 W GEDir - Enhanced DirectoryHA*2 W Modification HistoryA2 W Vers 1.0, May 28, 1989- Originally written W Vers 1.1, May 30, 1989A 2 W 1) Corrected bug: display messed up when W trying to process a directory that contained W more than 112 files. Maximum increased to W 500. W 2) Corrected bug: noon printed as 0:nnpm W 3) Added Volume ID to display W 4) Added free space to display W 5) Added facility to print totals only W 6) Added facility to pause after every W screenful of output W Vers 1.2, Jun 25, 1989 W 1) Runtime error 202 (stack overflow) W occurred when processing a directory at the W 4th level. File limit decreased from 500 to W 200; directory limit decreased from 112 to W 50. W 2) Removed some verbage at end of job W 3) Reformatted totals-only output W 4) Corrected a bug where hidden files were W not correctly shown W Vers 1.3, Dec 16, 1989- Minor modifications W Planned W Enhancements W (none)AU2 A22 W - 13 - WA 2A2 W GThe Grund UtilitiesHA 2 W GGotcha - DOS Command Line SimulatorHA*2 W Current Version: Vers 1.2, January 3, 1990A2 W FunctionA 2 W DOS command "simulator" W Description W This program is a gag, and no more. Load this W command on a friend's computer, and walk W away. The computer will react to commands W that are typed in, but not in the way that W the user will expect. W The program will echo all but the most W sophisticated command line prompts, so the W user will be totally unaware that Gotcha is W waiting for a "DOS" command. W To exit from the program, you must type in W the word "please" at the phoney DOS command W prompt (Cntl-Break will not work). W Caution! W This program, as written by the author, is W completely harmless! However... please make W sure that you received this program from a W reliable BBS, or directly from the author or W other reliable source. Since this is a gag, W hackers may be tempted to vandalize the W executable program and attempt to cause W damage to your system. If you are in GdoubtH as W to whether this program is safe to use on W your system, I encourage you to use whatever W means you have of detecting a virus or other W problem, or Gdiscard the programH. W Command Usage W Gotcha W There are no command line parameters. W Return codes W Return codes are not used. W Modification History W Vers 1.0, Nov 17, 1987- Originally written W Vers 1.1, Dec 16, 1989- Minor improvements W Vers 1.2, Jan 3, 1989- Added more commands; W processed the actual command prompt (in most W cases)A62 W - 14 - WA 2A2 W GThe Grund UtilitiesHA 2 W GGotcha - DOS Command Line SimulatorHA*2 W PlannedA 2 W Enhancements W (none)AU2 A62 W - 15 - WA 2A2 W GThe Grund UtilitiesHA 2 W GListT - Source Text ListerHA*2 W Current Version: Vers 1.3, January 3, 1990A2 W FunctionA 2 W The purpose of ListT is to provide a quick W and easy way to print source program text W suitable for storing in a three-ring binder. W Description W ListT will process the file name or file W specification supplied on the command line. W Wild cards are honored. You can interrupt W printing anytime by pressing a key at the W keyboard. W Source text is chopped after 69 characters, W and the rest of the line is printed on the W next line. W One heading line is inserted at the top of W every page, containing the name of the source W member, and the date and time it was printed. W Command Usage W Listt filemask W filemask: The name of the file or group of W files to list. If the extension is not W supplied, it will default to ".PAS". If no W command line parameter is supplied, the W program will prompt for one. DOS wildcards W are supported. W Return codes W Return codes are not used. W Modification History W Vers 1.0, Nov 29, 1987- Originally written W Vers 1.1, Dec 16, 1989- Minor enhancements W Vers 1.3, Jan 3, 1990- a) Corrected "not W found" condition that occurred when printing W more than a dozen files; b) Substituted the W blank in the day field of the printed date W with a zero. W Planned W Enhancements W (none)A-2 W - 16 - WA 2A2 W GThe Grund UtilitiesHA 2 W GNotBack - List All Files Not Backed UpHA*2 W Current Version: Vers 1.4, December 16, 1989A2 W FunctionA 2 W The purpose of NotBack is to list (the names W and file sizes of) all files that have not W been backed up. Specifically, it will list W the names of all files whose DOS archive bit W is set. W NotBack will list the directory specified, W and all subdirectories within. W Description W NotBack will traverse the directory W specified, looking for all files whose DOS W "archive" attribute bit is set. W When DOS modifies a file, it turns on the W "archive" attribute bit. If you backup your W files with XCOPY using the "/m" switch, as I W do, then this little utility can be a W tremendous time saver. W Previous versions of NotBack checked ALL hard W drives attached to the system. This one gives W you a choice. W The number of files and total number of bytes W are listed at end of job. W Command Usage W NotBack directoryname ColorSwitch W NotBack- The name of the program. Change it W to anything you prefer. I personally invoke W this program from a batch file called W NotB.Bat. W directoryname- The name of the directory to W process. If nothing is specified, the current W directory will be used. W ColorSwitch - Specify /C or /c if you wish W the output from the program to be displayed W to the screen in colors. If you -don't- use the W color switch, then output is DOS- W redirectable. W Output is faster if the color switch is not W used. The program then uses Turbo Pascal's W built-in fast screen-write routines.A62 W - 17 - WA 2A2 W GThe Grund UtilitiesHA 2 W GNotBack - List All Files Not Backed UpHA*2 W Return codesA 2 W Return codes are not used. W Example W To check your entire system for files that W were not backed up, you could create a batch W file that looks something like this: W Echo Off W Rem NotB.BAT - Check for files that W were not backed up W Rem Written by me, April 23, 1989 W NotBack C:\ W Pause W NotBack D:\ W Pause W Modification History W Vers 1.0, Nov, 1987- Originally written (in W Turbo Pascal Vers 3) W Vers 1.1, Sept 17, 1988 - Rewritten in Turbo W C vers 1.5 W Vers 1.2, Apr 23, 1989 - Rewritten in Turbo W Pascal vers 5. Corrected one bug: double W backslash after directory name when W processing the root directory. W Vers 1.3, Nov 4, 1989 - By request, output W from the program has been made MS-DOS W redirectable. W Vers 1.4, Dec 16, 1989- Minor enhancements W Planned W Enhancements W (none)AU2 A,2 W - 18 - WA 2A2 W GThe Grund UtilitiesHA 2 W GPCtl - Printer ControlHA*2 W Current Version: Vers 1.2, January 1, 1990A2 W FunctionA 2 W PCtl is used to copy printer control W characters to the printer. W Description W PCtl is a very simple printer control W program. It's primary use is in batch jobs. W I use this particular program in a batch W file, to skip to the top of the W page after the command has completed. W Command Usage W PCtl char1 char2 char3 char4 ... W PCtl - The command name. You may rename it to W whatever you prefer. W char1, char2, etc- decimal control characters W If no parameters are specified, the command W syntax will be displayed. W Return codes W Return codes are not used. W Example W The examples below apply only to IBM- (or W Epson)-compatible printers. W PCtl 12 will effect a form feed W PCtl 10 will effect a line feed W PCtl 27 69 will turn on near-letter-quality W PCtl 27 70 will turn off near-letter-quality W Modification History W Vers 1.0, May 28, 1989- Originally written W Vers 1.1, Dec 16, 1989- Minor enhancements W Vers 1.2, Jan 1, 1990- Added error handling W routines W Planned W Enhancements W (none)A32 W - 19 - WA 2A2 W GThe Grund UtilitiesHA 2 W GSDN - Sorted Directory w/NotesHA*2 W Current Version: Vers 1.7, Dec 16, 1989A2 W FunctionA 2 W SDN, Sorted Directory w/Notes, will allow you W to annotate your directories. W Description W SDN processes in several phases: W 1. Read the directory W 2. Sort the directory W 3. Read the existing notes file W 4. Merge the directory with the exiting notes W file W 5. Go into full-screen edit W SDN will process a directory that contains up W to 300 files. If more than that number of W files are contained in the directory, the W program will stop, and suggest that you clean W up your hard disk (fair enough, don't you W think?). W The directory is sorted by file name, W ascending. W If an existing notes file exists, it is read W into memory. Notes files are named "!.SDN". W These hopefully will sort above ALL other W files in the directory. W The directory that is in memory is now merged W with the existing notes file that is in W memory, and written to the same place where W the original !.SDN file was read from. The W original file -will be- overlaid with the new W file. W The Borland Binary Editor is then invoked, W and it will read in the newly-created !.SDN W file. W The program will start in insert mode. W Hit F10 to save any changes you make; hit W ESCape to cancel them. W Command Usage W -SDN- - The command name. You may rename it to W whatever you prefer. I, however, have found W this to be an ideal set of characters for W this command.A62 W - 20 - WA 2A2 W GThe Grund UtilitiesHA 2 W GSDN - Sorted Directory w/NotesHA*2 W -pathname-- The name of the directory or fileA 2 W name to process. If nothing is specified, the W current directory will be processed. W Return codes W SDN will halt with an error code of 100 or W 101 (depending on which file is being W processed at the time), if the maximum number W of files is reached. Currently, this limit W has been set at 300. W Sample output W The notes file is named !.SDN. A sample is shown below. W !.SDN 1227 7-29-88 22:36 ....A This file W COMMON.PAS 1536 7-29-88 20:32 ..... \ Common W COMMON.TPU 1600 7-29-88 20:32 ..... / W SDN.EXE 32064 7-29-88 20:35 ..... This program W SDN.PAS 1006 7-29-88 20:13 ..... W UTILITY.PAS 5686 7-29-88 20:17+..... W UTILITY.TPU 3104 7-29-88 20:32-..... W WORKLOG 218 7-29-88 20:54 ....A W The first column lists the file names. W The second column contains the file sizes. W The third column contains the file creation/last W modification date. W The fourth column contains the file creation/last W modification times. W The fifth column is a one-character field, and it will W contain either a blank, a plus, or a minus. W A plus sign after the time indicates that this is a W file that was created since the last time SDN was run W on this directory. W A minus sign indicates that this is a file that existed W in the directory previously. W The next column is a five-position field that contains W codes that represent the file's attributes, r,h,s,d,a, W respectively. If a period is contained in the position, W the attribute is considered to be "off". Otherwise, a W capital letter will appear: W R - this file is a read-only file W H - This file is a hidden file W S - This file is a system fileA*2 W - 21 - WA 2A2 W GThe Grund UtilitiesHA 2 W GSDN - Sorted Directory w/NotesHA*2 W D - This file is a directory or subdirectoryA 2 W A - This file has been added or modified since the W last time a backup was taken. W Consult your DOS manual for a more detailed description W of these codes. W The final column is the field that contain your notes. W Even though the Binary Editor will allow you to go W further, the program will retain only G50H positions of W this field. The next time SDN is run, if there are any W notes fields over 50 bytes, they will be truncated to W the maximum length. W Modification History W Vers 1.0, July, 1988 - Originally written W Vers 1.1, Jul 29, 1988- Renamed notes file to W !.SDN, to sort above all files that begin in W numbers. W Vers 1.2, Aug 6, 1988- W 1) Corrected a problem whereby the program W would not operate properly inside the root W directory of a disk. W 2) The work files created by the program are W no longer processed as part of the directory W Vers 1.3, Jan 27, 1989 W 1) Only the current directory can be W processed. W 2) Program no longer creates a .BAK file. W 3) Program allows specification of a path for W work file space W 4) Cleaned up potential run time errors W 5) Allow user to change his mind about W exiting after hitting ESC W Vers 1.4, Jan 31, 1989 W 1) Reinstated ability to process a different W (than current) directory. W 2) Corrected some minor bugs (faulty write- W protect message, etc) W Vers 1.5, Jul 4, 1989 W 1) Corrected the way the time printed W (12:30pm printed as 0:30pm) W 2) Editor now starts in insert mode. W 3) Corrected a bug: an I/O error 2 occurred W when trying to process a directory that W contained a period in the name.A*2 W - 22 - WA 2A2 W GThe Grund UtilitiesHA 2 W GSDN - Sorted Directory w/NotesHA*2 W 4) Workfiles are no longer used. AllA 2 W processing is done in memory. W 5) Attributes that are "off" formerly printed W in lower case. These now print as periods. W 6) Some cosmetic changes were made. W Vers 1.6, Jul 6, 1989 W 1) Oops! Bug in total bytes corrected (has an W integer field where a LongInt should have W been used). W 2) Increased maximum length of notes field to W 50 characters W 3) Deleted trailing spaces in notes field, so W the !.SDN file can now be properly browsed. W Vers 1.7, Dec 16, 1989- Minor enhancements W Planned W Enhancements W (none) W Trademark W Acknowledgements W Turbo Pascal and Borland Binary Editor are W registered trademarks or Borland W International, Inc. W Sprint is a registered trademark of Borland W International, Inc. W Wordstar is a trademark of Micropro W International, IncAU2 A22 W - 23 - WA 2A2 W GThe Grund UtilitiesHA 2 W GSimpEdit - Simple Text EditorHA*2 W Current Version: Vers 1.2, December 17, 1989A2 W FunctionA 2 W SimpEdit is a simple text editor. You can use W it to edit any pure ASCII file. W Description W SimpEdit is used to create those quickie text W files, or to create batch files. Firing up a W word processor may be overkill for these W purposes. W This program invokes the Borland Binary W Editor. Those commands are listed later in W this manual. W Command Usage W SimpEdit pathname /e W SimpEdit - The command. You may rename it to W anything that you are comfortable with. I W have renamed my personal version to "E" W pathname - The pathname of the file you wish W to edit W /e - Specify this switch if you have an EGA W system and you want a 42-line screen. The W letters, however, will be quite small. W Return codes W If the program abends for any reason, a code W that can be tested by the DOS ERRORLEVEL W command will be set, along with an error W message. W Code Message W 2 Unable to load the binary editor W 3 Unable to read file W Modification History W Vers 1.0, Jan 5, 1989- Originally written W Vers 1.1, Feb 4, 1989- Improved error- W condition handling W Vers 1.2, Dec 17, 1989- Minor improvements W Planned W Enhancements W (none)AN2 W - 24 - WA 2A2 W GThe Grund UtilitiesHA 2 W GSJ - Split/JoinHA*2 W Current Version: Vers 1.4, January 5, 1990A2 W FunctionA 2 W The purpose of SJ is to split large files W into smaller, more manageable pieces, or to W rejoin files that have been previously split. W Description W SJ can split a file into up to 20 output W files. A binary input file must be at least W 65,281 bytes long. There is no practical W minimum for ASCII files. W How GbinaryH files are broken up by SJ: W The program divides the file size by the W number of files that you specify. This figure W is adjusted up to 32,640. The program then W determines how many 32,640-byte blocks are W contained in the input file, and adjusts the W number of output files accordingly. W How GASCIIH files are broken up by SJ: W The program first counts the lines that are W contained in the input file. The number of W lines is then divided by the number of files, W and any remainder is added to the first W output file. W The program will display activity counts as W it processes. W In an effort to maintain program speed, the W program does not check to see if it has W exceeded available disk space. If your input W and output counts differ, it's a safe bet W that this is what has happened. W The join function is intended for use only on W files that have been split by this program. W You can still combine files that were not W split by this program, but you must name them W as if this program had split them up W initially. W File Names W When splitting an input file, the program W will assign the output file name by W substituting the file extension with @01, W @02, etc, for as many as needed. When W rejoining files, the program will look for W files with those extensions. So when you areA*2 W - 25 - WA 2A2 W GThe Grund UtilitiesHA 2 W GSJ - Split/JoinHA*2 W rejoining files, do not specify a fileA 2 W extension. W Applications W 1) You may have a binary file that is very W large, and you wish to transmit it via a W modem. If you split the file first, then if W the file transfer breaks, you won't have to W retransmit everything that was previously W sent. W 2) You may have a file on your hard drive W that is larger than your floppy drives can W handle (DON'T use BACKUP/RESTORE!) W 3) You have an ASCII file that is too large W to be processed by your text editor. Simply W split the file into as many smaller text W files as needed, edit them, and join them W back together when done. W Command Usage W SJ Oper FileName NoOfFiles Binary/ASCII W SJ - The program name W Oper - S for split, J for join, or H for help W FileName - The filename of the file that you W wish to split files out of, or join files W into. W NoOfFiles - The number of files that you want W the program to split the file into, or W combine from W Binary/ASCII- The format of the files being W processed. Only the first letter is checked. W If this operand is not supplied, then Binary W is assumed. If this operand is in error, the W command will stop. W Return codes W SJ will set the DOS return code that can be W tested via ErrorLevel. All of the following W are reasons for premature program W termination. W -Code- -Module- -Reason- W 1 Init No parameters specified. W SJ was entered alone on the W command lineA*2 W - 26 - WA 2A2 W GThe Grund UtilitiesHA 2 W GSJ - Split/JoinHA*2 W 2 Init Help requestedA 2 W 3 Init Invalid first parameter W 4 Init Split: File cannot be W opened W Join: File already exists W 5 Split Binary file exists W 6 Split Binary input file not large W enough to necessitate a split. W File is less than 65,281 bytes. W 7 Split Too many output binary files. W This condition is determined by W the program. W 8 Init Filename (parameter 2) missing W 9 Init Invalid number of files. SJ can W split or combine between 2 and 20 W files, inclusive. W 10 Join Binary file does not exist W 11 - Invalid file mode. Specify B for W binary or A for ASCII. W 12 Split ASCII input file not large W enough to necessitate a split. W File is less than 20 lines. W 13 Split Too many output ASCII files. This W condition is determined by the W program. W 14 Split ASCII file exists W 15 Join ASCII file does not exist W Example W To split the GIF of the SI girl into two W files (for purposes of sending them over a W modem): SJ S SiGirl.GIF 2 W To rejoin them at the other end: W SJ J SIGirl 2 W Modification History W Vers 1.0, Feb 9, 1989- Originally written W Vers 1.1, Sept 8, 1989- Expanded the W capabilities of the program to allow it to W split/join up to 20 files instead of only W two. W Vers 1.2, Dec 17, 1989- Minor modifications W Vers 1.3, Dec 31, 1989- Added the facility to W process ASCII (text) files. W Vers 1.4, Jan 5, 1990- Cleaned up processing W for more than 18 files. W Planned W Enhancements W (none)A*2 W - 27 - WA 2A2 W GThe Grund UtilitiesHA 2 W GStamp - Print Date and TimeHA*2 W Current Version: Vers 1.2, December 17, 1989A2 W FunctionA 2 W The purpose of Stamp is to provide a W recording of the date and time of an event. W It is your typical "quickie", put has a W purpose nonetheless. W Description W This program will send the current date and W time to the normal DOS output file. This file W is totally redirectable via normal DOS W commands. W Command Usage W Stamp W The program uses no command line parameters. W Return codes W This program does not use return codes. W Example W Stamp W will produce: W The date is 5/30/1988, the time is W 10:15:44.04 W Stamp > logon.log W will create that message to a file called W Logon.Log. W Stamp >> logon.log W If logon.log exists, the message will be W appended to it. W If not the file will be created with that W message. W I have this in my autoexec as: W Stamp >> Logon.Log W so I can look back and see when I logged on W to the system. W Modification History W Vers 1.0, May 30, 1989- Originally written W Vers 1.1, Dec 17, 1989- Minor enhancements W Planned W Enhancements W (none)A*2 W - 28 - WA 2A2 W GThe Grund UtilitiesHA 2 W GThe Borland Binary EditorHA*2 W The Borland Binary Editor Quick Command Reference List is printedA 2 W here, because two of the utilities included in this package W invoke the Borland Binary Editor. W The Borland Binary Editor is included as part of the Turbo Editor W Toolbox. It is copyrighted by Borland International, Inc. W The commands are very similar to those used by the popular W WordStar word-processor, and by all of Borland's language W editors. W Borland Binary Editor - Quick Command Reference List W KeyStrokes Function W Ctrl-A or Ctrl-left arrow word left W Ctrl-C page down W Ctrl-D or right arrow character right W Ctrl-E or up arrow line up W Ctrl-F or Ctrl-right arrow word right W Ctrl-G or del delete current character W Ctrl-H or backspace delete character left W Ctrl-I or tab tab W Ctrl-K-0..3 set marker 0..3 W Ctrl-K-B or F7 begin block W Ctrl-K-C copy block W Ctrl-K-D save file and exit editor W Ctrl-K-H hide block W Ctrl-K-K or F8 end block W Ctrl-K-P print block W Ctrl-K-Q or ESCape abandon edit (lose changes!) W Ctrl-K-R read block from file W Ctrl-K-T mark current word as block W Ctrl-K-V move block W Ctrl-K-W write block to file W Ctrl-K-Y delete block W Ctrl-L find next W Ctrl-M (or enter) new line W Ctrl-N insert line W Ctrl-O-T toggle fixed tabs W Ctrl-P insert control character W Ctrl-Q-0..3 jump to marker 0..3 W Ctrl-Q-A find and replace W Ctrl-Q-B top of block W Ctrl-Q-C or Ctrl-PgDn end of file W Ctrl-Q-D or end end of line W Ctrl-Q-E or Ctrl-home top of screen W Ctrl-Q-F find W Ctrl-Q-I toggle auto-indent mode W Ctrl-Q-K bottom of block W Ctrl-Q-L restore line W Ctrl-Q-P previous cursor positionA*2 W - 29 - WA 2A2 W GThe Grund UtilitiesHA 2 W GThe Borland Binary EditorHA*2 W Ctrl-Q-R or Ctrl-PgUp beginning of fileA 2 W Ctrl-Q-S or home beginning of line W Ctrl-Q-X or Ctrl-end bottom of screen W Ctrl-Q-Y delete to end of line W Ctrl-R page up W Ctrl-S or left arrow character left W Ctrl-T delete word W Ctrl-V or ins toggle insert mode W Ctrl-X or down arrow line down W Ctrl-W scroll up W Ctrl-Y delete line W Ctrl-Z scroll downAU2 W - 30 - WA 2A2 W GThe Grund UtilitiesHA 2 W GTechnical SupportHA*2 W The low cost of our shareware prohibits us from returning long-A 2 W distance telephone calls, or providing in-depth answers to your W inquiries. W We are receptive to problem reports, and suggestions for W improvements and enhancements. W To report a problem or provide suggestions for improvements or W enhancements, please address your correspondence to: W Grund Software Services W Systems Department W 7903 Grover W Omaha, NE 68124-3329 W If you need to telephone, you may reach us at (402) 393-8371. W We can also be reached at any of the -better- Omaha Area electronic W bulletin board services. Send all E-mail to GDave GrundH.AI2 W - 31 - WA 2A2 W GThe Grund UtilitiesHA 2 W GDisclaimerHA*2 W The utilities included in this package have been tested and usedA 2 W on the author's machines. W Grund Software Services, however, makes no guarantees as to the W reliability or usability of these products. We will not be liable W for any damages that result from the use of or the inability to W use the products packaged herein. W These programs have been included in this package in good faith.AN2 W - 32 - WA 2A2 W GThe Grund UtilitiesHA 2 W GPackage Enhancements/ModificationsHA*2 W The Grund Utilities package was originally distributed as versionA 2 W 1.0 with the following programs: W ChkVol - Vers 1.0 NotBack - Vers 1.4 W Coffee - Vers 1.1 PCtl - Vers 1.1 W DocUtil - Vers 1.1 SDN - Vers 1.7 W Edir - Vers 1.3 SimpEdit - Vers 1.2 W Gotcha - Vers 1.1 SJ - Vers 1.2 W ListT - Vers 1.2 Stamp - Vers 1.2 W -Changes effective with version 1.1- W 1. Added DiskUse, Vers 1.0 W 2. Enhanced SJ to split/join ASCII (text) files. W 3. Added error handling routines to PCTL. W 4. Beefed up Gotcha. W 5. Corrected a minor bug in ListT. W Check the documentation of the particular program for information W on modifications and enhancements made to the programs W themselves.AU2 A&2 W - 33 - WA 2A2 W GThe Grund UtilitiesHA 2 W GShareware RegistrationHA*2 W If you find the Grund Utilities useful, I urge you to registerA 2 W your version. Shareware registration keeps shareware authors W motivated, and provides the microcomputer user community a W continuing supply of "try before you buy" software. W Registration types range from single to special, depending on the W plans for use. W These utilities are not crippled for shareware; they are full W working programs.AU2 A2 W - 34 - WA 2A2 W GThe Grund UtilitiesHA 2 W GShareware RegistrationHA*2 W GSoftware Registration ChartHA2 W Single RegistrationA 2 W Use of the software is intended for one to W three of your -own- personal computers. W Small Site License W Use of the software is intended for four to W fifteen computers associated with the same W company/group. W Medium Site License W Use of the software is intended for sixteen W to fifty computers associated with the same W company/group. W Unlimited Site License W Use of the software is intended for any W number of computers associated with the same W company/group. W Special Registration W Use of the software is intended for one W personal computer. This category applies to W individuals on a fixed income, full and W part-time students, and those who cannot W easily afford regular registration of this W product. Special registration comes at a W significantly lower cost, when possible. W How to register W To register your copy of GThe Grund UtilitiesH, W please complete the order form included later W in the manual, and mail with the correct W payment. Please send checks or money orders W only; cash gets lost in the mails. Make W checks payable to "Grund Software Services". W Send form and payment to: W GGrund Software ServicesH W 7903 Grover W Omaha, NE 68124-3329 W ATTN: Distribution DepartmentAK2 W - 35 - WA 2A2 W GThe Grund UtilitiesHA 2 W GShareware RegistrationHA*2 W ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿A 2 W ³ GSoftware Registration Order FormH ³ W ³ (These prices are as of 1/03/90, and are for the ³ W ³ version documented herein.) ³ W ³ GRegistration Price ListH ³ W ³ Single Registration: $ 14.00 ³ W ³ Small site license: 56.00 ³ W ³ Medium site license: 210.00 ³ W ³ Large site license: 249.00 ³ W ³ Special Registration: $ 3.50 ³ W ³ ³ W ³ GDiskette price listH ³ W ³ 5.25" DS DD (360K) $1.00 ³ W ³ 5.25" DS HD (1.2Meg) 2.00 ³ W ³ 3.5" DS DD (720K) 3.00 ³ W ³ 3.5" DS HD (1.44 Meg) 4.00 ³ W ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ W ³ Please accept my registration for ³ W ³ GThe Grund Utilities, version 1.1.H ³ W ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ W ³ ³ W ³ Name ___________________________________________________ ³ W ³ ³ W ³ Company ________________________________________________ ³ W ³ ³ W ³ Address ________________________________________________ ³ W ³ ³ W ³ ________________________________________________ ³ W ³ ³ W ³ City, State, ZipCode ___________________________________ ³ W ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÂÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄ´ W ³ ³Quan³ Unit $ ³ Total $ ³ W ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄ´ W ³Registration type: _______________³ ³ ³ ³ W ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄ´ W ³*Please send me the most current ³ ³ ³ ³ W ³version on diskette(s). The ³ ³ ³ ³ W ³diskette size/type is ___________ ³ ³ ³ ³ W ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÅÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄ´ W ³Nebraska residents please add the ³ ³ ³ ³ W ³appropriate sales tax (5.5% now) ³ ³ ³ ³ W ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÁÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄ´ W ³ Total remitted ³ ³ W ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÙ W * Items marked with an asterisk are optional. W Grund Software Services thanks you for your patronage!A32 W - 36 - @