DOS Utility Pack
Version 1.2
by
Jim Derr

Member of
Association of Shareware Professionals
CSERVE ID 76266,2634

DUTIL is a collection of utility programs to make life a little eaiser
when working with DOS. All of there programs require DOS 2.1 or higher
and have been tested on PC/XT's, AT's, PS/2's, and should work on most
clones.

Please note this is a shareware product. If you find these utilities
useful please register and keep shareware alive. Only registered users
will be supported. The fee is small and not unreasonable.


FF2 FileFinder2
----------------------------------------------------------------------
This program will find files on your hard disk. It as fashioned after
the whereis program but has more features.

Format is FF2 options [filespec filespec filespec....] options
Where options are:
/R raw listing - full path name only
/S short listing - filename.ext only
/B list in bat file format
/P pause when screen is full
/Q quite mode
errorlevel 1 returned if no files found
errorlevel 0 returned if files are found
/X"cmd" execute a cmd against all files found

The filespec's that are specified on the command line can include a disk
and directory. If a disk and or directory is specified than the search
will be restricted to the specified disk and directory and any
sub-directories under the specified directory. Each filespec can
contain different starting disks and directories.

When specifing the file to search for FF2 has a quick complete
algorithm. If you do not include a period and the file extension
FF2 will expand the filespec using the wildcard character ? for the
remainder of the filespec. For example if you entered FF2 AB, FF2
will expand the filespec to AB??????.???. If you enter FF2 C:\BAT\B
FF2 will expand the filespec to C:\BAT\B???????.???. However if you
enter FF2 B.* , FF2 will not alter the filespec since you included a
period in the filespec.

If no disk or directory is included with the filespec than the entire
default disk will be searched.

You can tell FF2 to search multiple disk by using the environment
variable FF to specify what disks to search.
For example. SET FF=CD tells FF2 to search the C and D drives if you
have not specified a disk in the filespec on the command line.

All output from FF2 can be redirected or piped by using the DOS redirect
and pipe characters.

The default output produced by FF2 file-size, file-date, file-time,
disk:\directory\filename.fileext. This can be changed by using the
following command line options:

/R Produces a raw listing containing disk:\directory\fn.ext only.

/S Produces a short listing containg filename.ext only.

/B Produces a listing that can be used as a bat file. The output
is as follows:
%1 filename.ext %2 %3 %4 %5 %6 %7 %8 %9

/P Will case a pause when the screen is full.

/Q Quite mode no output produced but results can be tested by using
the if errorlevel command in a .bat file.

/X"cmd" This options allows you to tell FF2 to execute a specified
against all files that are found.
For Example: /X"del &" will execute the delete command against
all file that were found. The command can be any DOS command
or another program. FF2 will insert the disk:\dir\fn.fext
of the found file into the command where you place the &
character.

For example if you specify the following:

/X"grep any & -s"

and FF2 finds the file c:\data\any.doc it will execute the
following command:

grep any c:\data\any.doc -s

If you do not put the & in then FF2 will insert the found
filespec at the first blank in the command you specify, or at
the end of the command if no blanks exist.


FFF Fullscreen FileFinder
----------------------------------------------------------------------
This program will find files on your hard disk, and present them in
a scrollable list.

Format is FFF options [filespec filespec filespec....] options
Where options are:
/2 25 line mode display
/4 43 line mode display
/5 50 line mode display

The filespec's that are specified on the command line can include a disk
and directory. If a disk and or directory is specified than the search
will be restricted to the specified disk and directory and any
sub-directories under the specified directory. Each filespec can
contain different starting disks and directories.

When specifing the file to search for FFF has a quick complete
algorithm. If you do not include a period and the file extension
FFF will expand the filespec using the wildcard character ? for the
remainder of the filespec. For example if you entered FFF AB, FFF
will expand the filespec to AB??????.???. If you enter FFF C:\BAT\B
FFF will expand the filespec to C:\BAT\B???????.???. However if you
enter FFF B.* , FFF will not alter the filespec since you included a
period in the filespec.

If no disk or directory is included with the filespec than the entire
default disk will be searched.

You can tell FFF to search multiple disk by using the environment
variable FF to specify what disks to search.
For example. SET FF=CD tells FFF to search the C and D drives if you
have not specified a disk in the filespec on the command line.


FFF will display all the files it found, up to it's internal maximum
of 500 files, on the screen in a scrollable list. You can use the
cursor keys, Pgup, Pgdn, HOME, END, CTL-HOME, and CTL-END to scroll
the list. Pressing the ESC key will exit the program. Pressing the
ENTER key will change the default disk and directory to the one that
contains the file currently highlited on the screen. Pressing the
F10 key will execute the program currently highlited on the screen.
Before the Progam is executed FFF will prompt you for any command
line parameters that you want to pass to the program. It will then
change to the disk and directory that the program is contained in,
unload itself from memory and execute the program.

PLEASE NOTE: you can not run BAT files using this method.

