DISK UTILITIES

by

Plain Jayne Software




Disk Utilities should contain all of the following:

LO.EXE MOVE.EXE ELIM.EXE FD.EXE PJUTILS.DOC PJU.EXE


If any of these files are not present on this disk or are not in the archived
file from which you removed this .DOC file, please notify Plain Jayne Software;
we will send you the complete set.

These programs may be copied and distributed provided all of the files
listed above are copied together (including this file).



LO is a file locate utility that searches ALL directories on a hard
disk for any files matching a command line filespec. LO differs from
other similar locate programs by allowing the user to selectively search
only the current directory or only subdirectories down from the current
directory ( most will ALWAYS search the entire disk ).

Syntax at the DOS prompt, type: LO filespec /parameters

= LO is the name of the program
= filespec can be any valid DOS filespec. For example:

*.* will locate all files on the disk
*.bak will locate all files ending with .BAK on the disk
F*.* will locate all files beginning with F on the disk
RUN.BAT will locate the file RUN.BAT anywhere on the disk
\tp\*.* will list all files in the directory TP

--> LO defaults the search to *.* if the filespec is omitted.

= legal parameters are P,S,D,C (case insensitive).

P cancels the default of pausing after each full page
of information.
S means display the filename only (Short display); the
default displays name, size, time, and date.
D means search DOWN from the current directory only
C means search current directory only. if you get used to
using LO, then this switch will provide an alternative to
the DOS DIR command.

If a directory path is provided with no options, LO defaults
to that directory only. Using D will search down from that
directory only. No directory and no options means search the
entire disk. C and D can be used together.

** parameters must be separated from the filespec with a
forward slash / Even if the filespec is omitted, a
forward slash must be used or the parameters will be
ignored.

At any time, the listing of filenames can be paused by pressing
a key. Once paused, the listing will resume following another
keystroke.

Press the ESC key to exit LO at any time.


ELIM is a file erase utility that searches ALL directories on a hard
disk for any files matching a command line filespec, and erases
those files. Elim will prompt for confirmation before deleting any
file.

***** ELIM will not delete any protected files. *****
(unless told to do so)

Syntax at the DOS prompt, type: ELIM filespec /options

= ELIM is the name of the program
= filespec can be any valid DOS filespec. For example:

*.* will delete all files
*.bak will delete all files ending in .BAK
F*.* will delete all files beginning with F
etc.....

** ELIM will NOT default if a filespec is omited.

= legal options are P,C,D,Q,X (case insensitive).

*Q means NO confirm before delete (deletes without asking).
P will pause the screen when full IF the parameter /C
is also used. P will have no affect otherwise as
ELIM would pause during each delete confirmation anyhow.
D means search DOWN from the current directory only.
C means eliminate in current directory only.
X Elim will not delete any files marked as Read-Only,
System, or hidden UNLESS you use this option.

* Changed from 1.10. See note below anout PJU.EXE

If a directory path is provided with no options, ELIM defaults
to that directory only. Using D will search down from that
directory only. No directory and no options (C or D) means
search the entire disk. C and D together mean elim from here
down.


** parameters must be separated from the filespec with a
forward slash / . If no / is used, parameters will be
ignored.



MOVE is a file move utility that eliminates the need to use COPY and
ERASE when relocating files from one directory to another. MOVE
moves a specified file from one directory (origin) to another
directory (destination). The moved file will retain its original
name. Files may not be moved from one drive (disk) to another.

Syntax at the DOS prompt, type: MOVE origin destination

= MOVE is the name of the program
= origin and destination are any valid DOS filepaths.

= legal options are X (case insensitive).

X MOVE will not move a file if a file exists in the destination
directory of the same name UNLESS you use this option.
P no pause when screen full


MOVE RUN.BAT \DOS moves the file RUN.BAT from the current
directory to the directory \DOS

MOVE \DOS\*.BAT \UTILS moves all .BAT files from the directory
DOS to the directory UTILS

MOVE *.* UTILS moves all files from the current directory
to the subdirectory UTILS which is located
within (beneath) the current directory


** MOVE will NOT default if a filespec is omited.


You can now (1.20 and later) specify a filespec to move.



FD is a DOS hard disk file manager. A list of available commands is
available by typing ? or ^H (CTRL and H simultaneously). Basically,
FD provides the means of manipulating files--delete, copy, move, change
attributes, etc--in a 'point and shoot' manner. Files can be tagged
(marked) for collective processing (any of the above commands) at one
time.

FD recognizes only one command line option: H

If you use the option, FD will display and allow manipulation of
hidden files/directories. If you do not use H, FD will not display
or affect hidden files/directories.


