Beijing Paradise BBS Backup/PARADISE.ISO/software/BBSDOORW/GETDIZ12.ZIP/GET-DIZ.DOC

Text File | 1993-03-05 | 10.5 KB | 205 lines

┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  GET-DIZ v1.2  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘


                 Puts FILE_ID.DIZ descriptions in RA 2.00's FDB

                             Written by Mike Ehlert
                    (c) Copyright 1992 All Rights Reserved

                                   Mike Ehlert
                   PACIFIC COAST MICRO
                                1879 Campbell Ave.
                           Thousand Oaks, CA. 91360 USA

                [phone] / [phone]  / [phone]

                               FidoNet: 1:102/1001


┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  What can this do ?  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘

       GET-DIZ is an add-on utility for the RemoteAccess 2.00 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.

       DIZ stands for "Description In Zip", and FILE_ID.DIZ descriptions
       were originally use by PCBoard BBS Software. DESC.SDN is a similar
       description file, used by the Software Distribution Network.

┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  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.
      This may also be fully compatible with DOS 3.3 now, although I have
      not had anyone running DOS 3.3 test it yet.

┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  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.)
      The docs now explain how to get around a bug if using DOS 3.3.

      ** Notice ** the file names have been renamed in this version!
      Be sure to update raconfig accordingly!

┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  Required Programs  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘

       GET-DIZ is not a stand alone program, and requires the following
       other programs to properly run:

       RAMGR.EXE    (RA Manager which comes with RA 2.00)
       KIS.EXE      (Keyboard Input Simulator by R. van Hoven)
       PKUNZIP.EXE  (Pkunzip by PKware)
       ARJ.EXE      (Arj by Robert K Jung)
       POLYXARC.EXE (*optional* the GET-DIZX.com version can use this
                     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, or from me. The current version is KIS_V101.ZIP (15k).

       PolyXarc is only needed if you install the GET-DIZX.COM version of
       GET-DIZ. PolyXarc is a universal archiver which handles ZIP, ARJ,
       LZH PAK, DWC, ZOO, etc. It still requires that you have the actual
       archive programs as well.
       You can freq. or download the latest PolyXarc from me. I currently
       have version 21a for DOS: PXDOS21A.ZIP (37k).

┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  Why 3 versions? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘

       There are three differnt versions of GET-DIZ include in this archive.
       You only need to use one of them. Which one you use depends on whether
       your BBS converts all files to ZIP, ARJ or if you keep several types.

       GET-DIZZ.COM - Zip version.  Assumes all files are ZIPs.
       GET-DIZA.COM - Arj version.  Assumes all files are ARJs.
       GET-DIZX.COM - PolyXarc ver. Allows *ANY* archive type.

       The disadvantage to using the PolyXarc version is that it is slower
       then the direct versions.

       I could have just written one version, which was configurable,
       but it was easyer for me this way (it only took afew minutes to
       write), and since the files are only about 1k each, who cares?

┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  Installing  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘

       To use GET-DIZ, you must have your archivers and KIS.EXE *somewhere*
       in your path. GET-DIZ*.COM itself does not have to be in the path,
       just somewhere on your hard disk (or a RAM Disk).

       You must have the %RA% Environment varable set (eg 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

       Change number 2 command line to something like this:
       (shez is just shown as an example, which I use as my file-viewer)

       1 c:\shez\shez.exe @ *M
       2 c:\ra\get-dizX.com @
       3
       4
       5

      Notice that GET-DIZ *MUST* be installed in slot #2 (Alt-F2 key).
      >>> ANY POSITION OTHER THEN 2 WILL NOT WORK. <<<
      ************************************************
      The reason for this is because it is a self-recursive routine which
      forces RAMGR to call it again for the next file(s) below the cursor.

┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  Usage  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘

       Once it's installed, run RAMGR -f and select a file area to use.
       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 on down.
       So to process an entire area, simply start the cursor at the first
       file (at the top) when you press Alt-F2. If you wish to abort the
       process before it has finished, simply press Ctrl-Break twice.

       While its running, PKZIP or ARJ may display File-Not-Found several
       times, which just means that the tested archive did not contain any
       descriptions. 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. Write to the KIS author and ask him to update KIS.
       2. Or find a Keyfaker program that is fully DV compatible and ask me
          to support it 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 in any slot other then #2 in RACONFIG.
      Do have KIS.EXE in your path, as well as any archivers.
      Do have PolyXarc.EXE in your path, if you are using the get-dizX ver.

┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  Disclaimer  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘

       GET-DIZ is supplied as *FreeWare*. It only took me about 20 minutes
       to write it, so there is no sence in me charging you money.
       If you really feel this has made your life alot easyer, you could
       send me a small amount (perhaps enough for a 6-pack of beer), but
       you don't have to.

       GET-DIZ was tested, and worked flawlessly on my system (3 lines)
       but still, they come with NO Warranty. Use 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.
       If it crashes your system, then oh well...

┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  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 Huskes, for letting me steal his DOC screens.
      Thanks to Rob van Hoeven, for writing Keyboard Input Simulator.
      Thanks to my wife Cindy, for putting up with my BBS Habit.

┌─────────────────────────────────────────────────────────────────────────────┐
│ ▒▒▒▒  GET-DIZ v1.2  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
└─────────────────────────────────────────────────────────────────────────────┘