home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / pcblogo2.zip / PCBLOGO.DOC < prev    next >
Text File  |  1992-07-01  |  21KB  |  414 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   PCBLOGO v2.0
  8.                                 Copyright @ 1992
  9.                              by: Fletcher S. James
  10.                               All Rights Reserved
  11.     ----------------------------------------------------------------------
  12.  
  13.  
  14.                                What is PCBLOGO???
  15.                                ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  16.  
  17.          PCBLOGO is a fast and easy way to insert a ZIP comments and other
  18.     files such as Ads to your already existing ZIP file just before it is
  19.     downloaded from the BBS.
  20.  
  21.          PCBLOGO was primarily written to aid in inserting advertisement in
  22.     CD-ROM files before they get downloaded from the BBS, but if you don't
  23.     have a CD-ROM, don't worry, this program you'll find very useful.
  24.  
  25.     Here are the reasons:
  26.  
  27.     #1 - An Advantage over the rest!
  28.  
  29.          Not only does PCBLOGO add ZIP Comments to your files, but it can
  30.     also append a file of your own accord inside the ZIP file.  The reason
  31.     for this is that a ZIP comment is only seeing when the file is unzipped
  32.     and only for a brief time.  An appended file can be viewed as many
  33.     times as the user wants to view it, also it makes a great Ad if the
  34.     file is uploaded to another BBS! (chuckle)
  35.  
  36.     #2 - PCBLOGO lets you save disk space!
  37.  
  38.          Lets say that all the files on your hardrive have your ZIP Comment
  39.     or Ad appended to them and each file was 2k (2000 bytes) or more and
  40.     you had 17,000 files each with this 2k file, well with good ole
  41.     Mathematics we can figure that 2 x 17,000 = 34,000k or (34,000,000
  42.     bytes) which is 3.4 meg used just for Ads or Comments...WOW!!!
  43.     PCBLOGO lets those ZIP Comments and Ads be appended just before a
  44.     download and then deletes the ZIP file leaving the original ZIP file
  45.     still intact.
  46.  
  47.     #3 - Your Ad will always be up-to-date!
  48.  
  49.          Lets say that all your files had your old Ad in the ZIP files and
  50.     it is now time for a new Ad because your BBS has changed since that
  51.     time.  What would you do?  just leave them?  With PCBLOGO whenever you
  52.     change your Ad, PCBLOGO will always append the revised Ad to the ZIP
  53.     file just before a download.
  54.  
  55.     #4 - Time Saver!
  56.  
  57.          Lets say you just received some new files from an old friend on
  58.     disk and you need to put them in your BBS.  Usually you would have to
  59.     add your comments or Ads as soon as you received them but with PCBLOGO
  60.     now you can put your newly received files in your download directories
  61.     and PCBLOGO will make sure the Ad or comment is Appended before a
  62.     download.
  63.  
  64.                          Files Contained in this Arcive
  65.                          ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  66.  
  67.          * PCBLOGO.EXE  - The Executionable File
  68.          * PCBLOGO.DOC  - This File you're Reading
  69.          * HISTORY.DOC  - Revisions of PCBLOGO
  70.          * REGISTER.DOC - Registration for PCBLOGO
  71.          * PCBSZ.BAT    - An Example of PCBoard's Send Zmodem Batch File
  72.          * PCBRZ.BAT    - An Example of PCBoard's Receive Zmodem Batch
  73.          * ELIM.EXE     - A Program which will erase whole directories
  74.          * ELIM.DOC     - The Maunal on how to use ELIM.EXE by Bob Eyer
  75.  
  76.          NOTE * If you find you're missing any of these files please
  77.                 contact me at the address below.
  78.  
  79.                                What Will I Need?
  80.                                ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  81.  
  82.          * IBM PC AT/XT OR COMPATIBLE
  83.          * 640K OF MEMORY OR GREATER
  84.          * 80 COLUMN MONITOR
  85.          * HARDRIVE OF ANY SIZE
  86.  
  87.          * PCBLOGO.EXE ver. 2.0 by: Fletcher James (included)
  88.          * ELIM.EXE ver.  2.0 by: Bob Eyer (included)
  89.          * PCBoard ver.  14.xx by: Clark Development Co., Inc.
  90.          * DSZ0427.ZIP by: Omen Technology Inc. Chuck Forsberg (DSZ.COM)
  91.          * PKZ110.EXE ver. 1.10 by: PKWARE Inc. (PKZIP.EXE)
  92.  
  93.                                   Installation
  94.                                   ▀▀▀▀▀▀▀▀▀▀▀▀
  95.  
  96.          Installing PCBLOGO is a snap!... Batch files are included with
  97.     this program to make life easier, as well you probably have most of the
  98.     installation already done if you're already using some of the programs
  99.     needed for PCBLOGO, but if not, then I will take you step by step to
  100.     see that you have everything up and going.
  101.  
  102.          First off, you must find a directory or directories for the
  103.     following files and have those directories in the DOS PATH;
  104.     PCBLOGO.EXE, ELIM.EXE, PCBOARD.EXE, DSZ.COM, PKZIP.EXE.  If your not
  105.     sure how to install a DOS path in your AUTOEXEC.BAT then refer to your
  106.     DOS Manual.
  107.  
  108.          Place PCBLOGO.EXE in the directory where PCBoard.EXE resides eg.
  109.     C:\PCB\PCBLOGO.EXE. The reason for this is that PCBoard passes on
  110.     parameters to a batch file that PCBLOGO needs access to.
  111.  
  112.          Place ELIM.EXE in a DOS accessible path eg C:\DOS\ELIM.EXE.  The
  113.     reason for this is that this program can be used for many other
  114.     purposes besides this one and that it is actually a DOS "DEL" command
  115.     that deletes files without a prompt.  WARNING this program will not
  116.     warn you when deleting a file or files, so be sure you know what you
  117.     are deleting before you use it!
  118.  
  119.          Place DSZ.COM in a DOS accessible path. I placed my DSZ files all
  120.     in a directory called C:\PROT for PROTOCOLS.  The reason is that I use
  121.     all the files and that I know sometime or another I will get more
  122.     external protocols and will need a place to put them.
  123.  
  124.          Place PKZIP.EXE in a DOS accessible path. I placed my PKZIP files
  125.     in a directory called C:\COMPRESS because I have many types of
  126.     compressions available and would prefer to have them all in one
  127.     location.
  128.  
  129.          Create an empty directory so that PCBLOGO has some place to work.
  130.     This can be a RAM drive (Virtual Drive) or just a spot on the Hardrive
  131.     but it must be in the root directory and be called; C:\T# where '#' is
  132.     the number of the NODE you are using or "0" for NONE.
  133.  
  134.          Place all the *.BAT files that you received with this program into
  135.     the same directory as PCBoard.EXE eg. C:\PCB\PCB??.BAT. We'll need to
  136.     edit these batch files later on so make sure you have a backup of them
  137.     somewhere.
  138.  
  139.          Now the hard part... Make sure all your download directories are
  140.     5 characters or less eg. C:\DL01 all CD-ROM's directories are numbered
  141.     like; 001A, 001B, so you shouldn't have a problem unless all your
  142.     hardrive has lengthy download directories like C:\PCB\DOWNLOAD\DIRECT16
  143.     then I am afraid your work is cut out for you.
  144.  
  145.          If you do have this problem, remember that every time you make a
  146.     change to the directories you must reflect that in PCBoard's setup,
  147.     under Main Conference.
  148.  
  149.          The reason the directories need to be soooo short is because
  150.     PCBoard passes on 5 or 6 parameters, depending which version of PCBoard
  151.     you are using; %1, %2, %3, %4, %5, %6 each containing information for
  152.     the download.  PCBLOGO adds two more parameters; %7 and %8 ie. %7
  153.     containing the original path of the ZIP file and %8 containing the New
  154.     path for the ZIP file where the file was placed before downloading with
  155.     the appended ZIP comment and AD. All these percents make one long
  156.     command line for DOS and DOS can handle only so much in one command.
  157.  
  158.          Now because you need PCBLOGO to work with all PROTOCOLS including
  159.     YMODEM and XMODEM you will need to tell PCBoard to shell out for these
  160.     protocols instead of using it's own built in protocols, to do this you
  161.     will need to run PCBSETUP.EXE and then select in the Main Menu "File
  162.     Location 2" letter "C", from that list select "Name/Loc of Protocol
  163.     Data File" which will have something like "C:\PCB\PCBPROT.DAT" once
  164.     selected press [F2] to edit that file.
  165.  
  166.     Here is an example of what you'll see:
  167.  
  168.                                     PCBoard Setup Utility
  169.                                      Edit Protocol File
  170.  
  171.                            Port Lock
  172.          Use Type Size MNP Open Lines             Protocol Description
  173.          ═══ ════ ════ ═══ ════ ═════
  174.          ════════════════════════════════════════════════════════════════
  175.           A   I    128  N   N     N   Ascii (Non-Binary)
  176.           X   S    128  N   N     N   Xmodem (Checksum)
  177.           C   S    128  N   N     N   Xmodem-CRC
  178.           O   S   1024  N   N     N   1K-Xmodem
  179.           F   S   1024  Y   N     N   1K-Xmodem/G
  180.           Y   D   1024  N   N     N   Ymodem          (Batch U/L and D/L)
  181.           G   D   1024  Y   N     N   Ymodem/G        (Batch U/L and D/L)
  182.           Z   D     90  N   N     N   Zmodem          (Batch U/L and D/L)
  183.  
  184.          Your setup will look a little different.  We needed to change the
  185.     "I"'s to "S"'s and "D"'s, under the title "Type" the reason for this
  186.     is to tell PCBOARD to shell out to an external batch file which we'll
  187.     get to in a bit.  The "I" stands for "INTERNAL" and the "S" stands for
  188.     "EXTERNAL" or single batch.  The "D" means to create a DSZLOG and to
  189.     allow Batch Transfers.
  190.  
  191.          NOTE * Make sure all "Lock lines" are set to "N" because this
  192.                 tells PCBoard to make room for Displaying PCBLOGO's
  193.                 Parameters.
  194.  
  195.  
  196.          NOTE * The letters under the title "Use" are very important...
  197.                 they are the last letter referring to the BATCH FILES
  198.                 you'll have to make ie:
  199.                            v
  200.                    X = PCBSX.BAT   Send      Xmodem (Checksum)
  201.                        PCBRX.BAT   Receive   Xmodem (Checksum)
  202.                    C = PCBSC.BAT   Send      Xmodem-CRC
  203.                        PCBRC.BAT   Receive   Xmodem-CRC
  204.                    O = PCBSO.BAT   Send      1k-Xmodem
  205.                        PCBRO.BAT   Receive   1k-Xmodem
  206.                    F = PCBSF.BAT   Send      1k-Xmodem/G
  207.                        PCBRF.BAT   Receive   1k-Xmodem/G
  208.                    Y = PCBSY.BAT   Send      Ymodem
  209.                        PCBRY.BAT   Receive   Ymodem
  210.                    G = PCBSG.BAT   Send      Ymodem/G
  211.                        PCBRG.BAT   Receive   Ymodem/G
  212.                    Z = PCBSZ.BAT   Send      Zmodem (Included with PCBLOGO)
  213.                        PCBRZ.BAT   Receive   Zmodem (Included with PCBLOGO)
  214.  
  215.          Using the example batch files that came with this program
  216.     "PCBSZ.BAT, PCBRZ.BAT" we'll do some simple modifications to them to
  217.     make the rest of the Batch files.
  218.  
  219.          NOTE * There is no BATCH file for Ascii transfer due to the fact
  220.                 that Ascii is not used when downloading a ZIP file so make
  221.                 sure you have the Ascii Protocol set for Internal under the
  222.                 title "Type" type "I"
  223.  
  224.     Here is an example of PCBSZ.BAT (PCBoard Send Zmodem):
  225.  
  226.     @echo off
  227.     if not x==%7x goto SKIP          ┌Change this to reflect the name
  228.     if @C:PCBDSZ.LST==%3 goto NEXT   │of the Batch File you're editing:
  229.     echo %3 > PCBDSZ.LST             ├(X, C, O, F, Y, G, Z.)
  230.     :NEXT                            └─┐
  231.     echo "%1","%2","%4","%5","%6","PCBSZ","C:\T1\" > PCBDSZ.DAT
  232.     PCBLOGO.EXE                           ┌───┘│
  233.     :SKIP                                 │Node number or "0" for NONE
  234.     if XFER==%7 goto XFER ┌───────────>   └Name of a Temp directory and
  235.     if x==%7x goto END    │                Location of the Temp Directory
  236.     COPY %7 c:\T1┬──┬┬────┘                (keep this Path short!)
  237.     if not exist c:\T1\*.zip goto END
  238.     echo **** Adding (Your BBS Name Here) to %8 ****
  239.     PKZIP /exzk %8 c:\logo\bbs-ad.doc <c:\logo\comment.txt
  240.     goto END       │                   └───┬Path & Name of the ASCII File
  241.     :XFER          └───────────────────┐   └that you want as a ZIP Comment.
  242.     if exist pcberr.fil del pcberr.fil └───┬Path & Name of the file that
  243.     if exist pcbdsz.log del pcbdsz.log     └you want added to the ZIP file.
  244.     DSZ.COM port %1 speed %2 ha bo pB4096 estimate 0 %5 z sz %3
  245.     if exist pcbdsz.dat del pcbdsz.dat       ┌──────────┴─┴┘
  246.     if exist c:\T1\*.* elim c:\T1\*.*        └The above changes for each
  247.     :END     └──────────────┤                 Protocol used ie:
  248.                             See Example above    sx for Xmodem (Checksum)
  249.                                                  sx for Xmodem-CRC
  250.                      sb for Ymodem            sx -k for 1k-Xmodem
  251.                   sb -k for Ymodem/G          sx -k for 1k-Xmodem/G
  252.  
  253.          NOTE * The file you will be using for the ZIP comment must be
  254.                 ASCII (plain text) and nothing else
  255.  
  256.                 The file you will be using to insert in the ZIP file is
  257.                 usually an Ad that can be a *.TXT, *.DOC, *.COM, *.EXE
  258.                 or what ever you want.
  259.  
  260.     Here is an Example of the PCBRZ.BAT (PCBoard Receive Zmodem):
  261.  
  262.     @echo off
  263.     if exist pcberr.fil del pcberr.fil
  264.     if exist pcbdsz.log del pcbdsz.log
  265.     dsz.com port %1 speed %2 ha bo pB4096 estimate 0 %5 z pr1 rz -p %3
  266.                                                               ├┘
  267.                                                  This is the only command
  268.                                                  that needs to change ie:
  269.  
  270.     rx for Xmodem (Checksum)    rx for 1k Xmodem       rb for Ymodem
  271.     rc for Xmodem-CRC        rx -g for 1k Xmodem/G  rb -g for Ymodem/G
  272.  
  273.          NOTE * All commands listed above, MUST BE IN SMALL LETTERS!
  274.  
  275.          Once you have made the necessary changes to all of the Batch Files
  276.     and have installed all the programs in their proper directories and
  277.     have made all the necessary changes to your PATH's and reflect those
  278.     changes in your AUTOEXEC.BAT and created your ASCII comment as well as
  279.     your AD Then you are ready to have someone call and Download their
  280.     first file with PCBLOGO!
  281.  
  282.          NOTE * That the ShareWare version will not let you Batch Download
  283.                 files. (more than one at a time) and if you attempt it
  284.                 PCBLOGO will treat it as though it is one file and only
  285.                 Download the first file of the BATCH and ignore the rest,
  286.                 also PCBoard will see this and will State to the user
  287.                 "Transfer Aborted" even though he already receive the first
  288.                 file of the BATCH.
  289.  
  290.                 Also with the Shareware version, there is a lengthy pause
  291.                 at the end of the download displaying the registration
  292.                 screen, this will make the user wait until the pause is
  293.                 completed.  The registered program is MUCH FASTER and no
  294.                 pauses.
  295.  
  296.                                   How it Works
  297.                                   ▀▀▀▀▀▀▀▀▀▀▀▀
  298.  
  299.          Before I begin explaining how PCBLOGO works, I feel that an
  300.     explanation of what PCBoard does is essential to make things easier to
  301.     understand.
  302.  
  303.          First of all when someone is going to download a file from a
  304.     Bulletin Board System running PCBoard 14.5, PCBoard shells out to a
  305.     BATCH FILE passing 5 or 6 parameters depending which version of PCBoard
  306.     you are using onto it, these parameter tells the batch file the com
  307.     port you are using, the speed of your modem (DTE RATE), the file name
  308.     and path to transfer (if it is a batch transfer (more then one) PCBoard
  309.     instead of sending the file will create a log of all the file names to
  310.     download in a file called "PCBDSZ.LST" and this is the file that will
  311.     be sent to "DSZ.COM" instead of the actual ZIP file.)  The last two
  312.     parameters that are passed from PCBoard is the Connect Speed and the
  313.     Carrier Speed.  The Connect Speed is the speed in which the caller used
  314.     to connect to your BBS.  The Carrier Speed is the rate in which
  315.     information is passed from one modem too the next.  If you are running
  316.     PCBoard/a then a 6th parameter is passed which contains your location
  317.     for the private upload, this is usually used for Bimodem protocol.
  318.     PCBLOGO will determin which version of PCBoard you are using and act
  319.     accordinly.  If you are using PCBoard/E or /D then the Parameter for
  320.     Private Uploads or "PrvUpld" will state that there is "NONE"
  321.  
  322.          PCBLOGO takes all 5 or 6 of these parameters and passes them back
  323.     to the batch file altering the %3 parameter (file name and path) to
  324.     accommodate the C:\T# temporary directory where your Ads and Comments
  325.     will be appended.
  326.  
  327.          PCBLOGO also adds two new parameters to the already existing 5 or
  328.     6; %7 and %8 the %7 is the original path and file name and the %8 is
  329.     the new path and file name.  You are probably wondering why would i
  330.     repeat the old path and file name in %7 when %3 has already been
  331.     altered?  Well in a single download those parameters will remain the
  332.     same, but in a Batch download a list is created including all the paths
  333.     and names of the files being transferred... this list is the
  334.     "PCBDSZ.LST" that PCBoard will create and send it to %3.  PCBLOGO needs
  335.     to know the new path and name for each ZIP file so that it can process
  336.     each one separately and then pass the NEW PCBDSZ.LST that PCBLOGO
  337.     recreated to DSZ.COM.
  338.  
  339.     * A MORE IN DEPTH EXPLANATION:
  340.  
  341.          If PCBLOGO detects a Batch Transfer it will first strip and create
  342.     the new paths for downloads and send them to a file called "PCBDSZ.LST"
  343.     and then will copy the first file from the batch over to the temporary
  344.     directory which at that time will determine whether it is a ZIP file or
  345.     something else ie; GIF, if it is something other than a ZIP file it
  346.     will ignore it until it needs to be downloaded but if it is a ZIP then
  347.     PKZIP will add the Comment and Ad to the ZIP file keeping the same ZIP
  348.     date and AV code if there is one.  PCBLOGO will do this to each and
  349.     every file until it gets to the end of the batch where at that time it
  350.     will send the recreated PCBDSZ.LST with the New paths to DSZ.COM and
  351.     DSZ.COM will process each file in that list one at a time through the
  352.     modem until it is done in which the ELIM.EXE program will first check
  353.     to see if there are any files in the Temp or T# directory and if there
  354.     is it will delete them.
  355.  
  356.     WARNING: ELIM.EXE will not warn you when it is about to delete a
  357.              whole directory so be sure that the directory that your going
  358.              to delete hasn't got any valuable programs stored in it.
  359.  
  360.          To sum the whole thing up... When PCBLOGO detects a single
  361.     transfer then PCBLOGO will strip the original path to the file and add
  362.     the New path where the temporary directory is.  When PCBLOGO detects a
  363.     Batch Transfer (more then one) it will do the same as above except
  364.     instead of sending it directly to the batch file it will recreate the
  365.     PCBDSZ.LST with the new paths and send that to DSZ.COM.
  366.  
  367.          Simple ay'... Not so... allot of time and effort was spent knowing
  368.     exactly what PCBoard does when it shells out to a protocol and the
  369.     explanation which I gave was put in simple terms.
  370.  
  371.                                    DISCLAIMER
  372.                                    ▀▀▀▀▀▀▀▀▀▀
  373.  
  374.          I FLETCHER S. JAMES WILL NOT BE LIABLE FOR ANY DAMAGES (INCLUDING
  375.     DAMAGES TO HARDWARE OR SOFTWARE OR LOSS OF BUSINESS PROFITS, BUSINESS
  376.     INTERRUPTION , LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS)
  377.     ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM OR ANY
  378.     OTHER PROGRAMS CREATED BY FLETCHER S. JAMES.
  379.          BY USING THIS PROGRAM YOU HAVE AGREED WITH THESE STATEMENTS.
  380.  
  381.                                      POLICY
  382.                                      ▀▀▀▀▀▀
  383.  
  384.          There is none.  Just enjoy the program and distribute it freely to
  385.     anyone but without cost to that person with the exception of the cost
  386.     of the diskette and please feel free to contact me for any comments you
  387.     may have about my programs or improvements you may wish to express.
  388.  
  389.                                   REGISTRATION
  390.                                   ▀▀▀▀▀▀▀▀▀▀▀▀
  391.  
  392.          If you find this program useful and you wish to register it,  for
  393.     a small fee of $15.00, this will entitle you to:
  394.  
  395.          * The latest 'PCBLOGO.EXE' file with your Name
  396.          * Batch Downloads (Download more than one file at a time)
  397.          * No more irritating BELLS and WHISTLES
  398.          * The Registration Screen will be removed
  399.          * And the satisfaction of knowing your supporting the
  400.            ShareWare Concept.
  401.  
  402.          To register your own copy of 'PCBLOGO'...
  403.                                                Phone : VOICE (519)453-9947
  404.                         OR                             BBS   (519)453-7179
  405.  
  406.          Make Cheque or Money Order Payable to:
  407.                                                Compu-Enterprise
  408.                                                415 Briarhill, Ave.,
  409.                                                London, Ont.
  410.                                                N5Y 1P3
  411.  
  412.          * NOTE: Please indicate wether you want PCBLOGO registered in your
  413.                  name or the name of your BBS.
  414.