Media Share 9

home *** CD-ROM | disk | FTP | other *** search

/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / pcblogo2.zip / PCBLOGO.DOC < prev next >

Wrap

Text File | 1992-07-01 | 21KB | 414 lines

PCBLOGO v2.0 Copyright @ 1992 by: Fletcher S. James All Rights Reserved ---------------------------------------------------------------------- What is PCBLOGO??? ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ PCBLOGO is a fast and easy way to insert a ZIP comments and other files such as Ads to your already existing ZIP file just before it is downloaded from the BBS. PCBLOGO was primarily written to aid in inserting advertisement in CD-ROM files before they get downloaded from the BBS, but if you don't have a CD-ROM, don't worry, this program you'll find very useful. Here are the reasons: #1 - An Advantage over the rest! Not only does PCBLOGO add ZIP Comments to your files, but it can also append a file of your own accord inside the ZIP file. The reason for this is that a ZIP comment is only seeing when the file is unzipped and only for a brief time. An appended file can be viewed as many times as the user wants to view it, also it makes a great Ad if the file is uploaded to another BBS! (chuckle) #2 - PCBLOGO lets you save disk space! Lets say that all the files on your hardrive have your ZIP Comment or Ad appended to them and each file was 2k (2000 bytes) or more and you had 17,000 files each with this 2k file, well with good ole Mathematics we can figure that 2 x 17,000 = 34,000k or (34,000,000 bytes) which is 3.4 meg used just for Ads or Comments...WOW!!! PCBLOGO lets those ZIP Comments and Ads be appended just before a download and then deletes the ZIP file leaving the original ZIP file still intact. #3 - Your Ad will always be up-to-date! Lets say that all your files had your old Ad in the ZIP files and it is now time for a new Ad because your BBS has changed since that time. What would you do? just leave them? With PCBLOGO whenever you change your Ad, PCBLOGO will always append the revised Ad to the ZIP file just before a download. #4 - Time Saver! Lets say you just received some new files from an old friend on disk and you need to put them in your BBS. Usually you would have to add your comments or Ads as soon as you received them but with PCBLOGO now you can put your newly received files in your download directories and PCBLOGO will make sure the Ad or comment is Appended before a download. Files Contained in this Arcive ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ * PCBLOGO.EXE - The Executionable File * PCBLOGO.DOC - This File you're Reading * HISTORY.DOC - Revisions of PCBLOGO * REGISTER.DOC - Registration for PCBLOGO * PCBSZ.BAT - An Example of PCBoard's Send Zmodem Batch File * PCBRZ.BAT - An Example of PCBoard's Receive Zmodem Batch * ELIM.EXE - A Program which will erase whole directories * ELIM.DOC - The Maunal on how to use ELIM.EXE by Bob Eyer NOTE * If you find you're missing any of these files please contact me at the address below. What Will I Need? ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ * IBM PC AT/XT OR COMPATIBLE * 640K OF MEMORY OR GREATER * 80 COLUMN MONITOR * HARDRIVE OF ANY SIZE * PCBLOGO.EXE ver. 2.0 by: Fletcher James (included) * ELIM.EXE ver. 2.0 by: Bob Eyer (included) * PCBoard ver. 14.xx by: Clark Development Co., Inc. * DSZ0427.ZIP by: Omen Technology Inc. Chuck Forsberg (DSZ.COM) * PKZ110.EXE ver. 1.10 by: PKWARE Inc. (PKZIP.EXE) Installation ▀▀▀▀▀▀▀▀▀▀▀▀ Installing PCBLOGO is a snap!... Batch files are included with this program to make life easier, as well you probably have most of the installation already done if you're already using some of the programs needed for PCBLOGO, but if not, then I will take you step by step to see that you have everything up and going. First off, you must find a directory or directories for the following files and have those directories in the DOS PATH; PCBLOGO.EXE, ELIM.EXE, PCBOARD.EXE, DSZ.COM, PKZIP.EXE. If your not sure how to install a DOS path in your AUTOEXEC.BAT then refer to your DOS Manual. Place PCBLOGO.EXE in the directory where PCBoard.EXE resides eg. C:\PCB\PCBLOGO.EXE. The reason for this is that PCBoard passes on parameters to a batch file that PCBLOGO needs access to. Place ELIM.EXE in a DOS accessible path eg C:\DOS\ELIM.EXE. The reason for this is that this program can be used for many other purposes besides this one and that it is actually a DOS "DEL" command that deletes files without a prompt. WARNING this program will not warn you when deleting a file or files, so be sure you know what you are deleting before you use it! Place DSZ.COM in a DOS accessible path. I placed my DSZ files all in a directory called C:\PROT for PROTOCOLS. The reason is that I use all the files and that I know sometime or another I will get more external protocols and will need a place to put them. Place PKZIP.EXE in a DOS accessible path. I placed my PKZIP files in a directory called C:\COMPRESS because I have many types of compressions available and would prefer to have them all in one location. Create an empty directory so that PCBLOGO has some place to work. This can be a RAM drive (Virtual Drive) or just a spot on the Hardrive but it must be in the root directory and be called; C:\T# where '#' is the number of the NODE you are using or "0" for NONE. Place all the *.BAT files that you received with this program into the same directory as PCBoard.EXE eg. C:\PCB\PCB??.BAT. We'll need to edit these batch files later on so make sure you have a backup of them somewhere. Now the hard part... Make sure all your download directories are 5 characters or less eg. C:\DL01 all CD-ROM's directories are numbered like; 001A, 001B, so you shouldn't have a problem unless all your hardrive has lengthy download directories like C:\PCB\DOWNLOAD\DIRECT16 then I am afraid your work is cut out for you. If you do have this problem, remember that every time you make a change to the directories you must reflect that in PCBoard's setup, under Main Conference. The reason the directories need to be soooo short is because PCBoard passes on 5 or 6 parameters, depending which version of PCBoard you are using; %1, %2, %3, %4, %5, %6 each containing information for the download. PCBLOGO adds two more parameters; %7 and %8 ie. %7 containing the original path of the ZIP file and %8 containing the New path for the ZIP file where the file was placed before downloading with the appended ZIP comment and AD. All these percents make one long command line for DOS and DOS can handle only so much in one command. Now because you need PCBLOGO to work with all PROTOCOLS including YMODEM and XMODEM you will need to tell PCBoard to shell out for these protocols instead of using it's own built in protocols, to do this you will need to run PCBSETUP.EXE and then select in the Main Menu "File Location 2" letter "C", from that list select "Name/Loc of Protocol Data File" which will have something like "C:\PCB\PCBPROT.DAT" once selected press [F2] to edit that file. Here is an example of what you'll see: PCBoard Setup Utility Edit Protocol File Port Lock Use Type Size MNP Open Lines Protocol Description ═══ ════ ════ ═══ ════ ═════ ════════════════════════════════════════════════════════════════ A I 128 N N N Ascii (Non-Binary) X S 128 N N N Xmodem (Checksum) C S 128 N N N Xmodem-CRC O S 1024 N N N 1K-Xmodem F S 1024 Y N N 1K-Xmodem/G Y D 1024 N N N Ymodem (Batch U/L and D/L) G D 1024 Y N N Ymodem/G (Batch U/L and D/L) Z D 90 N N N Zmodem (Batch U/L and D/L) Your setup will look a little different. We needed to change the "I"'s to "S"'s and "D"'s, under the title "Type" the reason for this is to tell PCBOARD to shell out to an external batch file which we'll get to in a bit. The "I" stands for "INTERNAL" and the "S" stands for "EXTERNAL" or single batch. The "D" means to create a DSZLOG and to allow Batch Transfers. NOTE * Make sure all "Lock lines" are set to "N" because this tells PCBoard to make room for Displaying PCBLOGO's Parameters. NOTE * The letters under the title "Use" are very important... they are the last letter referring to the BATCH FILES you'll have to make ie: v X = PCBSX.BAT Send Xmodem (Checksum) PCBRX.BAT Receive Xmodem (Checksum) C = PCBSC.BAT Send Xmodem-CRC PCBRC.BAT Receive Xmodem-CRC O = PCBSO.BAT Send 1k-Xmodem PCBRO.BAT Receive 1k-Xmodem F = PCBSF.BAT Send 1k-Xmodem/G PCBRF.BAT Receive 1k-Xmodem/G Y = PCBSY.BAT Send Ymodem PCBRY.BAT Receive Ymodem G = PCBSG.BAT Send Ymodem/G PCBRG.BAT Receive Ymodem/G Z = PCBSZ.BAT Send Zmodem (Included with PCBLOGO) PCBRZ.BAT Receive Zmodem (Included with PCBLOGO) Using the example batch files that came with this program "PCBSZ.BAT, PCBRZ.BAT" we'll do some simple modifications to them to make the rest of the Batch files. NOTE * There is no BATCH file for Ascii transfer due to the fact that Ascii is not used when downloading a ZIP file so make sure you have the Ascii Protocol set for Internal under the title "Type" type "I" Here is an example of PCBSZ.BAT (PCBoard Send Zmodem): @echo off if not x==%7x goto SKIP ┌Change this to reflect the name if @C:PCBDSZ.LST==%3 goto NEXT │of the Batch File you're editing: echo %3 > PCBDSZ.LST ├(X, C, O, F, Y, G, Z.) :NEXT └─┐ echo "%1","%2","%4","%5","%6","PCBSZ","C:\T1\" > PCBDSZ.DAT PCBLOGO.EXE ┌───┘│ :SKIP │Node number or "0" for NONE if XFER==%7 goto XFER ┌───────────> └Name of a Temp directory and if x==%7x goto END │ Location of the Temp Directory COPY %7 c:\T1┬──┬┬────┘ (keep this Path short!) if not exist c:\T1\*.zip goto END echo **** Adding (Your BBS Name Here) to %8 **** PKZIP /exzk %8 c:\logo\bbs-ad.doc <c:\logo\comment.txt goto END │ └───┬Path & Name of the ASCII File :XFER └───────────────────┐ └that you want as a ZIP Comment. if exist pcberr.fil del pcberr.fil └───┬Path & Name of the file that if exist pcbdsz.log del pcbdsz.log └you want added to the ZIP file. DSZ.COM port %1 speed %2 ha bo pB4096 estimate 0 %5 z sz %3 if exist pcbdsz.dat del pcbdsz.dat ┌──────────┴─┴┘ if exist c:\T1\*.* elim c:\T1\*.* └The above changes for each :END └──────────────┤ Protocol used ie: See Example above sx for Xmodem (Checksum) sx for Xmodem-CRC sb for Ymodem sx -k for 1k-Xmodem sb -k for Ymodem/G sx -k for 1k-Xmodem/G NOTE * The file you will be using for the ZIP comment must be ASCII (plain text) and nothing else The file you will be using to insert in the ZIP file is usually an Ad that can be a *.TXT, *.DOC, *.COM, *.EXE or what ever you want. Here is an Example of the PCBRZ.BAT (PCBoard Receive Zmodem): @echo off if exist pcberr.fil del pcberr.fil if exist pcbdsz.log del pcbdsz.log dsz.com port %1 speed %2 ha bo pB4096 estimate 0 %5 z pr1 rz -p %3 ├┘ This is the only command that needs to change ie: rx for Xmodem (Checksum) rx for 1k Xmodem rb for Ymodem rc for Xmodem-CRC rx -g for 1k Xmodem/G rb -g for Ymodem/G NOTE * All commands listed above, MUST BE IN SMALL LETTERS! Once you have made the necessary changes to all of the Batch Files and have installed all the programs in their proper directories and have made all the necessary changes to your PATH's and reflect those changes in your AUTOEXEC.BAT and created your ASCII comment as well as your AD Then you are ready to have someone call and Download their first file with PCBLOGO! NOTE * That the ShareWare version will not let you Batch Download files. (more than one at a time) and if you attempt it PCBLOGO will treat it as though it is one file and only Download the first file of the BATCH and ignore the rest, also PCBoard will see this and will State to the user "Transfer Aborted" even though he already receive the first file of the BATCH. Also with the Shareware version, there is a lengthy pause at the end of the download displaying the registration screen, this will make the user wait until the pause is completed. The registered program is MUCH FASTER and no pauses. How it Works ▀▀▀▀▀▀▀▀▀▀▀▀ Before I begin explaining how PCBLOGO works, I feel that an explanation of what PCBoard does is essential to make things easier to understand. First of all when someone is going to download a file from a Bulletin Board System running PCBoard 14.5, PCBoard shells out to a BATCH FILE passing 5 or 6 parameters depending which version of PCBoard you are using onto it, these parameter tells the batch file the com port you are using, the speed of your modem (DTE RATE), the file name and path to transfer (if it is a batch transfer (more then one) PCBoard instead of sending the file will create a log of all the file names to download in a file called "PCBDSZ.LST" and this is the file that will be sent to "DSZ.COM" instead of the actual ZIP file.) The last two parameters that are passed from PCBoard is the Connect Speed and the Carrier Speed. The Connect Speed is the speed in which the caller used to connect to your BBS. The Carrier Speed is the rate in which information is passed from one modem too the next. If you are running PCBoard/a then a 6th parameter is passed which contains your location for the private upload, this is usually used for Bimodem protocol. PCBLOGO will determin which version of PCBoard you are using and act accordinly. If you are using PCBoard/E or /D then the Parameter for Private Uploads or "PrvUpld" will state that there is "NONE" PCBLOGO takes all 5 or 6 of these parameters and passes them back to the batch file altering the %3 parameter (file name and path) to accommodate the C:\T# temporary directory where your Ads and Comments will be appended. PCBLOGO also adds two new parameters to the already existing 5 or 6; %7 and %8 the %7 is the original path and file name and the %8 is the new path and file name. You are probably wondering why would i repeat the old path and file name in %7 when %3 has already been altered? Well in a single download those parameters will remain the same, but in a Batch download a list is created including all the paths and names of the files being transferred... this list is the "PCBDSZ.LST" that PCBoard will create and send it to %3. PCBLOGO needs to know the new path and name for each ZIP file so that it can process each one separately and then pass the NEW PCBDSZ.LST that PCBLOGO recreated to DSZ.COM. * A MORE IN DEPTH EXPLANATION: If PCBLOGO detects a Batch Transfer it will first strip and create the new paths for downloads and send them to a file called "PCBDSZ.LST" and then will copy the first file from the batch over to the temporary directory which at that time will determine whether it is a ZIP file or something else ie; GIF, if it is something other than a ZIP file it will ignore it until it needs to be downloaded but if it is a ZIP then PKZIP will add the Comment and Ad to the ZIP file keeping the same ZIP date and AV code if there is one. PCBLOGO will do this to each and every file until it gets to the end of the batch where at that time it will send the recreated PCBDSZ.LST with the New paths to DSZ.COM and DSZ.COM will process each file in that list one at a time through the modem until it is done in which the ELIM.EXE program will first check to see if there are any files in the Temp or T# directory and if there is it will delete them. WARNING: ELIM.EXE will not warn you when it is about to delete a whole directory so be sure that the directory that your going to delete hasn't got any valuable programs stored in it. To sum the whole thing up... When PCBLOGO detects a single transfer then PCBLOGO will strip the original path to the file and add the New path where the temporary directory is. When PCBLOGO detects a Batch Transfer (more then one) it will do the same as above except instead of sending it directly to the batch file it will recreate the PCBDSZ.LST with the new paths and send that to DSZ.COM. Simple ay'... Not so... allot of time and effort was spent knowing exactly what PCBoard does when it shells out to a protocol and the explanation which I gave was put in simple terms. DISCLAIMER ▀▀▀▀▀▀▀▀▀▀ I FLETCHER S. JAMES WILL NOT BE LIABLE FOR ANY DAMAGES (INCLUDING DAMAGES TO HARDWARE OR SOFTWARE OR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION , LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM OR ANY OTHER PROGRAMS CREATED BY FLETCHER S. JAMES. BY USING THIS PROGRAM YOU HAVE AGREED WITH THESE STATEMENTS. POLICY ▀▀▀▀▀▀ There is none. Just enjoy the program and distribute it freely to anyone but without cost to that person with the exception of the cost of the diskette and please feel free to contact me for any comments you may have about my programs or improvements you may wish to express. REGISTRATION ▀▀▀▀▀▀▀▀▀▀▀▀ If you find this program useful and you wish to register it, for a small fee of $15.00, this will entitle you to: * The latest 'PCBLOGO.EXE' file with your Name * Batch Downloads (Download more than one file at a time) * No more irritating BELLS and WHISTLES * The Registration Screen will be removed * And the satisfaction of knowing your supporting the ShareWare Concept. To register your own copy of 'PCBLOGO'... Phone : VOICE (519)453-9947 OR BBS (519)453-7179 Make Cheque or Money Order Payable to: Compu-Enterprise 415 Briarhill, Ave., London, Ont. N5Y 1P3 * NOTE: Please indicate wether you want PCBLOGO registered in your name or the name of your BBS.