home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
MISC
/
GAPRAP13.ZIP
/
GAPWRAP.DOC
< prev
next >
Wrap
Text File
|
1995-01-04
|
7KB
|
162 lines
GAPwRAP Version 1.3
Copyright (c) 1992 RoboSoft Systems
All rights reserved.
GAPwRAP can be used with the GAP UPCHECK.BAT processing to
provide upload file date filtering, to filter and reformat the
FILE_ID.DIZ description to a form more suitable for use with GAP,
and to add a line to the extended description giving details about
the archive content. The detail includes how many files are in an
archive, the date of the oldest file, and the date of the newest
file. It expects the contents of the archive file to already be
dearchived into a test directory that contains ONLY the dearchived
files.
The calling format for GAPwRAP is:
GAPwRAP [/f] [/x] [/r[<cols>]] [/d] <test_dir> <work_dir>
[<oldest_date> <newest_date>]
The first four parameters, /f, /x, /r, and /d are optional, but MUST
be the first parameters on the command line if you're going to use
them. You must specify at least the test_dir and the work_dir. The
file filter dates are optional, but both must be specified if the
date filter is to be used.
If the /f parameter is specified, all high-ASCII characters will
be Filtered from the description. The intent of this is to get
rid of those cute boxes that look great on PCBoard systems but
look like doo-doo if the description is reformatted.
If the /x parameter is specified, all Xcode sequences will be
filtered from the description. If you don't like technicolor file
listings, this is the way to go.
If the /r parameter is specified, the description will be
Reformatted to fit a line <cols> characters long. <cols> will
default to 72 if not specified. If you use the /r parameter you
should also use the /f parameter or you will end up with some
pretty unreadable descriptions.
If the /d parameter is specified, all files in the <test_dir> will
be deleted by GAPwRAP before it exits.
GAPwRAP assumes the contents of the uploaded file have been
de-archived into a "test" directory. This would normally be done
in UPCHECK.BAT if you're going to scan the upload for viruses.
This "test" directory is NOT created by GAP or by GAPwRAP. You
must create it manually or have your UPCHECK.BAT create it. If
you run a multi-node system, each node should have its own test
directory. (A good place to put it is under the WORK directory
created for each node.)
The test_dir is the path to the directory in which the dearchived
files reside.
The work_dir is the path of the GAP upload work directory. This
is passed to UPCHECK.BAT as %2.
The date filter, if used, must have both the oldest_date and the
newest_date. (They can both be the same.) If the oldest file in
the test_dir is dated prior to the specified oldest_date, GAPwRAP
will return ERRORLEVEL 1. If the newest file in the test_dir is
dated prior to the specified newest_date, GAPwRAP will return
ERRORLEVEL 2. (Note: If you want to differentiate between these
two conditions in your batch file, you MUST check for ERRORLEVEL 2
before checking for ERRORLEVEL 1 since DOS will consider the IF
to be true for an ERRORLEVEL greater than or equal to the specified
ERRORLEVEL.)
Dates must be specified in the form YYMMDD, where YY is the
two-digit year, MM is the two-digit month, and DD is the two-digit
day of the month. (e.g. 5 November 1992 would be 921105.)
If a FILE_ID.DIZ file exists in the test_dir, GAPwRAP will copy
it to the work_dir and add a line of the form
Files: xx Oldest: xx/xx/xx Newest: xx/xx/xx
to the end of work_dir copy of FILE_ID.DIZ. If FILE_ID.DIZ
already contains ten or more lines of description or something
that appears to be a Files/Oldest/Newest line, nothing will be
added.
If there is no FILE_ID.DIZ in the test_dir, GAPwRAP will look
for DESC.SDI. If there is a DESC.SDI, it will be copied to the
work_dir. No changes will be made to DESC.SDI.
Please note that any changes to FILE_ID.DIZ are made to the copy
in the work_dir, not the original. The contents of the ZIP file
are completely unchanged by GAPwRAP.
Here's an excerpt from my UPCHECK.BAT file to show how GAPwRAP
can be used. The blank lines were added for clarity.
SET TEST_DIR=C:\GAP\TEST\
SET C_PORT=2
.
. Stuff missing
.
:ZIP
REM Check ZIP integrity
PKUNZIP -t %1 > Fail.Txt
IF ERRORLEVEL 1 GOTO Bad
GAPECHO %C_PORT% File Integrity Ok#Now Checking for Viruses...
DEL Fail.Txt > nul
REM UnZIP to test_dir and scan for viruses
PKUNZIP %1 %TEST_DIR%
SCAN %TEST_DIR%*.* /D /NOMEM
IF ERRORLEVEL 1 GOTO Bad
GAPECHO %C_PORT% No Viruses Detected!
REM Check for old files and add #files/dates to FILE_ID.LNG/DIZ
GAPwRAP /f /r72 /d %TEST_DIR% %2 800101 890101
IF ERRORLEVEL 1 GOTO Too_Old
GOTO Comment
.
. Stuff missing
.
Questions or comments about this program can be directed to the
Sysop at The Cookie Jar (714-997-0350) or to Jay Heyl at The
Crow's Nest. As is usual with software, I take no responsibility
whatsoever for this program or your use of it. If you use it and
it fries your FAT, scrambles your hard drive, or in any way
performs in a manner you didn't expect, you're on your own.
GAPwRAP is copyrighted software, but it may be used in a
non-commercial environment without payment of any fee. GAPwRAP
may be freely distributed on any BBS or electronic information
service. Commercial disk vendors may distribute GAPwRAP as long
as the charge for such distribution does not exceed $5.
If you're absolutely in love with this program and can't keep
yourself from expressing your appreciation, gifts may be sent to:
Jay Heyl, RoboSoft Systems, P.O. Box 2221, Orange, CA 92669.
I'm particularly fond of Cabernet and chocolate truffles. Money
is an acceptable alternative if neither of the above is convenient.
If you like GAPwRAP, you might want to check out the other GAP
utilities from RoboSoft Systems. See the enclosed file GAP-PRO.TXT
for details.