home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1994 #1
/
monster.zip
/
monster
/
UTILS2
/
WIZCAT1.ZIP
/
WIZDOC.EXE
/
WIZCAT.DOC
< prev
Wrap
Text File
|
1994-03-04
|
30KB
|
681 lines
WizCat For DOS
A D M S
Archive and Disk Management System
Version 1.0
Copyright 1994 By David Chamberlain
MegaSoft SoftWare (tm)
ALL RIGHTS RESERVED
INTRODUCTION
WizCat For DOS is a lightning fast Archive and Diskette Management System.
WizCat For DOS was designed out of the need to not only keep track of diskettes
containing archive files but to also manage those files. We needed to see what
was in them, what was duplicated in our library and at times read a file inside
the archives.
Through hard work and frustration we feel we have finally reached our goal in
making a fast, easy to use Archive Manager. WizCat For DOS not only catalogs
diskettes but is also capable of cataloging hard drives and CD-Roms, finding
and deleteing duplicates and reading files inside of an archive. WizCat For
DOS is packed with features that make tracking files as simple as a few
keystrokes. Below is the features you will find in WizCat For DOS. We know
that some users will want more from a diskette management system and we are
constantly updating WizCat For DOS with the request and input from users.
When WizCat For DOS first started it was a plain old fashioned disk catalog
program. Now, in it's reincarnated state, it is becoming a Disk Management
System that does more than just catalog disks. Users will not only be able to
keep track of their archives but also manage those archives from inside of
WizCat For DOS.
If you find a feature missing from WizCat For DOS or one that can be improved
please feel free to write us and tell us. We will consider all input and this
is the most important part of our job. TO GIVE THE END USER what they want
from our program.
Trademarks and Copyrights
WizCat For DOS is copyright 1994 by David R. Chamberlain and is protected by
the copyright laws of The United States Of America. MegaSoft SoftWare (tm) and
WizCat For DOS are trademarks of David R. Chamberlain in relation to software
and services rendered and written by David R. Chamberlain and his associates.
All other names herein referred to are trademarks or registered trademarks of
their respective owners and in no way is MegaSoft SoftWare associated with
them.
Warranty and Disclaimer
MegaSoft SoftWare makes no warranty expressed or implied as to the use or
inability to use this software for any particular purpose except that it runs
on our machine. MegaSoft SoftWare warrants that the disk sent directly from
them are readable and in the event that such a disk is not readable MegaSoft
SoftWare will replace the defective diskette with a new one in exchange for
the defective one.
MegaSoft SoftWare will not be held liable for damages, lost profits, lost
data, or lost time from the use or inability to use this software.
David R. Chamberlain shall also not be held liable for any of the above
mentioned items.
Shareware and WizCat For DOS
WizCat For DOS (tm) is marketed under the shareware concept. IT IS NOT FREE
SOFTWARE. MegaSoft SoftWare grants you, the end-user, the right to evaluate the
shareware version of WizCat For DOS for a period of 30 days. If after the 30
day period you continue to use WizCat For DOS you MUST pay the license fee set
out in the ORDER.FRM file found on this disk. If you purchased this disk from
a vendor the fee you paid them is for disk duplication and shipping only. We
do not see any of the money a vendor makes.
Registration encourages us to improve WizCat For DOS and to make new products
for use by users. We at MegaSoft SoftWare are currently working on WizCat For
Windows (Both NT and 3.x versions.) and your registration will entitle you
to discounts on these products.
Features
WizCat For DOS is packed with the following features. Often WizCat For DOS is
updated and new features are added. Users should check for and read the file
WHATSNEW.DOC when there is one present for changes to this documentation file.
Automatic Disk Reads
Mouse Support
Duplicate File and Volume detection and deletion
Printing to DISK or printer
Can catalog floppy/hard and CD-ROM drives
Searches using filename, category, soundex or size.
Wildcards for use during searches better than DOS's
Comments up to 180 characters long
Import of comments from BBS listing files
25 categories that can be changed to the users needs
Uses all available memory for the catalog file
DOS Protected Mode operation allows up to 16 megs of Extended memory for
catalogs.
Viewing of files inside archives.
Scanning of diskettes for virus strains
Cataloging of archive contents internally done. No need for the archive program.
Shell to DOS using as little as 6K freeing up more memory for your operations.
Can be run from inside Windows 3.1
Context sensitive help a key press away at all times.
Many more features are available in WizCat For DOS and are detailed in the
documentation.
Registering WizCat For DOS (tm)
Registration entitles the end-user to unlimited technical support, 1 free
upgrade to any major version of WizCat For DOS, a serial number that is usable
in any version of WizCat For DOS that will turn an unregistered copy into a
registered copy, the removal of the title screen and end screen displays at the
users discretion, WizConvert 1.0 (when released) that will allow you to import
and export catalog files from/to other formats and free copies of our other
shareware products. We are also working on WizFix which will fix corrupted
WizCat catalog files and all registered users will be sent a copy when beta
testing is complete, and a printed/bound user manual.
NOTE: This user manual is intentionally brief and missing information. The
reason for this is that we are currently updating functions and improving
them and that the person assigned to write this documentation failed to do
so in a timely manner which resulted in us having to throw something together.
The documentation you receive will be more complete but still the 1.5 versions
documents will be the 1st completed one. If you do not want this printed
documentation deduct $5.00 dollars from the registration price.
See the ORDER.FRM file for current pricing and any additional benefits added
after this documentation was written.
System Requirements:
WizCat For DOS requires the following configuration to run.
An IBM XT/AT computer or 100% compatible running DOS 3.1 or above
640K RAM
A display adapter capable of displaying 25 Rows by 80 Columns
1 Floppy drive and a hard disk with at least 2 megabytes of free disk space
For the DOS Protected Mode Interface module you need 2 megs of EXTENDED (NOT
EXPANDED) free memory and a 286 or above processor.
A mouse is supported but not required.
A disk caching program can greatly increase the performance of WizCat For DOS
Getting Started
Installation:
Depending on the disk set you received you should have at a minimum of 1
high-density disk. If you are using a 360K disk system then there are 2 disks,
the same is true for a 720K system.
Place the disk labeled WizCat For DOS DISK 1 in to your drive and type the drive
letter corresponding to that drive followed by the Enter key. Once your machine
has changed to that drive type INSTALL and press Enter.
The install program will prompt you for the drive and directory that you want
to install to providing the default of C:\WIZCAT. Type the drive and directory
where you want the files placed and then press enter. To accept the defaults
just press enter. WizCat For DOS will then begin by asking what files you want
installed. Answer yes or no to each of the prompts.
Once the install program is complete you will be given the option to change to
the drive and directory where you placed the files, chose yes and when the DOS
prompt returns type WIZCAT and press enter.
Once WizCat For DOS is running you will be displayed a title screen, press
enter and WizCat will display the 1st of its menus. The Read Catalog menu is
where you should type in the name of a catalog or you can press enter to
accept the default name WIZNEW.WCC if the file does not exist it will be
created but if you exit WizCat For DOS before saving the file it will not
exist the next time you start WizCat For DOS BE SURE TO SAVE YOUR DATA FILE
each time WizCat ask if you want to save it.
If this is your first time using WizCat For DOS you should proceed to the
Set-Defaults Menu from the Main Menu and configure WizCat For DOS to your
liking. See the command reference for configuration information. After you are
done setting the defaults chose Write to save your configuration information
to the executable. Press the Escape key (ESC) to return to the top level menu.
Note: The ESCAPE key is used to back out of nested menu's and to quit WizCat
For DOS. When you are in a sub menu it takes you to the menu above it when you
are at the READ CATALOG menu it will exit the program.
Once you have returned to the Main-Menu you can either Quit WizCat For DOS or
you can proceed to Update your catalog file by pressing U for Update or
selecting it with the mouse.
Updating the catalog is dependant upon your preferences, you can turn off
duplicate checking, select the drive you want to read, scan disks for virus
strains, use automatic updating for diskette reads, turn on/off the cataloging
of files inside archives and more.
To begin select the method you want from your choices on the menu (See the
command reference section below) and place the diskette into your drive. If
you are using Automatic Updating you do not need to press enter. If you are not
using the automatic option then press enter to read the disk. Repeat for each
diskette you want to read.
When you are finished updating your catalog use the ESCAPE key to return to the
main menu and then press W for Write catalog. After this you can begin viewing
your catalog (View catalog) checking for duplicates (Find duplicates) deleting
volumes and exiting the catalog.
This is a simple summary of the functions required to get started. WizCat For
DOS features many more options for individual users. Below is a complete Menu
Command reference for your use. If you have other questions about using WizCat
For DOS you can write or call us. Information is given at the end of this
documentation under the heading Reaching Technical Support. Please feel free
to contact us if there are features you do not understand, questions about
features, or enhancements you would like to see added to WizCat For DOS.
Command Reference
Read Catalog :
The Read Catalog menu allows the user to read the displayed filename, type in
another filename or do a DIR listing for choosing a catalog name.
Commands on menu
Accept : Accepts the displayed or typed filename.
DIR : Brings up a dialog box with all files and directories in the
current one. You can use the arrow keys or mouse to navigate
this box and make a selection of a file to read. The file read
must be a valid WizCat For DOS catalog file or an error will
result.
Main Menu :
The Main Menu contains the commands for the functions a user can do with WizCat
For DOS. Each of the commands on the Main Menu takes the user to a sub menu.
The sub-menus are described individually under the heading of their names.
The Main Menu contains the following commands:
V>iew : This menu takes the user to the Command Menu. From the a user can view
the contents of a catalog, view contents of archives, print a list of
files in the catalog and more.
U>pdate : This command takes the user to the Update Catalog menu. From there
a user can add disks, hard drives, and CD-ROMS disk to the catalog.
This and the Command Menu are the main areas of WizCat For DOS.
D>elete-volumes : This command takes the user to a new display. The display
contains the volume names of your catalog. A volume is not
a file. It's the label on a disk or diskette that DOS or
the programmer wrote to the disk.
This command will allow the user to remove the entire
volume from the catalog. When you do this the volume and
every file that was on that volume will be removed from the
catalog file. Please keep this in mind before you use this
command.
S>et-defaults : This command takes the user to the Configuration Menu. From
that menu the user can set such things as color, preferences,
utility names and paths, and what default catalog name you
want. There is also a command for entering your serial number
when you register or are a registered user wanting to turn an
unregistered copy of WizCat For DOS into a registered copy.
F>ind-duplicates : The find-duplicates command locates all duplicate name
names in your catalog and then takes you to the Command
Menu so you can perform any of the functions you want. The
main thing most users will want to do is to delete those
duplicate entries and possibly the file from disk. You can
do that with this command.
R>ead : Returns the user to the Read Catalog menu for reading of another
catalog file.
W>rite : Writes the current loaded catalog to disk.
<ESC> : This command as always backs the user to the previous menu. If there
is no previous menu (the user is at the Read Catalog menu) then the
user is given the choice of exiting WizCat For DOS. If your catalog
has been changed and not saved since the changes you will be given
the option to save it before exiting.
Command Menu :
For most users this and the Update Catlog is where they will spend most of
their time in WizCat For DOS. Some of the menus on the command menu takes the
user to a submenu, in these case the commands for the submenu are described
directly below it.
Up arrow and Down Arrow Commands : These allow the user to navigate the
catalog list one file up or down at a time.
PgUp/PgDn : This represents the Page-Up and Page Down keys and allows the
user to navigate the catalog list 13 files at a time either up or down.
D>ir : If the user is using the add-contents of archive option and the high-
lighted file is an archive then this command will show what files are inside
that archive. If the user is viewing volumes then this command will show what
files are on that disk.
V>olumes : Will display only volume labels for your catalog.
C>omments : Takes the user to the comment edit menu the commands available on
this menu are :
Edit - Places the user in a single-line editor
for adding or editing a comment.
< - comment from buffer. Takes any comment that
was placed in the buffer and places it in
the current files comment field.
> - comment to buffer. Copies the current files
comment to a buffer so you can place it on
other files.
Delete - Deletes the current comment from the
file.
Import - Imports a comment from a BBS listing
file. Please refer to the discussion
about the BBS listing file under
Set-Defaults. If the filename is not
found in the BBS listing file nothing
will be placed in the comment field.
Quit - Exits the comment editor.
Note: When using the comment editor the comment applies only to the first
file you place the comment on. To place a comment on another file
you must exit the comment editor before using the up arrow or down
arrow keys and then re-enter the comment editor.
F>ind : Allows the user to find a file based on different critia. You can
find on filenames, comments, size (Size means freespace on a disk
at this time.), soundex (sounds like), and categories.
N>ext : Finds the next file matching the critia in the last find command.
S>ort : You can sort on filename, extensions, path, date, size, disk number,
or category. Sorts can be ascending or descending.
E>dit : This command allows the user to change the category for the set file.
P>rint : Allows the user to print to the printer, a disk file or abort the
printer command. If you choose disk file the file is in ASCII.
<SPACE> : Use only when you have cataloged files inside the archive. This
command will allow you to read a file inside the archive.
HOME : Takes you to the top of the catalog list.
END : Takes you to the bottom of the list.
O-sys : Invokes the DOS shell. When in the DOS shell the prompt is changed
to show you that you are in a DOS shell by displaying [WIZCAT] above
your current prompt.
K>ill : Kills the file and the list entry from disk.
L>imit : Limits the display of filenames to that of the current ones
catagory.
R>emove : Removes the entry from the list. This is not like kill which also
prompts for the disk so it can delete it.
I>nfo : This command shuts off or turns on the information window.
vieW> : This allows you to view the contents inside of an archive. That is
the filenames and sizes. It is like using a view command for an
archive.
<ESC> : Takes you to the previous menu.
Update Catalog :
From this menu the user will do all the disk adding, virus scanning and
selection of catagories.
A>ccept : Manually adds the displayed disk to the catalog.
Up Arrow and Down Arrow keys : Increments and Decrements the drive letter
to read from.
D>irectory : Allows you to supply a pathname for the update. WizCat For
DOS will read only the files and sub-directories beneath it
as the contents of the volume.
L>abel : Allows you to change or add a label to a disk.
P>review : This command allows you to see what files will be added to
the catalog. You must then choose accept to add them to the
catalog.
S>can : Will invoke the virus scanner to check for virus strains.
auto-U>pdate : Starts reading diskettes from the selected drive until you
press the ESCAPE key.
Note: You can only select drive A: and drive B: at this time for
an auto update. This is being changed in version 2.0 to
allow for CD-Roms and other removable media.
The remaining commands on this menu apply to configuration options. They
are not discussed at this time because they are changing in the 1.5 update
that will be released in about 4 months.
DPMI Usage reference:
This section documents the use of RTM.EXE, RTMRES.EXE, DPMI16BI.OVL,
DPMIINST.EXE and DPMILOAD.EXE
Included in this section is a discussion of:
Running a DOS Protected-Mode Program
What to do if Borland's DPMI server does not run on your
system
How to set DOS environment variables that affect WizCat For DOS protected-mode
o Special notes for running under Windows
o Controlling the amount of memory the run-time manager uses
================================================================
Running a DOS Protected-Mode Program
================================================================
When you run a DOS protected-mode application, you must ensure
that DPMI16BI.OVL (the DPMI server), RTM.EXE (the run-time
manager), and any DLLs used by the application are present in the
current directory, the same directory as the application, or on
the DOS path.
Protected Mode and Memory
-------------------------
A DOS protected-mode program uses DPMI (DOS Protected Mode
Interface) to run in protected mode which gives the application
access to all your computer's memory. With the exceptions
outlined below, the DOS protected-mode technology is completely
transparent and no extra steps are necessary in order to run a
protected-mode application.
DPMIINST
One such exception might be when you run a protected-mode program
for the very first time on a 286-based system. The protected mode
technology uses an internal database which contains various
machine characteristics to determine how to enable protected mode
operation on your system, and configures itself accordingly. If
you have a computer with an older 80286 microprocessor, your
system might not be recognized. You'll see this message when you
try to run a protected-mode application:
Machine not in database (RUN DPMIINST)
If you get this message, simply run the DPMIINST program by
typing DPMIINST at the DOS prompt and following the program's
instructions.
DPMIINST runs your machine through a series of tests to determine
the best way of enabling protected mode, and automatically
configures accordingly. Once you have run DPMIINST, you won't
have to run it again.
Some memory managers, device drivers, and memory-resident (TSR)
programs can interfere with DPMIINST's ability to analyze your
system. If DPMIINST fails, try temporarily disabling or removing
these programs. That gives DPMIINST the unrestricted access it
needs to determine the best way to enter protected mode.
Note that running DPMIINST.EXE will never be required on any
system running HIMEM (or equivalent) or on any system based on
an 80386 (or later) processor.
DPMIMEM
By default, the DPMI interface allocates all available extended
memory for its own use. If you don't want all of the available
memory to be taken by the DPMI kernel, you can set a DOS
environment variable to specify the maximum amount of memory to
use. This variable can be entered directly at the DOS prompt or
inserted in your AUTOEXEC.BAT file, using this syntax:
SET DPMIMEM=MAXMEM nnnn
where nnnn is the amount of memory in kilobytes.
For example, if you have a system with 4MB and want the DPMI
kernel to use only 2MB of it, leaving the other 2MB alone, the
DPMIMEM variable would be set as follows:
SET DPMIMEM=MAXMEM 2048
Some memory managers, like QEMM or 386^Max, allow allocating the
same area of memory as either extended or expanded and many older
applications can use only expanded memmory (EMS). By using the
DPMIMEM DOS environment variable to limit the amount of extended
memory used by the DPMI server, your system will still have
expanded memory available for use by older applications.
RTMRES
RTMRES preloads the protected-mode system. Preloading the DPMI
server lets you load a protected-mode program slightly faster.
RTMRES will start a program if you specify a program name as a
parameter. If no parameter is specified, RTMRES will run a DOS
shell. Type EXIT to close the shell.
RTMRES is especially useful if you start, exit, and start a
protected-mode program frequently. Normally, every time you run a
protected-mode application, the DPMI server is loaded. If you've
run RTMRES previously, the server is already present, and the
protected-mode application loads faster.
EXTENDED MEMORY
A protected-mode application interacts with the DPMI server
through Borland's run-time manager (RTM.EXE). By default, a
protected-mode application uses all the extended memory reserved
by the DPMI kernel.
================================================================
Running A DOS Protected-Mode Program from Windows
================================================================
A DOS protected-mode program will run in Windows in 386 enhanced
mode. To configure the amount of memory available to the
application, create a Windows PIF file. To learn more about PIF
files, see your Microsoft Windows User's Guide.
Running Your Program in Windows Standard Mode
---------------------------------------------
In order to run a protected-mode program from Windows
standard-mode, you must set the DPMIMEM DOS environment variable
and run RTMRES (both are described above) before running Windows.
Make sure your DPMIMEM setting leaves enough physical memory for
Windows to operate.
Note that once you've run RTMRES, you won't be able to run
Windows in 386 enhanced mode until you exit the RTMRES shell (by
typing EXIT at a DOS prompt).
Running from a Windows DOS Prompt
---------------------------------
To run a DOS protected-mode application from a Windows DOS
prompt, you must first modify the DOSPRMPT.PIF file found in your
Windows directory so that the protected-mode program will be able
to use extended memory.
Using the Windows PIF editor, open the DOSPRMPT.PIF file, and
indicate the amount of extended memory you want the
protected-mode program to use. If you are unsure how to use the
PIF editor, see your Microsoft Windows User's Guide.
================================================================
Controlling the Amount of Memory the Run-Time Manager Uses
================================================================
The run-time manager attempts to free as much conventional memory
as possible (by moving moveable memory blocks into extended
memory, for example) before starting an application. No attempt
is made to release extended memory, however. Therefore, if you
are going to run other protected-mode applications that don't use
the run-time manager (Paradox 4.0, for example), use the RTM DOS
environment variable to control the run-time manager's allocation
of memory.
Use the DOS command line to add the RTM environment variable to
your system's DOS environment. Here is the syntax:
SET RTM=[option nnnn]
The following table lists the options you can use. nnnn can be a
decimal number or a hex number in the form of xAB54 or xab54.
Option Description
-------------------------------------------------------------
EXTLEAVE nnnn Always leave at least nnnn kilobytes of
extended memory available. The default value
is 640K.
EXTMAX nnnn Don't allocate more than nnnn kilobytes of
extended memory. The default value is 4
gigabytes. In Windows, the default value is
one-half the available memory.
EXTMIN nnnn If fewer than nnnn kilobytes are available
after applying EXTMAX and EXTLEAVE limits,
terminate with an Out of Memory message. The
default value is zero.
REALLEAVE nnnn Always leave at least nnnn paragraphs of real
memory available. The default value is 64K or
4096 paragraphs.
REALMAX nnnn Don't allocate more than nnnn paragraphs of
real memory. The default value is 1 megabyte
or 65,535 paragraphs.
REALMIN nnnn If fewer than nnnn paragraphs are available
after applying REALMAX and REALLEAVE, terminate
with an Out of Memory message. The default
value is zero.
The following DOS command limits RTM to 2M bytes of extended
memory, and ensures that 128K bytes of real memory are left
unallocated:
SET RTM=EXTMAX 2048 REALLEAVE 8192
================================================================
Important Note for Borland C++ and Paradox 4.0 Users
================================================================
The DPMILOAD.EXE and DPMI16BI.OVL files provided in this package
replace the older ones that came with Paradox 4.0 and BC++ 3.0 or
later. Delete or rename the older versions and make sure the
newer ones are on your DOS path (both Paradox and BC will search
the path and find the newer versions).
If you plan to shell out from Paradox or BC++ to run another
protected-mode application, first limit the amount of extended
memory used by Paradox or BC++. For Paradox, use its /extk
command-line parameter; and for BC++, use its /x command-line
parameter. Refer to the Paradox or BC++ documentation for more
information on the use of command-line options.
Reaching Technical Support and MegaSoft SoftWare
You can reach TECH Support between 8 AM and 12 PM Monday thru Friday
at (503) 278-2416 We do support non registered users for a period of
10 days from their 1st call. After this you must be a registered user
to receive any additional support.
Write to us or call the same number for any other concerns or questions about
WizCat For DOS
MegaSoft SoftWare
2911 NE Riverside #16
Pendelton OR 97801-3446
Please ask for David Chamberlain when calling and that it is in reference to
WizCat For DOS. This allows us to give fast answers to your problems or
questions.
If you are a registered user please have your serial number handy.