home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1994 #1
/
monster.zip
/
monster
/
RA
/
GETDIZ13.ZIP
/
GET-DIZ.DOC
< prev
next >
Wrap
Text File
|
1994-02-07
|
19KB
|
338 lines
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ GET-DIZ v1.3 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
Puts FILE_ID.DIZ descriptions in RA 2.01's FDB
Written by Mike Ehlert
Copyright 1992,93,94 All Rights Reserved
Mike Ehlert
PACIFIC COAST MICRO
1879 Campbell Ave.
Thousand Oaks, CA. 91360 USA
A North American RemoteAccess Support Site
(805) 494-8327 / (805) 494-8427 / (805) 494-9386
FidoNet: 1:102/1001 and 1:102/1005
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ What can this do ? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
GET-DIZ is an add-on utility for the RemoteAccess 2.01 File Manager.
It allows you to quickly scan some or all files in the current area
for FILE_ID.DIZ or DESC.SDN file descriptions, and each time one is
found it puts that description into RA's FDB (file data base) even
if a differnt description already existed there. It's only 1.5k in
size, making it the smallest RA utility ever developed!
DIZ stands for "Description In Zip", and FILE_ID.DIZ descriptions
were originally use by PCBoard BBS Software. DESC.SDI is a similar
description file used by the Software Distribution Network.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Whats new in version 1.3? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
*** NEW COMMAND LINE PARAMETERS! *** Be sure to read the docs if you
are upgrading from a previous version!!!
This version has been optimized for fastest speed and smallest size.
Archive comments are no longer displayed while processing files.
You can process just the file at the cursor instead of having to
process all the files below there as well. Ctrl-Z (EOF) characters
at the end of the DIZ file are now removed from the FDB description.
You can specify any archiver on the command line now, as well as any
brand of keyboard stuffer. This version is Beerware, an almost free
form of shareware.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Whats new in version 1.2? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
This version is now 4DOS compatible! I had to actually install 4DOS
on my system to figure out why it was not working, and I fixed it.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Whats new in version 1.1? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
This version has support for PolyXarc, to support *any* archive type.
(Thanks to David Gibbs of the Midrange System for the suggestion.)
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Required Programs ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
GET-DIZ.COM is not a stand alone program, and requires the following
other programs to properly run:
RAMGR.EXE (RA Manager which comes with RA 2.01)
KIS.EXE (Keyboard Input Simulator by R. van Hoven)
PKUNZIP.EXE (Pkunzip by PKware)
ARJ.EXE (Arj by Robert K Jung)
POLYXARC.EXE *Optional* GET-DIZ can use this shell which is a slower
method but handles all archive types.
(PolyXarc by Jeffrey Nonken).
RAMGR is required since this is an add-on for it which is designed
to be only called from RAMGR.EXE directly.
The reason that KIS is needed is to stuff keys into the keyboard
buffer before returning to RAMGR, to force RAMGR to perform the FDB
updates and to force GET-DIZ to be called again for the next file(s).
You can freq. or download the latest KIS from any DISP support site
(the FileDoor dudes), or from me. The current version is KIS_V101.ZIP
which is only 15k in size. KIS is postcardware (a form of shareware).
PolyXarc is only needed if you want to process multiple archive types.
I recomend you convert all your archives to ZIP or ARJ before you
use GET-DIZ, so that PollyXarc is not needed. PolyXarc is a freeware
universal archiver which handles ZIP, ARJ, LZH PAK, DWC, ZOO, etc.
You can freq. or download the latest PolyXarc from me, or use any
simular utility instead. I currently have version 2.1A for DOS, the
filename is PXDOS21A.ZIP (37k).
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Upgrading from a previous version ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
If you are upgrading from an older version of GET-DIZ, then be sure
to delete your old GET-DIZ*.COM files, as they are no longer needed.
The new GET-DIZ.COM replaces the 3 older files with simular names.
You must also enter a a new command line in RACONFIG as illustrated
below.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Installing ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
You must have the %RA% Environment varable set (SET RA=C:\RA).
***NOTICE!!!*** Do *NOT* have a trailing backslash on the %RA%
environment variable or GET-DIZ will not work!
Run RACONFIG > OPTIONS > FILES > RAMGR-FNKEYS
You will see a box of 5 sysop definable options, most of them are
probally blank:
╒══════════════════════════════╡ RAMGR ALT-function key manager ╞╕
│ │
│ 1 C:\shez\shez.exe @ *M │
│ 2 │
│ 3 │
│ 4 │
│ 5 │
│ │
╘══════════════════════════════════════════════════════════════════╛
In the above example, only ALT-F1 is defined, which will cause RAMGR
to pass the filename currently under the cursor to SHEZ, which is an
archive viewer. The @ is replaced by RAMGR with the actual path and
name of the current file. The *M tells RAMGR to swap out of memory
before shelling to the defined program.
GET-DIZ can be installed here in many ways, both in Recursive and
Non-Recursive modes, as illustrated in the following examples:
*********************************************************************
To install GET-DIZ just for ZIP files, enter lines 2 and 3 like this:
╒══════════════════════════════╡ RAMGR ALT-function key manager ╞╕
│ │
│ 1 c:\shez\shez.exe @ *M │
│ 2 c:\ra\get-diz.com c:\utils\kis c:\utils\pkunzip -o @ │
│ 3 c:\ra\get-diz.com c:\utils\kis c:\utils\pkunzip -o @ 1 │
│ │ │ │ │
│ │ │ │ │
Path\filename of KIS─┘ │ │ │ │
Path\filename of Unarchiver───────┘ │ │ │
Unarchiver extract command────────────────────────┘ │ │
Converted to Path\filename of current file by RAMGR──┘ │
A "1" here will disable the recursive mode─────────────┘
*********************************************************************
To install GET-DIZ just for ARJ files, enter lines 2 and 3 like this:
╒══════════════════════════════╡ RAMGR ALT-function key manager ╞╕
│ │
│ 1 c:\shez\shez.exe @ *M │
│ 2 c:\ra\get-diz.com c:\utils\kis c:\utils\arj e @ │
│ 3 c:\ra\get-diz.com c:\utils\kis c:\utils\arj e @ 1 │
│ │ │ │ │
│ │ │ │ │
Path\filename of KIS─┘ │ │ │ │
Path\filename of Unarchiver───────┘ │ │ │
Unarchiver extract command──────────────────────┘ │ │
Converted to Path\filename of current file by RAMGR┘ │
A "1" here will disable the recursive mode───────────┘
********************************************************************
Or you can install GET-DIZ with universal archive support like this:
╒══════════════════════════════╡ RAMGR ALT-function key manager ╞╕
│ │
│ 1 c:\shez\shez.exe @ *M │
│ 2 c:\ra\get-diz.com c:\utils\kis c:\utils\polyxarc -o @ │
│ 3 c:\ra\get-diz.com c:\utils\kis c:\utils\polyxarc -o @ 1 │
│ │ │ │ │
│ │ │ │ │
Path\filename of KIS─┘ │ │ │ │
Path\filename of Unarchiver───────┘ │ │ │
Unarchiver extract command─────────────────────────┘ │ │
Converted to Path\filename of current file by RAMGR───┘ │
A "1" here will disable the recursive mode──────────────┘
Notice that in order to use the RECURSIVE mode, GET-DIZ *MUST* be
installed in slot #2 (Alt-F2 key), and line 2 may *NOT* have a "1"
at the end. > ANY POSITION OTHER THEN 2 WILL NOT BE RECURSIVE!. <
+++++++++++++++++++++++++++++++++++++++++++++++++
The reason for this is because GET-DIZ stuffs an ALT-F2 into the
keyboard buffer in order to force RAMGR to call it again after it
has moved the cursor down to the next file.
It is NOT required to specify the entire path to KIS or to your
Unarchiver, but GET-DIZ will run faster if you do. If you don't
specify these paths, then they must be located in the DOS %PATH%.
It is NOT required to use the *M command to swap out of memory
before running GET-DIZ, and it's faster if you do not. However
if your system is running in a very small window then you might
have to add the *M to the end of the command lines.
Pkunzip and PolyXarc don't actually need an extract command like
ARJ needs "e", so the "-o" is used just as a filler parameter.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Usage ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
Once it's installed, run "RAMGR -F" and select a file area to use.
You can optionally press Alt-D to change the display mode first.
To use GET-DIZ in Recursive mode, move the cursor to the first file
which you wish to process. Press Alt-F2 to begin, and RAMGR will call
GET-DIZ once for each file from there, all the way down to the last
file in the current area. So to process an entire area, simply start
the cursor at the first file (at the top) and press Alt-F2. If you
wish to abort the process before it has finished, simply press
Ctrl-Break twice.
To use GET-DIZ in Non-Recursive mode, move the cursor to the one file
you wish to process. Press Alt-F3 and only that one file is processed.
While its running, PKZIP or ARJ may display "File-Not-Found" messages,
which just means that the tested archive did not contain any
descriptions files. This is normal.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ DesqView Limitations ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
GET-DIZ runs perfectly under Desqview, but KIS 1.01 has a limitation:
You can not switch windows while GET-DIZ is running, or elce KIS will
stuff the keyboard buffer into the new current window.
If you don't like this limitation, there are three things you can do:
1. Ask the KIS author to make KIS more compatible with DV.
2. Write your own Keyboard Input Simulator to use instead.
3. Or delete this package and forget you ever saw it. :-)
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Trouble Shooting ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
If you could not get GET-DIZ to work, here's some things to check:
Do *not* have a trailing bakcslash on your %RA% Environment variable.
Do *not* install it as RECURSIVE in any slot other then #2 in RACONFIG.
Check that your paths and filenames are entered correctly.
If all elce fails drink another beer, wait 5 minutes, and try again.
:-) Or give me a netmail and I'll try to help you if I'm sober enough.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Disclaimer ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
GET-DIZ was tested, and worked flawlessly on my system (Running 3
nodes under RA-Pro 2.01 and Desqview). But it comes with NO Warranty.
Use it at your own risk!
In no event shall Mike Ehlert or PACIFIC COAST MICRO be liable for
any damages caused by GET-DIZ. The software is supplied as-is.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Registering ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
GET-DIZ is supplyed as Beerware, (a form of shareware). Feel free to
share it with your freinds, but do not give it away altered or as
part of another package.
If you find this program usefull and you continue to use GET-DIZ after
a 30 day trial period, you must register it as described below:
For non-commercial registrations, you must either send me the funds
for a 6-pack of beer, or you must drink a 6-pack yourself in honor
of the GET-DIZ program, and how it has improved your life. :-)
You must also mail (or netmail) the enclosed registration form to me
with your name and address.
Commercial registrations require actual funds, rather then getting
your entire company drunk.
* Please do not drink and drive *
Once you register GET-DIZ, you will _always_ be registered. As a
registered user, you will *NEVER* have to pay an upgrade charge
for any future versions of GET-DIZ.
SEE THE ENCLOSED REGISTER.DIZ FORM
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Credits ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
Thanks to Andrew Milner, for writing such a fantastic BBS package.
Thanks to Bruce Bodger, for asking me to become a RA beta tester.
Thanks to Ron Huiskes, for letting me steal his DOC style.
Thanks to Rob van Hoeven, for writing Keyboard Input Simulator.
Thanks to my wife Cindy, for putting up with my BBS addiction.
Thanks to David Gilmore and Roger Waters for background inspiration.
Thanks to God for providing cool women, cold beer, and green grass.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ Updates ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘
The latest version of GET-DIZ can always be file file requested using the
magic name GET-DIZ from PACIFIC COAST MICRO BBS in Southern California.
PCM is a North American RemoteAccess Support and Beta site, and offers one
of the largest collections of RA related utilites available. You can logon
quickly using the name GUEST (no password needed). Or create your own
account and tell the questionere that you run a BBS for instant access.
Be sure to (J)oin the Sysops File Conference from the files menu. :-)
PCM Node 1: 805-494-8327 USR 16.8k dual
PCM Node 2: 805-494-8427 USR 16.8k dual
PCM Node 3: 805-494-9386 USR 21.6k dual
Or Freq. FILES from 1:102/1001 or 1:102/1005 for a list of sysop related
utilities and doors avilable from PACIFIC COAST MICRO, a RA Support site.
┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒ GET-DIZ v1.3 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