home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
EZ_DIZ12.ZIP
/
EZ-DIZ.DOC
< prev
next >
Wrap
Text File
|
1992-02-17
|
9KB
|
217 lines
EZ-DIZ v1.2
Copyright (c) 1992 By Rick Kuban
INTRODUCTION:
-------------
EZ-DIZ is a utility program written to automate and
speed up a PCBoard 14.5+ sysop's maintainance of the upload
directory files list using the FILE_ID.DIZ and DESC.SDI files
in ZIP/ARC/ARJ/PAK/LZH archives. It provides similar functions
as the PCBDESC utility, but functions from the command line,
unlike PCBDESC, and *DOES NOT* require "Local Uploads".
It may be manually used one file at a time, or, by clever use
of a batch file (as intended), can be used to automatically
process an entire directory at one time. It contains the
intelligence required to not process a file that has already
been placed in the dir listing. It is suitable to run in an
event, if desired.
EZ-DIZ now automatically recognizes ZIP/PAK/ARC/LZH and ARJ
formats, and, if the appropriate decompressor is available,
will process the file. If a file in the directory is not an
archive, it will simply be skipped.
STANDARD "DEMO" LICENSE:
------------------------
EZ-DIZ is a Shareware program, and uploading of the code
to various bulletin boards and Shareware libraries is encouraged.
Several limitations must be implied, however:
1) Under no circumstances should the code be modified or dis-
tributed in any other form than what it was originally supplied
by the author. The exception is that EZ-DIZ may be compressed
using techniques other than ZIP, but the de-compressed form of
EZ-DIZ must remain intact. No files may be added to or removed
from the archive contents. This explicitly includes bbs ads of
any kind.
Files included in the original archive are:
EZ-DIZ.EXE - the executable program file
EZ-DIZ.DOC - this documentation file
QUICK.DOC - a quick start for old & new users
EZDIZ.BAT - sample batch file (single)
B-DIZ.BAT - sample batch file (batch)
EZ-DIZ.REG - registration form
FILE_ID.DIZ - description file
2) EZ-DIZ may not be redistributed in any manner other than
electronic file transfer unless cleared with the author beforehand.
No money may be received for EZ-DIZ except to cover for telecom-
munications/service charges, and in such a case the cost may not
exceed $5.00 in US funds.
3) EZ-DIZ may be run for a period of time adequate to allow
for full testing of the software. If, after running the code for
one month, you decide not to purchase the registration license,
you must forfeit this license and remove EZ-DIZ from operation
on your system(s). You may keep a copy online for distribution
purposes only.
4) EZ-DIZ may not be hacked or modified in ANY manner.
REGISTRATION LICENSE:
---------------------
1) Once purchasing the registration license, the license is
extended for life. All future releases of EZ-DIZ will be made
available, for no additional charge. Upon each issuance of a later
revision, registrations will not be accepted for older versions.
2) The registration license is non-refundable and non-transfer-
able without prior consent of the author. The registration license
permits the licensee to operate EZ-DIZ on one (1) system only.
The definition of "system" will be construed to include a multiple
node network at the same physical location, operating under the
same bbs name.
3) The registration fee for EZ-DIZ v1.2 is $10.00 in US funds.
4) Product support for EZ-DIZ will be provided to registered
users thru Technoid's Toybox BBS, (214) 226-6017. The user should
call Technoid's Toybox, after giving the mail time to arrive, to
download their registration key which will enable the advanced
features, and/or remove the "UNREGISTERED COPY" notices from the
program.
If desired, the user can include an additional $5.00 US with the
registration fee to cover postage and handling and a copy of the
latest version of EZ-DIZ and their registration key will be
returned via U.S. Mail on 5.25" 360k IBM Format disk.
DISCLAIMER:
-----------
Although the program has been tested, and is currently in
use on the authors bbs, the author assumes no responsibility nor
liability for any data loss, incurred costs, equipment or other
damage as a result of the use of EZ-DIZ. The user assumes all
risk for damages incurred from the use of this product.
EZ-DIZ has been tested on PCBoard v14.5a, multi-node, running on
a LANtastic v4.0 network under MS DOS v3.3. The versions of various
decompression programs used in testing are:
PKUNZIP v1.10 / PKUNPAK v3.61 / LHA v2.12 / PAK v2.10 / ARJ v2.10
OPERATING EZ-DIZ:
-----------------
EZ-DIZ is very simple to operate. No setup or configurations
are required. It is suggested that a batch file be used to
call EZ-DIZ in order to eliminate keystrokes. Study the
enclosed examples for reference.
EZ-DIZ should be placed in any convenient directory, and must
have available to it either directly, or in the path, of the
appropriate versions of PKUNZIP/PKUNPAK/PAK/LHA/ARJ in order to
be able to retrieve the FILE_ID.DIZ or DESC.SDI file from the
archives. EZ-DIZ must be called from the directory it (and its
keyfile, REGISTER.KEY) are in. Note that this is different from
previous versions.
EZ-DIZ relies on two command line arguments passed to it upon
invocation. The first argument is the fully qualified path and
filename of the PCBoard directory file to be updated (Example:
C:\PCB\GEN\UPDIR). The second argument is the name of the
archived file to be processed (Example: D:\UPLOADS\EZ-DIZ.ZIP).
An example of such a command line might be:
C:\PCB> EZ-DIZ C:\pcb\gen\updir d:\uploads\ez-diz.zip
Use of a batch file with replaceable parameters would look
like this:
DIZ.BAT
REM - Process one zip file
echo off
ez-diz c:\pcb\gen\updir d:\uploads\%1
The above would be called as:
C:\UPLOADS> DIZ ez-diz.zip
B-DIZ BATCH FILE:
------------------
When calling up EZ-DIZ, you may want to automatically process
the entire directory without intervention. Consider the following
batch file example:
B-DIZ.BAT
REM - Process all files in d:\uploads
for %%x in (d:\uploads\*.*) do ez-diz c:\pcb\gen\updir %%x
The above command line will process every archive file in the
specified uploads directory, placing any FILE_ID.DIZ or DESC.SDI
descriptions found into the directory file UPDIR in the C:\PCB\GEN
subdirectory. This process runs very quickly. By calling one
or more batch files with different archive format specifications
(ie... d:\uploads\*.arj would process all ARJ), one can exercise
great power over which files are supported or processed.
OPERATIONAL NOTE:
-----------------
EZ-DIZ places a temporary placeholder in the dir file for the
zipfile's size and date. If you view the dir file with a text
editor immediately after running EZ-DIZ, you will see a 1 byte
file size and 01-01-80 for the date. Do not be alarmed...the
placeholder will be replaced with the proper information when
PCBFiler resaves the file the first time. If this poses a "real
time" problem, you may run PCBFiler with the command line switch
to update & force a save in your event right after EZ-DIZ
runs. (Future enhancements in this area are planned)
ACKNOWLEDGEMENTS:
-----------------
PAK; NoGate Consulting
LHA; Haruyasu Yoshizaki
ARJ; Robert K. Jung
PKUNZIP, PKUNPAK; PKWare, Inc.
PCBoard, PCBDesc, PCBFiler; Clark Development Co., Inc
------------------------------------------------------------------------------