Pressing the F2 key allows you to run any program you wish against the
currently highlited file. A window will pop-up in which you must enter
program name that you wish to execute. The program can be a DOS
internal program, i.e. del, rename, or any EXE, COM, or BAT file. The
highlited filename is preloaded into the pop-up window for you.


If you are using a monochrome monitor and the screen does not appear
correct set the environment variable MONO to a Y. I.E. SET MONO=Y.


NPAUSE NEW-PAUSE
----------------------------------------------------------------------

This program adds some pizzazz to your batch files. It performs the
same function is the PAUSE command but with some added features.

Format is: NPAUSE "message" /Dx /Px /Bx /Fx

Where options are:

/Dx Delay x timer ticks between each character. (default 2)

/Px Pause for x times ticks after the complete message is shown.
(default is 6)

/Bx Backgound color to display is x. (default is black)

/Fx Foreground color to display is x. (default is white)

If no message is specified then,Press any key to continue!, will be used.

The specified or the default message will be displayed until a key is
pressed.

Play with it I think you'll like it.

Background color numbers Forgound color numbers
0 = black 0 = black 8 = gray
1 = blue 1 = blue 9 = light blue
2 = green 2 = green 10 = light green
3 = cyan 3 = cyan 11 = light cyan
4 = red 4 = red 12 = light red
5 = magenta 5 = magenta 13 = light magenta
6 = brown 6 = brown 14 = yellow
7 = white 7 = white 15 = intense white




EDPATH EDit-PATH
----------------------------------------------------------------------

This program allows you to dynamically edit your path specification.
It will display two lines at the top of your screen. The first line
tells you where your master environment area is located, it's size, and
the amount of free space left. The second line is a display of your
currently specified path. Using the cursor keys, home key, end key,
insert key, and delete key, you can modify the displayed path to suit
your needs. Pressing the return key will update the path, pressing the
escape key will leave your path untouched.


MODPATH MODify-PATH
----------------------------------------------------------------------

This program allows you to dynamically modify your path from the command
line or from within a .bat file. The format is:

MODPATH -a|-d directory;directory....

Where: -a means add the directory specified on the command line to
the path.

-d means delete the directory specified on the command line from
the path.

I.E. MODPATH -a c:\utility will add c:\utility to the path.
MODPATH -a c:\uty;d:\ws will add c:\uty;d:\ws to the path.
MODPATH -d c:\uty will delete c:\uty from the path.


C Change directory replacement
----------------------------------------------------------------------

Format C [disk:\]directory

This command will allow you to change to a different directory and or
disk with one command. In addition it is semi smart. For example if
your are currently in the c:\utility directory and you enter C DATA and
there is no subdirectory called DATA under the utility directory it will
change attempt to change to the DATA directory under the root. If it
cannot find a directory to change to you will remain where you are.



SSTRIP CSTRIP LSTRIP Piped file strippers
----------------------------------------------------------------------

These three commands read data from stdin and write it to stdout. Using
them you can strip characters, using CSTRIP, strings, using SSTRIP, or
lines, using LSTRIP, out of data streams. Most of the time you will
pipe data into the commands using the DOS pipe character | and redirect
their output using the DOS redirect character >. The format of the
commands are:

SSTRIP "string" where string is the string to strip out.
CSTRIP "x" where x is the character to strip out.
LSTRIP "string" "string" "string" "string" "string"
where string is the string to look for. You can
specify from 1 to 5 strings on the command line.
If any of the string(s) are found in a line the
entire line will be stripped out.

Examples:

type my.doc | SSTRIP "new" > my2.doc
This will strip out the string "new" when ever it is found is the
file my.doc and will create a new file called my2.doc.

type my.doc | CSTRIP "z" > my2.doc
This will strip out the letter z from the my.doc file and will
create the file my2.doc

LSTRIP "delete" < my.doc > my2.doc
This will strip out any lines that have the word "delete" in the
line and will create a new file called my2.doc.



PUSH POP Push and PoP directories
----------------------------------------------------------------------

How many times do you wish you could return to the disk and directory
your were in before you executed a batch file. PUSH and POP will solve
this problem. PUSH will save the current disk:\directory into a file
and POP will return you to the last disk:\directory that was pushed.

Format: PUSH [disk:\directory]
Push will save the current disk:\directory into a file named
STACK.DIR on your C: disk or a user specified disk. It will
then change to the disk:\directory specified on the command
line if present. PUSH can be executed any number of times
without an interveining POP command. However PUSH will only
remember the last 20 disk:\directories.


POP
Pop will take the last disk:\directory that was pushed onto the
stack and change to it and delete it from the stack.

PUSH and POP will look for an environment variable named DIRDRIVE. If
DIRDRIVE is found they will create and update the stack file on the
drive specified instead of the C: drive. The drive specified can be a
RAM disk which will increase the speed of PUSH and POP. The name of the
stack file is STACK.DIR.

For example: SET DIRDRIVE=D
Will tell PUSH and POP to maintain the STACK.DIR file on the D
drive. NOTE: If DIRDRIVE is not specified the C: drive will be
used!!!!