FD is fairly well self-explanatory: type FD from the DOS prompt and
select the help screen by entering a question mark. The rest should
be simple. But, just in case, the commands available in FD are as
follows:

ESC - Exits program
cursor keys - moves the highlight bar in the direction of the arrow
key pressed.
HOME - moves the highlight bar to the top left filename of
the display
END - moves the highlight bar to the last filename in the
list
PAGE DOWN - displays the second page of filenames IF there are
more than 90 files/directories in the display
PAGE UP - displays the first page of filenames IF there are
more than 90 files/directories in the display
? - displays a list of commands (help)
D - (DOWN) change directories to the directory under the
highlight bar
P - (PARENT) change directories to the parent directory.
same as DOS command CD ..
O - change directories to the original directory. The
name of the origin directory displays at the top right
of the screen (line one).
N - NEW ORIGIN. makes the current directory the origin
directory
L - LIST all directories. You can then select to change
directories to one in the list.
K - maKe a directory/subdirectory in the current directory
S - screen refresh. after erasing or moving several files,
S will clear the screen and redisplay the current
directory
* - change the current filespec being used to search for
files. A list of available filespecs will display.
0-8 are fixed; 9 can be changed by the user during
operation of FD without affecting the start-up mask
values.
^Q - change the available list of masks. changes ARE saved
to the disk FD.EXE file: you must be in the directory
where FD resides. (I know, ^Q isn't mnemonic) If you
have changed mask #9 (during *), the new value for #9
will also be saved to disk!
^X - change the exit directory. By default, FD exits to the
origin directory (start-up directory). This setting is
saved to disk and will affect FD until changed again. If
changed, FD will thereafter exit to the current directory.
The current directory is displayed on line one starting in
column one. To save this change, you must be in the
directory where FD resides.


The following commands ONLY affect the file under the highlight bar:

C - copy this file to another directory/drive. FD will
prompt for the destination drive/directory. The name
of the file cannot be changed during copy.
M - Move this file to another directory. FD will prompt
for the destination directory. The name of the file
cannot be changed during move. The destination must
be on the same disk/drive.
E - Erase this file or erase this directory. If you
select to erase a directory that contains files, FD
will change to that directory and display the files.
R - rename this file/directory
A - change the attributes of the current file. FD will
only allow changes to the SYSTEM, HIDDEN, READ ONLY,
ARCHIVE attributes

T or + - tag the file under the hightlight bar. when a file
is tagged, an arrow will display pointing to the name
of the tagged file.
U or - - untag the file under the highlight bar. of course, this
will only affect a file already tagged.


Tagged files allow applying a command to several files at once. If you
want to erase several files having different names, you could tag them
and then erase all at once. The following commands can be used on tagged
files (^ before a command means to enter the command while holding down
the CTRL key):

^T - tags all files
^U - untags all files
^E - erases all tagged files
^M - moves all tagged files
^C - copies all tagged files
^A - changes the attributes of all tagged files to a specified
attribute.
^B - tags all files that have the archive bit turned on (for
subsequent copying by ^C)


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

NOTES


1) If you don't know what an archive bit is, I'll try to explain. DOS
maintains several bits (pieces) of information about each file on the
disk: size, name, location, etc. DOS also records whether the file
has been written to or modified since the last backup. It is the
responsibility of the backup program (the DOS Backup command, FAST
BACK, etc) to change this bit reflecting that the file has now been
backed up. This way, during your next backup, you can select to only
back up those files that have been modified since the previous backup.
FD does the same. If you use FD to copy files to floppy, FD will ask
whether you want to turn off the archive bit: Answer Yes if you are
using FD as your backup utility; Answer N if you use another backup
utility.

^B will tag for copying (as well as any other ^ command) all files
that have been modified since the last backup. (Thanks, CSR)

2) FD will prompt for additional disks if needed during a ^C copy when
a floppy drive is the destination. Unlike BACKUP, FD maintains a
DOS readable file format. So, if you are backing up a directory,
or many files from several directories, yet want to be able to read
any file individually from the floppies, ^C will prove very handy.



~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

PJU.exe integrates the individual Plain Jayne Utilties into one, command-line
utility. Plus, PJU adds Purge and Transfer to manipulate entire
sections of the directory tree.

PJU can:

Locate any/all files matching a pattern anywhere on the disk. This is
the same as LO.
Elim (erase) any/all files matching a pattern anywhere on the disk. The
same as ELIM.
Move any/all files matching a pattern from one directory to another.
The same as MOVE.
Transfer a directory and all its subdirectories/files to another
location on the disk.
Purge a directory and all its subdirectories/files from the disk.

For more information on an specific function, type:

PJU - /?

