
                         ZDCS / ULP Remote Shell                          
                             Version 1.0 Beta                             
                            By: Don Pellegrino                            



Introduction:


	What is the ZDCS?  The ZDCS is the Zip Duplicate Checking System.  It is
used on many BBSs for the purpose of pre-testing user uploads.  It will read a
text file created from the view command of pkunzip (pkunzip -v filename.zip >
zdcstest.chk).  The ZDCS is usually a door or file menu command.  When
executed, it will prompt you to upload your zdcstest.chk file.  ZDCS will then
read that file and determine if filename.zip will be accepted as an upload.
	What is the ULP?  The ULP is the UpLoad Processor.  It is used on many
BBSs to scan for duplication, it has many added features and also checks for
many other attributes including file date and time.  This allows a BBS to
accept only uploads that are of a certain age.  The ULP checks ZIP files with
the [pkunzip -v filename.zip > verify.ulp] and also checks ARJ files, by using
the [arj l filename.zip > verify.ulp].
	What is the Remote Shell?  The shell is a quick and easy way to create
zdcstest.chk and verify.ulp files.  You simply input filename and RS does the
rest.


ZURS1.ZIP - Getting Started:


ZIP Contents:
	IMAGE1.MAP   - 320x200x256 Image used by: ZURS1.EXE
	IMAGE2.MAP   - 320x200x256 Image used by: ZURS1.EXE
	IMAGE3.MAP   - 320x200x256 Image used by: ZURS1.EXE
	IMAGE4.MAP   - 320x200x256 Image used by: ZURS1.EXE
	IMAGE5.MAP   - 320x200x256 Image used by: ZURS1.EXE
	LCOM.CHR     - Font used by: ZURS1.EXE
	LITT.CHR     - Font used by: ZURS1.EXE
	SANS.CHR     - Font used by: ZURS1.EXE
	TSCR.CHR     - Font used by: ZURS1.EXE
	VESA.BGI     - Graphic Driver used by: ZURS1.EXE
	ZURS1.EXE    - The main program executable.
	ZURS1.TXT    - This file.
Files Created after Configuration:
	ZURS1.CFG    - Data file used by: ZURS1.EXE
	RS.BAT       - Batch file (the one you should run).
	VERIFY.ULP   - The file you upload to a BBS using the UpLoad Processor.
	ZDCSTEST.CHK - The file you upload to a BBS using the ZDCS.

Unzipping the archive:
	You should create an empty directory to place all of the files in
(c:\zurs).  Next you should use pkunzip to extract the files to that
directory. 

Running and Configuring the program:
	Make the directory containing all of the ZURS files the current directory.
Execute ZURS1.EXE and configure the program.  You will be prompted for three
different fields of data: 
	1.  Location of the program files - The name of the directory containing
all of the files that were extracted from the archive.  ex. C:\ZURS
	2.  Directory to place ZDCS/ULP check files in - The name of the directory
that you would like the shell to write the ZDCSTEST.CHK and VERIFY.ULP files
to.  ex. C:\TELIX\UPLOADS
	3.  Directory containing ZIP and ARJ files - The name of the directory you
would like the RS to view on start-up.
	After the program has been configured ZURS1.CFG and RS.BAT will be wirtten
to disk.  From now on, whenever you start the program run RS.BAT.  This file
will make the directory containing the ZURS files the current directory and
execute ZURS1.EXE.  This batch file is very useful when running the shell from
a terminal program.  It might be useful to add the following line to the end
of the batch program [CD DIR] where DIR = the name of the directory
containing your terminal program.


Technical Support:


Contact DON PELLEGRINO (Remote Shell):
	INTERNET: don.pellegrino@jbjsys.com
	ILINK: Don Pellegrino ECHO ZDCS
	BBS: The Dew Drop Inn (412) 854-0619
	POSTAL: Don Pellegrino
	        124 Grove Avenue
	        Pittsburgh, PA. 15229-1306

Contact STACY SMITH	(UpLoad Processor and Zip Duplicate Checking System):
    Intelec and ILink ZDCS Support echoes
    Intelec, ILink and RIME ULP Support echoes
    Fidonet and ILink CDC-Support echoes
    Intelec and ILink Sysop echoes
    Fidonet PCBNET echo
    BBS: The Bloom Beacon-Picayune BBS
         919-557-3845  USRobotics Courier HST/V.32terbo Dual Standard
         919-557-0645  USRobotics Courier V.32bis
         919-557-0745  Hayes Optima 288 V.FC
	

BBS Bulliten for the UpLoad Processor:


Ŀ
                    
                                  UpLoadProcessor
         ķ    
                            How to verify archives
    Ľ  Ľ                 BEFORE you upload them!
                   
 
  ͼ

This bulletin board system is using an advanced upload processing system
called UpLoadProcessor, or ULP for short.  This system fully tests all uploads
for CRC errors, duplicate files, viruses, age and other contraints.  This can
be a headache for users who spend a lot of time uploading a file, only to find
out that it is a duplicate file or is older than the Sysop allows, and then
loses credit for their effort.

