CAT.COM
-
DIRECTORY MAINTENANCE FACILITIES
CONTENTS
Overview . . . . . . . . . . . . . . . . . . . . . . . . 1
Using CAT. . . . . . . . . . . . . . . . . . . . . . . . 2
Invoking CAT . . . . . . . . . . . . . . . . . . . . . . 2
Background . . . . . . . . . . . . . . . . . . . . . . 2
Screen Format. . . . . . . . . . . . . . . . . . . . 3
Manipulating the Display . . . . . . . . . . . . . . 4
Program Function Keys. . . . . . . . . . . . . . . . 5
Internal CAT Functions . . . . . . . . . . . . . . . 6
Using the Command area . . . . . . . . . . . . . . . 6
CAT.COM
-
DIRECTORY MAINTENANCE FACILITIES
OVERVIEW
This document provides information about CAT
Personal Computer. We hope the program fills
needs as it did ours.
After all, that is
developed this integrated package. The better
work with the better the end result.
for use on the IBM
as many of your
the reason we have
tools you have to
It provides a full screen list of a file set specified by the
user. These may be presented in an unsorted, name, extension,
date, or size order, and the sorted order of presentation may be
changed dynamically. Within each entry is displayed an area to
allow the entry of commands. This command area may be used to
issue commands which pertain to the files displayed.
These
commands are entered in the command areas adjacent to the files
they are to affect. Helpful facilities are provided to lessen
the typing required. One example is the use of the "=" internal
command to repeat the last command. To provide additional ease
of use, the editing keys and function keys may be used to page
through the list and add or delete commands.
When all desired commands have been entered, the user enters exec
execution mode to pass the commands entered in display mode to
the PCDOS command environment. The commands are passed to the
command environment for execution one after the other, befinning
with the command closest to the top of the list and continuing
toward the end of the list until all commands have been returned
or an internal function is encountered. If no internal command
is encountered, the DOS prompt appears, with a full block cursor.
Entry of a null command (i.e. return) will redisplay the the
file list. Any other entry will be immediately executed by DOS.
The DOS prompt is displayed to allow you to view any messages
which were put on the display by the executed commands.
The program becomes a resident extension of DOS in core. It
occupies approximately 7k bytes of stroage.
This
storage
includes the necessary resident code and table space for an
unlimited amount of entries. Cat will remain active in core until
the system is rebooted.
BACKGROUND:
CAT is invoked from the DOS command environment by issuing the
command: A>cat
(refer to figure 1)
CAT.COM
-
DIRECTORY MAINTENANCE FACILITIES
If the filespec is omitted, all files on the current default disk
will be listed. If CAT is used on the IBM PC/XT only those files
within the current directory are listed. If you specify /sn then
the files will be listed in alphabetical order of the filename.
If you specify /se then the files will be listed in alphabetical
order of the filename extension. If you specify /sd then the
files will be listed in date sequence. The very first will be
the most recent entry and the last file in the listing will be
the oldest file entered. If you specify /ss the files will be
listed by size.
The largest file first contiuning to the
smallest file.
ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º
º
º CAT < fspec > < /sn | /se | /sd | /ss | < /? >
º
º
º
º other available options are described on the intial screen
º
º
º
º If no parameter is specified the files will be listed by dateº
º
º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
SCREEN FORMAT:
The displayed format consists fo three distinct areas. The first
line is a status line. The dirst two characters are the DOS
prompt currently active. The balance of the line gives the size
of the allocation unit, the allocation units used and the
allocation units free (as well as the percentage of free
allocation units) on the listed diskette plus the number of the
first displayed entry as well as the count of active (displayed)
entries.
The next 23 lines contain displayed entries for listed files.
The first portion gives the filespec for the listed file.
The
next 25 postions are a command area. The balance of the line
contains the attribute indicators, the size of the file in
decimal bytes, the number of allocation units occupied by the
file, followed by the date and time the file was last updated.
The last line of the screen displays the function key settings.
CAT.COM
-
DIRECTORY MAINTENANCE FACILITIES
Manipulating the display.
Once the list is displayed, the editing keys on the keyboard may
be used to manipulate the screen. The semantics for the key
useage follow those used for the BASIC editor. They are:
PgUp move the display to show entries nearer the beginning of
the entry sequence.
Ctrl-PgUp move the display to show
in the entry sequence.
PgDn
move the display to
entry sequence.
show
the
first screen of entries
entries nearer the end of the
Ctrl-PgDn move the display to show
in the entry sequence.
the last screen of entries
Home
position the cursor to the first postion of the command
area on the first entry displayed on the screen.
End
position the cursor at the last character in the command
field on the line containing the cursor.
Ctrl-End erase the command area from the cursor to the end of the
field.
Ins
toggle insert mode. When in insert mode, a full block
cursor is displayed.
Del
delete the character at the cursor.
Cursor keys move the cursor in the directions depicted by the
arrows. If the cursor movement is up or down and the
movement would
result in moving onto the first or last
line of the screen and thefile is not already positioned
with the first or last entry on the top or bottom line,
the screen will be scrolle up or down.
Enter
positions
the
cursor
to
the
beginning
of
the next
command area. If appropriate, the screen will be scrolled as described below in the entry for Tab.
backspace deletes the character to the left of the cursor.
Tab
skips to the first position of the next command area
unless the skip is off the last entry displayed. In this
case, scrolling occurs as for down cursor unless prohibited by file position. In this case, wrap to first
displayed command area occurs.
CAT.COM
-
DIRECTORY MAINTENANCE FACILITIES
Shift-Tab skips backward to the beginning of the previous command
field. If the cursor is not in the first position of
the command area, this key will position to the first
position of the current command area. If the skip is
off the first entry displayed, scrolling occurs as for
up cursor unless prohibited by file position. In this
case, wrap to last displayed command area occurs.
ESC
clear the command area to blanks then position the cursor
to the first position of the command area on the current
entry.
Ctrl-Return enter the execution mode.
[CR]
While in execution mode a block cursor will be displayed along
with the DOS prompt, CAT remains active in core and can be
recalled simply be depressing [CR].
CAT will display the
previous entries from your previous session. Simply depress [F1]
to refresh and update the current display.
Program Function Keys
The functions provided on the PF keys are displayed on the 25th
line of the display. The assignment is similar to the BASIC
softkeys, with the function key placing the assigned character
string on the command line at the first position, then entering
execution mode. The function key assignments are as following:
[F1] SUBMIT-update display with all entries in current directory.
[F2] XCLUDE-exclude entry where cursor is positioned until the
display is re-SUBMIT-ed.
[F3] READ=C-read and display entries from drive C: in current dir
[F4] READ=A-read and display entries form the floppy diskette.
[F5] SRTNAM-sort(ascending) on name and update display.
[F6] SRTEXT-sort(ascending) on extension and update display.
[F7]
[F8]
[F9]
[F0]
SRTDTE-sort on date(most recent displayed first) and update.
SRTSIZ-sort on size(largest displayed first) and update.
EDIT -executes IBM professional editor.*
SCAN -executes SCAN.COM(allows you to browse your text or
programs, no changes allowed just checking activity)
Once in SCAN you may end the session by depressing
the [ESC].
CAT.COM
-
DIRECTORY MAINTENANCE FACILITIES
*-Send us your copy of CAT along with a check for $10.00 to cover
postage and handling and we will change the PF key setting to
execute your preferred editor.e.g.-WS(wordstar),VW(volkswriter)
EDLIN(editor on DOS diskette) or your personal preference.
Make
sure to include a note stating your requirements.
Using the Command area:
The input areas after the fileids may be used to enter any
command as in the normal DOS environment.
If not otherwise
directed, CAT will append the complete filespec associated with
the command area at the end of the command line. If the command
is preceded by the /O internal command, no appending will occur
and the command will be passed to the command environment without
further processing.
The /n internal command will allow you to
execute the current filespec. As noted earlier the "=" will
allow you to repeat your command without having to retype it. To
copy a particular file to the A:drive use the following format
on the command line: COPY / A:-this will copy the file to drive
A. The "/" causes cat to insert the filespec located on the same
line as you are entering the command. If you need to sort on
particular filenames then enter the following: /r *.mem
Then press the [Ctrl] and [CR]. The block cursor will show along
with the DOS prompt, just press [CR] for your requested list.
Additional commands which may prove to be very valuable are HIDE,
EXPOSE and PROTECT. Type the command HIDE on the line of a
filespec you wish to conceal from prying eyes. Then depress
[Ctrl]-[CR] to hide the file from most normal directory searches.
Press [CR] to return to the CAT display and press [F1] to update
the display. You will notice the capital H displayed on line of
the filespec you specified to hide. Use the command EXPOSE to
reveal the hidden file.
PROTECT will protect a file from
accidental erasure. Use the EXPOSE command to authorize erasure.
IF YOU ARE USING THIS PROGRAM AND FIND IT OF VALUE, YOUR
CONTRIBUTION ($35 SUGGESTED) WILL BE APPRECIATED !
STEVE O'KANE
4306 DIEHL WAY
PITTSBURG, CA. 94565
415-544-6204
4303 ALCOSTA PLACE
PITTSBURG, CA. 94565
415-544-6204
4303 ALCOSTA PLACE
OR
RON SIMMONS
4303 ALCOSTA PLACE
PITTSBURG, CA 94565
415-427-4381
PITTSBURG, CA 94565
415-427-4381