home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / getdiz13.zip / GET-DIZ.DOC < prev    next >
Text File  |  1994-02-07  |  19KB  |  338 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │ ▒▒▒▒  GET-DIZ v1.3  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  3. └─────────────────────────────────────────────────────────────────────────────┘
  4.  
  5.  
  6.                  Puts FILE_ID.DIZ descriptions in RA 2.01's FDB
  7.  
  8.                              Written by Mike Ehlert
  9.                     Copyright 1992,93,94 All Rights Reserved
  10.  
  11.                                    Mike Ehlert 
  12.                    PACIFIC COAST MICRO
  13.                                 1879 Campbell Ave.
  14.                            Thousand Oaks, CA. 91360 USA
  15.  
  16.                     A North American RemoteAccess Support Site
  17.               
  18.                 (805) 494-8327 / (805) 494-8427  / (805) 494-9386
  19.  
  20.                         FidoNet: 1:102/1001 and 1:102/1005
  21.  
  22. ┌─────────────────────────────────────────────────────────────────────────────┐
  23. │ ▒▒▒▒  What can this do ?  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  24. └─────────────────────────────────────────────────────────────────────────────┘
  25.  
  26.        GET-DIZ is an add-on utility for the RemoteAccess 2.01 File Manager.
  27.        It allows you to quickly scan some or all files in the current area
  28.        for FILE_ID.DIZ or DESC.SDN file descriptions, and each time one is
  29.        found it puts that description into RA's FDB (file data base) even
  30.        if a differnt description already existed there. It's only 1.5k in
  31.        size, making it the smallest RA utility ever developed!
  32.        
  33.        DIZ stands for "Description In Zip", and FILE_ID.DIZ descriptions
  34.        were originally use by PCBoard BBS Software. DESC.SDI is a similar
  35.        description file used by the Software Distribution Network.
  36.  
  37. ┌─────────────────────────────────────────────────────────────────────────────┐
  38. │ ▒▒▒▒  Whats new in version 1.3? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  39. └─────────────────────────────────────────────────────────────────────────────┘
  40.  
  41.       *** NEW COMMAND LINE PARAMETERS! *** Be sure to read the docs if you
  42.       are upgrading from a previous version!!! 
  43.  
  44.       This version has been optimized for fastest speed and smallest size.
  45.       Archive comments are no longer displayed while processing files.
  46.       You can process just the file at the cursor instead of having to
  47.       process all the files below there as well. Ctrl-Z (EOF) characters
  48.       at the end of the DIZ file are now removed from the FDB description.   
  49.       You can specify any archiver on the command line now, as well as any
  50.       brand of keyboard stuffer. This version is Beerware, an almost free
  51.       form of shareware.
  52.  
  53. ┌─────────────────────────────────────────────────────────────────────────────┐
  54. │ ▒▒▒▒  Whats new in version 1.2? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  55. └─────────────────────────────────────────────────────────────────────────────┘
  56.  
  57.       This version is now 4DOS compatible! I had to actually install 4DOS
  58.       on my system to figure out why it was not working, and I fixed it.
  59.              
  60. ┌─────────────────────────────────────────────────────────────────────────────┐
  61. │ ▒▒▒▒  Whats new in version 1.1? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  62. └─────────────────────────────────────────────────────────────────────────────┘
  63.  
  64.       This version has support for PolyXarc, to support *any* archive type.
  65.       (Thanks to David Gibbs of the Midrange System for the suggestion.)
  66.       
  67. ┌─────────────────────────────────────────────────────────────────────────────┐
  68. │ ▒▒▒▒  Required Programs  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  69. └─────────────────────────────────────────────────────────────────────────────┘
  70.  
  71.        GET-DIZ.COM is not a stand alone program, and requires the following
  72.        other programs to properly run:
  73.  
  74.        RAMGR.EXE    (RA Manager which comes with RA 2.01)
  75.        KIS.EXE      (Keyboard Input Simulator by R. van Hoven)
  76.        PKUNZIP.EXE  (Pkunzip by PKware)
  77.        ARJ.EXE      (Arj by Robert K Jung)
  78.        POLYXARC.EXE *Optional* GET-DIZ can use this shell which is a slower
  79.                     method but handles all archive types.
  80.             (PolyXarc by Jeffrey Nonken).
  81.        
  82.        RAMGR is required since this is an add-on for it which is designed
  83.        to be only called from RAMGR.EXE directly.
  84.  
  85.        The reason that KIS is needed is to stuff keys into the keyboard
  86.        buffer before returning to RAMGR, to force RAMGR to perform the FDB
  87.        updates and to force GET-DIZ to be called again for the next file(s).
  88.        You can freq. or download the latest KIS from any DISP support site
  89.        (the FileDoor dudes), or from me. The current version is KIS_V101.ZIP
  90.        which is only 15k in size. KIS is postcardware (a form of shareware).
  91.  
  92.        PolyXarc is only needed if you want to process multiple archive types.
  93.        I recomend you convert all your archives to ZIP or ARJ before you
  94.        use GET-DIZ, so that PollyXarc is not needed. PolyXarc is a freeware
  95.        universal archiver which handles ZIP, ARJ, LZH PAK, DWC, ZOO, etc.
  96.        You can freq. or download the latest PolyXarc from me, or use any
  97.        simular utility instead. I currently have version 2.1A for DOS, the
  98.        filename is PXDOS21A.ZIP (37k).
  99.  
  100. ┌─────────────────────────────────────────────────────────────────────────────┐
  101. │ ▒▒▒▒  Upgrading from a previous version ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  102. └─────────────────────────────────────────────────────────────────────────────┘
  103.  
  104.        If you are upgrading from an older version of GET-DIZ, then be sure
  105.        to delete your old GET-DIZ*.COM files, as they are no longer needed.
  106.        The new GET-DIZ.COM replaces the 3 older files with simular names.
  107.        You must also enter a a new command line in RACONFIG as illustrated
  108.        below.
  109.  
  110. ┌─────────────────────────────────────────────────────────────────────────────┐
  111. │ ▒▒▒▒  Installing  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  112. └─────────────────────────────────────────────────────────────────────────────┘
  113.  
  114.        You must have the %RA% Environment varable set (SET RA=C:\RA).
  115.        ***NOTICE!!!*** Do *NOT* have a trailing backslash on the %RA%
  116.        environment variable or GET-DIZ will not work!
  117.  
  118.        Run RACONFIG > OPTIONS > FILES > RAMGR-FNKEYS
  119.        You will see a box of 5 sysop definable options, most of them are
  120.        probally blank:
  121.  
  122.       ╒══════════════════════════════╡  RAMGR ALT-function key manager  ╞╕
  123.       │                                                                  │
  124.       │ 1  C:\shez\shez.exe @ *M                                         │
  125.       │ 2                                                                │
  126.       │ 3                                                                │
  127.       │ 4                                                                │
  128.       │ 5                                                                │
  129.       │                                                                  │
  130.       ╘══════════════════════════════════════════════════════════════════╛
  131.  
  132.       In the above example, only ALT-F1 is defined, which will cause RAMGR
  133.       to pass the filename currently under the cursor to SHEZ, which is an
  134.       archive viewer. The @ is replaced by RAMGR with the actual path and
  135.       name of the current file. The *M tells RAMGR to swap out of memory
  136.       before shelling to the defined program.
  137.  
  138.  
  139.       GET-DIZ can be installed here in many ways, both in Recursive and
  140.       Non-Recursive modes, as illustrated in the following examples:
  141.  
  142.  
  143.       *********************************************************************
  144.       To install GET-DIZ just for ZIP files, enter lines 2 and 3 like this:
  145.  
  146.       ╒══════════════════════════════╡  RAMGR ALT-function key manager  ╞╕
  147.       │                                                                  │
  148.       │ 1  c:\shez\shez.exe @ *M                                         │
  149.       │ 2  c:\ra\get-diz.com c:\utils\kis c:\utils\pkunzip -o @          │
  150.       │ 3  c:\ra\get-diz.com c:\utils\kis c:\utils\pkunzip -o @ 1        │
  151.                               │            │               │  │ │
  152.                               │            │               │  │ │
  153.          Path\filename of KIS─┘            │               │  │ │
  154.          Path\filename of Unarchiver───────┘               │  │ │
  155.          Unarchiver extract command────────────────────────┘  │ │
  156.          Converted to Path\filename of current file by RAMGR──┘ │
  157.          A "1" here will disable the recursive mode─────────────┘
  158.      
  159.  
  160.       *********************************************************************
  161.       To install GET-DIZ just for ARJ files, enter lines 2 and 3 like this:
  162.  
  163.  
  164.       ╒══════════════════════════════╡  RAMGR ALT-function key manager  ╞╕
  165.       │                                                                  │
  166.       │ 1  c:\shez\shez.exe @ *M                                         │
  167.       │ 2  c:\ra\get-diz.com c:\utils\kis c:\utils\arj   e  @            │
  168.       │ 3  c:\ra\get-diz.com c:\utils\kis c:\utils\arj   e  @ 1          │
  169.                               │            │             │  │ │
  170.                               │            │             │  │ │
  171.          Path\filename of KIS─┘            │             │  │ │
  172.          Path\filename of Unarchiver───────┘             │  │ │
  173.          Unarchiver extract command──────────────────────┘  │ │
  174.          Converted to Path\filename of current file by RAMGR┘ │
  175.          A "1" here will disable the recursive mode───────────┘
  176.  
  177.  
  178.       ********************************************************************
  179.       Or you can install GET-DIZ with universal archive support like this:
  180.       
  181.  
  182.       ╒══════════════════════════════╡  RAMGR ALT-function key manager  ╞╕
  183.       │                                                                  │
  184.       │ 1  c:\shez\shez.exe @ *M                                         │
  185.       │ 2  c:\ra\get-diz.com c:\utils\kis c:\utils\polyxarc -o @         │
  186.       │ 3  c:\ra\get-diz.com c:\utils\kis c:\utils\polyxarc -o @ 1       │
  187.                               │            │                │  │ │
  188.                               │            │                │  │ │
  189.          Path\filename of KIS─┘            │                │  │ │
  190.          Path\filename of Unarchiver───────┘                │  │ │
  191.          Unarchiver extract command─────────────────────────┘  │ │
  192.          Converted to Path\filename of current file by RAMGR───┘ │
  193.          A "1" here will disable the recursive mode──────────────┘
  194.       
  195.        
  196.       Notice that in order to use the RECURSIVE mode, GET-DIZ *MUST* be
  197.       installed in slot #2 (Alt-F2 key), and line 2 may *NOT* have a "1"
  198.       at the end. > ANY POSITION OTHER THEN 2 WILL NOT BE RECURSIVE!. <
  199.                     +++++++++++++++++++++++++++++++++++++++++++++++++
  200.       The reason for this is because GET-DIZ stuffs an ALT-F2 into the
  201.       keyboard buffer in order to force RAMGR to call it again after it
  202.       has moved the cursor down to the next file.
  203.     
  204.       It is NOT required to specify the entire path to KIS or to your
  205.       Unarchiver, but GET-DIZ will run faster if you do. If you don't
  206.       specify these paths, then they must be located in the DOS %PATH%.
  207.  
  208.       It is NOT required to use the *M command to swap out of memory
  209.       before running GET-DIZ, and it's faster if you do not. However
  210.       if your system is running in a very small window then you might
  211.       have to add the *M to the end of the command lines.
  212.  
  213.       Pkunzip and PolyXarc don't actually need an extract command like
  214.       ARJ needs "e", so the "-o" is used just as a filler parameter.
  215.  
  216. ┌─────────────────────────────────────────────────────────────────────────────┐
  217. │ ▒▒▒▒  Usage  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  218. └─────────────────────────────────────────────────────────────────────────────┘
  219.  
  220.        Once it's installed, run "RAMGR -F" and select a file area to use.
  221.        You can optionally press Alt-D to change the display mode first.
  222.        
  223.        To use GET-DIZ in Recursive mode, move the cursor to the first file
  224.        which you wish to process. Press Alt-F2 to begin, and RAMGR will call
  225.        GET-DIZ once for each file from there, all the way down to the last
  226.        file in the current area. So to process an entire area, simply start
  227.        the cursor at the first file (at the top) and press Alt-F2. If you
  228.        wish to abort the process before it has finished, simply press
  229.        Ctrl-Break twice.
  230.  
  231.        To use GET-DIZ in Non-Recursive mode, move the cursor to the one file
  232.        you wish to process. Press Alt-F3 and only that one file is processed.
  233.        
  234.        While its running, PKZIP or ARJ may display "File-Not-Found" messages,
  235.        which just means that the tested archive did not contain any
  236.        descriptions files. This is normal.
  237.  
  238. ┌─────────────────────────────────────────────────────────────────────────────┐
  239. │ ▒▒▒▒  DesqView Limitations  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  240. └─────────────────────────────────────────────────────────────────────────────┘
  241.  
  242.        GET-DIZ runs perfectly under Desqview, but KIS 1.01 has a limitation:
  243.        You can not switch windows while GET-DIZ is running, or elce KIS will
  244.        stuff the keyboard buffer into the new current window.
  245.        
  246.        If you don't like this limitation, there are three things you can do:
  247.        1. Ask the KIS author to make KIS more compatible with DV.
  248.        2. Write your own Keyboard Input Simulator to use instead.
  249.        3. Or delete this package and forget you ever saw it. :-)
  250.  
  251. ┌─────────────────────────────────────────────────────────────────────────────┐
  252. │ ▒▒▒▒  Trouble Shooting ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  253. └─────────────────────────────────────────────────────────────────────────────┘
  254.  
  255.       If you could not get GET-DIZ to work, here's some things to check:
  256.  
  257.       Do *not* have a trailing bakcslash on your %RA% Environment variable.
  258.       Do *not* install it as RECURSIVE in any slot other then #2 in RACONFIG.
  259.       Check that your paths and filenames are entered correctly.
  260.       
  261.       If all elce fails drink another beer, wait 5 minutes, and try again.
  262.       :-) Or give me a netmail and I'll try to help you if I'm sober enough. 
  263.                
  264. ┌─────────────────────────────────────────────────────────────────────────────┐
  265. │ ▒▒▒▒  Disclaimer  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  266. └─────────────────────────────────────────────────────────────────────────────┘
  267.  
  268.        GET-DIZ was tested, and worked flawlessly on my system (Running 3
  269.        nodes under RA-Pro 2.01 and Desqview). But it comes with NO Warranty.
  270.        Use it at your own risk!
  271.  
  272.        In no event shall Mike Ehlert or PACIFIC COAST MICRO be liable for
  273.        any damages caused by GET-DIZ. The software is supplied as-is.
  274.        
  275. ┌─────────────────────────────────────────────────────────────────────────────┐
  276. │ ▒▒▒▒  Registering  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  277. └─────────────────────────────────────────────────────────────────────────────┘
  278.  
  279.        GET-DIZ is supplyed as Beerware, (a form of shareware). Feel free to
  280.        share it with your freinds, but do not give it away altered or as
  281.        part of another package.
  282.        
  283.        If you find this program usefull and you continue to use GET-DIZ after
  284.        a 30 day trial period, you must register it as described below:
  285.  
  286.        For non-commercial registrations, you must either send me the funds
  287.        for a 6-pack of beer, or you must drink a 6-pack yourself in honor
  288.        of the GET-DIZ program, and how it has improved your life. :-)
  289.        You must also mail (or netmail) the enclosed registration form to me
  290.        with your name and address.
  291.        
  292.        Commercial registrations require actual funds, rather then getting
  293.        your entire company drunk. 
  294.  
  295.        * Please do not drink and drive *
  296.  
  297.        Once you register GET-DIZ, you will _always_ be registered. As a 
  298.        registered user, you will *NEVER* have to pay an upgrade charge
  299.        for any future versions of GET-DIZ.
  300.  
  301.        SEE THE ENCLOSED REGISTER.DIZ FORM
  302.  
  303. ┌─────────────────────────────────────────────────────────────────────────────┐
  304. │ ▒▒▒▒  Credits  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  305. └─────────────────────────────────────────────────────────────────────────────┘
  306.  
  307.       Thanks to Andrew Milner, for writing such a fantastic BBS package.
  308.       Thanks to Bruce Bodger, for asking me to become a RA beta tester.
  309.       Thanks to Ron Huiskes, for letting me steal his DOC style.
  310.       Thanks to Rob van Hoeven, for writing Keyboard Input Simulator.
  311.       Thanks to my wife Cindy, for putting up with my BBS addiction.
  312.       Thanks to David Gilmore and Roger Waters for background inspiration.
  313.       Thanks to God for providing cool women, cold beer, and green grass.
  314.  
  315. ┌─────────────────────────────────────────────────────────────────────────────┐
  316. │ ▒▒▒▒  Updates  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  317. └─────────────────────────────────────────────────────────────────────────────┘
  318.  
  319. The latest version of GET-DIZ can always be file file requested using the
  320. magic name GET-DIZ from PACIFIC COAST MICRO BBS in Southern California.
  321.  
  322. PCM is a North American RemoteAccess Support and Beta site, and offers one
  323. of the largest collections of RA related utilites available. You can logon
  324. quickly using the name GUEST (no password needed). Or create your own
  325. account and tell the questionere that you run a BBS for instant access. 
  326.  
  327. Be sure to (J)oin the Sysops File Conference from the files menu. :-)
  328.  
  329. PCM Node 1:  805-494-8327  USR 16.8k dual
  330. PCM Node 2:  805-494-8427  USR 16.8k dual
  331. PCM Node 3:  805-494-9386  USR 21.6k dual
  332.  
  333. Or Freq. FILES from 1:102/1001 or 1:102/1005 for a list of sysop related
  334. utilities and doors avilable from PACIFIC COAST MICRO, a RA Support site.
  335.  
  336. ┌─────────────────────────────────────────────────────────────────────────────┐
  337. │ ▒▒▒▒  GET-DIZ v1.3  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  338. └─────────────────────────────────────────────────────────────────────────────┘