Now there is a solution: ULP will allow you to create a redirected archive
listing text file named VERIFY.ULP, and upload that.  ULP will review the
listing, and report back to you if the file will pass the duplication and age
limits set by the Sysop.  (This will only work for ARJ and ZIP archives, but
that shouldn't pose a problem, since these two formats make up the vast
majority of BBS archives).

First, you must create the list file VERIFY.ULP (no other file name will be
accepted by ULP).  For an ARJ archive, issue the following command to get your
archive listing file VERIFY.ULP (replace the 'FILENAME.ARJ' with the archive's
file name):

    ARJ L FILENAME.ARJ > VERIFY.ULP

For a ZIP archive, issue this command, using the appropriate file name:

    PKUNZIP -V FILENAME.ZIP > VERIFY.ULP

Next, just upload the VERIFY.ULP file (do not compress it; it's only a few
hundred bytes normally).  ULP will report back if the file will pass the
limits, and then you can upload the archive without wondering if it will pass
or not.

Don't be alarmed when you see the closing message that the VERIFY.ULP file
will be removed and failed.  This is for PCBoard housekeeping; if this did not
occur, this file would remain on disk and be processed as an upload.

If you have any questions regarding this process, please contact your Sysop.


BBS Bulliten for the Zip Duplicate Checking System:


                          DUPLICATE CHECKING

This bbs uses ZDCS (Zipfile Duplicate Checking System) to check the files in
your upload against those already here on the bbs to see if there are any
duplicates.  This benefits us by wasting less storage space on keeping
multiple copies of the same files, and benefits you by reducing the
frustration of downloading files with different names that turn out to be the
same files after all.

When you upload your file, ZDCS will check it and tell you whether or not
there are any duplicate files inside your upload.  If there are more
duplicates than this bbs allows, the upload will be moved to a private area
for the sysop's review.  It is not dumped!

You can "pre-test" an upload before actually spending your time on- line to
send it.  This does not require you to download any special programs or to
perform any arcane rituals.  The pre-test will give you the same sort of
information that ZDCS gives to a finished upload, so you can see how your
intended upload would compare with the files already on the bbs.  Sound too
good to be true?  It's really pretty simple.  All you need is PKZIP.  You *do*
have PKZIP, right?

Let's say that you want to upload a zipfile called GOODSTUF.ZIP.  At your DOS
prompt, type in the following (not case-sensitive) command:

          PKZIP -V GOODSTUF.ZIP > ZDCSTEST.CHK

A new file called ZDCSTEST.CHK has just been created with information about
GOODSTUF.ZIP in it.  All you have to do is upload ZDCSTEST.CHK to the bbs, and
it will give you a breakdown of all the individual files in GOODSTUF.ZIP, with
a note as to whether any of them are duplicates or bbs ads.  Now you know
whether it's worth your time to upload GOODSTUF.ZIP to the board.  (Sorry, no
upload credits for ZDCSTEST.CHK.)

Suppose you have more than one upload you want to check out.  (First off,
thank you for wanting to upload!) You'll have to issue the above command
separately for each upload you want to check out, creating separate
ZDCSTEST.CHK files.  You can handle this one of two ways:

1.  Do it ahead of time and use a different directory for each upload.  This
     is to keep from overwriting the ZDCSTEST.CHK file for one upload with the
     .CHK file from another.

2.  Shell out to DOS while on-line and do it live.  (Each communications
     program does this a little differently, but pretty much any half-way
     decent comm program lets you pop out of the bbs and back to your own
     machine's DOS for little things like this.) Since the PKZIP -V command is
     so fast, you lose very little time.  This is probably the simplest way to
     do it.

On a multi-node system, there is a possibility that someone else is trying to
upload her or his own ZDCSTEST.CHK test file at the same time as you.  In that
case, the bbs may tell you that your file is a dupe.  Just count to ten slowly
and try again.  If you get the same message a second time, leave a <C>omment
to the sysop.  There is another possible reason for this dupe message, which
the sysop can check out.

Thanks for the uploads!

 .....................................................................
              ZDCS and Zipfile Duplicate Checking System
   (C) Copyright 1991, 1992  Michael W. Cocke.  All rights reserved.


Shareware - Please support my efforts:


Please distribute this program freely.  If you find the Remote Shell useful
please register the program with DON PELLEGRINO.  You will recieve a printed
copy of the documentation and a copy of any future versions.  The cost is only
$10.00.  If you would like a copy of the C++ source code send only $50.00.
The source code is not shareware but you will be welcome to use it in any of
your own programs.

$10.00 - Program Registration
$50.00 - C++ Source Code

Send the following information along with a check in the appropriate amount
to: Don Pellegrino
    124 Grove Avenue
    Pittsburgh, PA. 15229-1306

YOUR NAME:
YOUR ADDRESS:
YOUR EMAIL ADDRESS(es):
WHERE YOU GOT YOUR COPY OF ZURS1.ZIP:
COMMENTS, SUGGESTIONS:    