EX: PJU -L /? lists help on Locate
EX: PJU -M /? lists help on Move
EX: PJU -E /? lists help on Elim
EX: PJU -P /? lists help on Purge
EX: PJU -T /? lists help on Transfer

Each of the functions operates the same as the stand alones and are
not explained in detail here. However, because of the need to also
integrate the program options, one change has been made:

The C (or /C) option in ELIM no longer means NO confirm defore delete.
Q (for no Query) replaces the C option. This allows the C to select
'perform in current directory only' for all routines. Several users were
polled prior to this change and felt that it was justified for the sake of
consistency in all PJ Utilities. Besides, if you still enter option C
with ELIM, the only result will be to restrict the ELIM to the current
directory.


Syntax for PJU:

- /

Other than the '-', all other parameters are the same as for
the stand alone utilities. If PJU is used without parameters, it will
default to LOcate with *.* as a search.


Options: The following options may be used when following a / char.

P no pause when screen full. The default is to pause.
S short display - no size, date, time - when used with Locate
D DOWN from current dir only
C Current directory only
Q no Query before individual file deletes
X execute function regardless of destination file status.

Switches are ignored if they don't affect the selected function. The
following chart details which options influence which functions:

P S D C Q X
Locate Y Y Y Y
Move Y
Elim Y Y Y Y Y
Purge Y
Transfer none


One difference between PJU and LO: PJU, if typed alone on the command
line (at the DOS prompt) will default to searching for *.* in the current
directory only; LO would default to searching the entire disk.


PURGE will remove the specified directory and all included files and
subdirectories from the disk. In other words, everything form
that directory and down will be deleted.

Syntax for PURGE is: PJU -P /

A correct directory name must be specified


Purge will ask ONCE if you are sure.
There will NOT be a query before each individual file/directory purge.
When Purge begins, all subdirectories and files within the named directory
will be removed from the disk.
You may not remove the root (main) directory with Purge.
You can press ESC at any time to stop purge at THAT point.


ex: PJU -P c:\WS4 purges WS4 with all files and subdirs
ex: PJU -P ARC purges ARC with all files and subdirs


TRANSFER moves a directory and all contained directories (and files) to
another location on the disk.

Syntax for TRANSFER is: -T ');

You CAN transfer a directory to the root level.
You can NOT transfer the root (top) directory.
Transfer will not execute if the destination is the same as the
source or if a directory of the source name already exists
beneath the destination directory.
You can not transfer a directory beneath itself. For example, you
could not: -T C:\TP C:\TP\PAS
Correct directory names must be specified.

EX: pju -T \WS4 C:\WP (and \WP exists!)

where C:\WS4 contains: you will get:
C:\WS4 C:\WP\WS4
\WS4\LETTERS \WP\WS4\LETTERS
\WS4\PAPER \WP\WS4\PAPER
\WS4\PAPER\OLD \WP\WS4\PAPER\OLD



~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

VERSIONS

The most recent version of any Plain Jayne Utility can generally be found
on one of these fine boards. I try to mix the region and audience of the
boards to which I send initial releases.


The Running Board 301/229-5342 by Bonnie Anthony
CPCUG Software Exchange 301/949-8848 by Rich Schinnell
Virginia Connection 703/648-1841 by Tony McClenny
Turbo Source Search 617/545-9131 by Gerry Power
Turbo City 209/599-7435 by Gary and Pam Lagier



1.0 Initial release
1.01 9/10/88
TO FD added ^B
ESC to the commands list
prompt to turn off archive bit before copy to floppy
1.20 9/18/88
PJU.EXE added to the utilities (thanks for the idea CSR)
Fixed a display problem in FD.
Enhanced the ^C function in FD (increased error checking).
Q now means No Query before delete in ELIM (was C for no confirm).
The options C and D are enhanced: D now means down only;
C means current dir only. Together, down and current.
LO, ELIM, and MOVE (and the same functions in PJU) will now
recognize paths in the search filespec.
Added the X option to Elim and Move (as well as PJU).
1.21 fixed a Hercules display problem


WISH LIST

Add copy function to PJU.
Add screen to FD to set program parameters. (now individual screens)
Add disk sweep attribute changer to PJU.



~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


If there is a utility you need that is not presently available (or
economically available), contact us. I look forward to any suggestions
you may have.




If you use any of the above utilities and find any of them to your liking,
I ask that you register by sending the following:

1) Name
2) Address
3) Telephone number (optional)
4) Type of computer you are using
5) whatever monetary token you desire


TO: Plain Jayne Software
8408 Greenwood Avenue, #3
Takoma Park, MD 20912

301/585-7357 (evenings and weekends only)


If you do not intend to use any of these utilities, we also ask that
you write and tell us how they may be improved. In either event, please
pass PJ Utils along.