__________________________________________________ Þ\ \ Þ\ÛßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ Þ\Û ULP_PPE Version 1.5 beta by Michael Chen Û Þ\Û Û Þ\Û Compiled under PPLC Version 3.01 Beta Û \ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ ****************************************************************************** Note!: This program is intended for use in conjunction with ULP by Stacy Smith! ****************************************************************************** 1ST - I know these are perhaps the worst DOC's in the world. If I had more time I would make it more organized, easy to follow, etc. But I don't have that time unfortunately. Somethings might not make sense, or are hard to follow, and this DOC won't actually hold your hand through the process, although I've tried in the time I had to make it as easy to follow as possible. Regardless - If you have difficulty installing it (as some of you already have , leave me some mail on the nets (preferably Internet, see my address below), and I'll be happy to help you get it working. Those of you used to bad DOCs and can hold your own, will be able to get this setup working reasonably quickly. Legal Disclaimer ---------------- This program comes "as-is" and I will not be responsible for any damages or data loss that this program might cause. You try it at your own risk. FREEWARE -------- This PPE is FREEWARE meaning, absolutely free, and users of this program must not redistribute it as their own, sell it, or distribute modified versions of it without my consent. Introduction ------------ For those of you who wish to have a more informative display to show your users while they upload files to your system, this PPE will do just that. As you can see below, the ULP_PPE display also informs the uploader why the upload failed, immediately after the upload is tested, so no message is needed to be sent to the uploader later to inform them that they will not be receiving credit for their upload: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ PCBoard --> "Verifying PKZ204G.EXE...Failed!" ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ULP_PPE --> "Verifying PKZ204G.EXE...Failed! File exceeds age limits!" ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ In addition, it will send a canned message to the uploader informing them that their recent upload failed and why it failed via a private message in the Main Board Conference (0) from "UPLOAD PROCESSOR". In previous versions of ULP_PPE you had to use a third party utility like TXT2MSG by Robert Vostreys. But no more. Messages are now automatically sent via ULP_PPE. Makes for one less utility you need to manage :-). UPGRADING FROM PREVIOUS VERSIONS: --------------------------------- 1. Backup your customized ERROR# display files from the ULP_PPE directory. Also backup your ULP_PPE.CFG file. (either temporarily store it on floppy, a tmp directory, etc..) 2. Delete everything in your ULP_PPE directory and unzip this archive into that directory. NOW copy your ERROR# files you just backed up into the ULP_PPE directory again (overwriting the ERROR# files just unziped). Also copy your ULP_PPE.CFG file you just backedup into the ULP_PPE directory again (overwriting the ULP_PPE.CFG file you just unziped). 3. Edit the NEW "ERROR#.TXT" files you just unziped from the ERRORTXT.ZIP archive. They are canned messages that will be sent to the uploader letting them know their upload failed and why it failed. 4. Copy the included copy of PCBTEST.BAT over your current copy and go to Installation step #7. 5. Go through the installation process, to double check to make sure everything is in order and done correctly. Make sure files are where they should be, and edited the way they should be. 6. NEW!! - Add ONE OF the following lines to your $$LOGOFF.BAT file!! : ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ³ ³1) PCBOARDM PPE:D:\PCB\PPL\ULPPPE\ULP_PPE.PPE;/SENDMSG ³ ³ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ³ ³ OR ³ ³ ³ ³2) PCBOARD PPE:D:\PCB\PPL\ULPPPE\ULP_PPE.PPE;/SENDMSG ³ ³ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ First of all... Depending on which PCBoard executable you use (PCBOARDM.EXE or PCBOARD.EXE) select the appropriate line for you. If you use PCBOARD.EXE then you will want to add example line #2 above to your $$LOGOFF.BAT file. If you use PCBOARDM.EXE then you will want to add example line #1 to your $$LOGOFF.BAT file. Secondly... You will want to change the part underscored with the ^ characters with the path to where you have installed ULP_PPE and don't forget to include the name of the PPE itself (ULP_PPE.PPE)! 7. Give it a whirl. You now have a complete system, alerting callers of failed uploads and why they failed. In addition, the uploader with the failed upload will get a private message sent to them from "UPLOAD PROCESSOR" in the main board, letting them know that their upload failed, and why it failed. : you can also give them hints in this message on how to avoid the same failures in the future (i.e. Tell them to make sure the use acceptable compression programs to zip up their archives and not ones that you don't accept.) Installation: ------------- 1. Create a directory for this PPE (Example: "D:\PPE\ULP_PPE\") and unzip the contents of this archive (ULP_PPE.ZIP) into that directory. 2. Place the file "$$ULP$$" included in this archive, anywhere you want, however, I'd recommend putting it in either the same directory this PPE is in, or in your ULP directory. Note: This file ($$ULP$$) is a dummy file. If you ever lose it or delete it by accident, don't worry, just create another file named "$$ULP$$" and make sure the size is more than 0 bytes, by filling it with a couple of characters at least. 3. Edit the ULP_PPE.CFG file included in this archive, with the complete path to where you decided to place the $$ULP$$ from step 2. Note!: All you need is to enter one line (on row 1, column 1) with the PATH leading to where-ever you decided to place the "$$ULP$$" file from mentioned in step 2. Two IMPORTANT things to keep in mind!: a) enter only the PATH and NOT the filename. b) Also, at the end of the PATH, you must end it with a "\". (Example: "D:\PPE\ULP_PPE\$$ULP$$\") 4. Unzip the archive included in the "ULP_PPE.ZIP" archive, named "ERRORTXT.ZIP" into the directory you created for ULP_PPE. 5. Edit the "ERROR#" upload status display files that you unzipped from the archive (ERRORTXT.ZIP) to your own preferences. These are the files that will be displayed when an upload fails. Note: The naming convention of the "ERROR#" files is determined by the ERRORLEVEL from ULP. For example: ULP errorlevel 5 means a duplicate was detected, therefore the corresponding "ERROR#" file would be "ERROR5". This way you can easily remember which "ERROR#" file displays what, by simply refering to the ULP.DOC that comes with ULP. Here's another note. If you use PCBEDIT to edit these files, make sure you use the PCBEDIT command-line parameter /LLEND:26 so that the file has no extra lines in it. If you don't do this there will be a blank line in between each upload status line, looking like this: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ "Verifying PKZ204G.EXE...FAILED! Upload is a duplicate" ³ ³blank line -> ³ ³ "Verifying ALLFILES.ZIP...FAILED! Upload is a duplicate" ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ If you use the PCBEDIT command-line parameter /LLEND:26, then that blank line above will not exist, so your display will look like this: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ no blank line -> "Verifying PKZ204G.EXE...FAILED! Upload is a duplicate" ³ ³ "Verifying ALLFILES.ZIP...FAILED! Upload is a duplicate"³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ I suppose it all depends on personal taste and preference, but if you want it to display the way PCBoard does it, then you'll want to get rid of the blank lines by using /LLEND:26 when editing the "ERROR#" files. 5b. Edit the "ERROR#.TXT" files you unzipped from the archive ERRORTXT.ZIP to your own preferences. These are the canned private messages that will be inserted into the Main Board Conference (0) for the uploader who had the failed upload. Messages will be from "UPLOAD PROCESSOR". 6. Edit PCBTEXT record #577 with the complete path and filename to execute ULP_PPE. (Example: "!D:\PPE\ULP_PPE\ULP_PPE.PPE"). 7. In the included PCBTEST.BAT file, change all occurences of my path: "3party\ulp\failtxt" to the path where you elected to place your $$ULP$$ file. So for example, if your $$ULP$$ file is located in "D:\ULP\ULPPPE\" then that is what you will replace all occurrences of my own path of "3party\ulp\failtxt" with. Secondly, change the first line after the @echo off in the PCBTEST.BAT file. It should be the line that runs ULPTEST, which looks like this: "D:\3party\ulp\ulptest -cD:\3party\ulp\ulp.cfg -F%1 -M%1 -D%1 -N%PCBNODE%" ^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^ Change the paths underscored with ^ to reflect the paths in YOUR system. 8. NEW!! - Add ONE OF the following lines to your $$LOGOFF.BAT file!! : ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ³ ³1) PCBOARDM PPE:D:\PCB\PPL\ULPPPE\ULP_PPE.PPE;/SENDMSG ³ ³ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ³ ³ OR ³ ³ ³ ³2) PCBOARD PPE:D:\PCB\PPL\ULPPPE\ULP_PPE.PPE;/SENDMSG ³ ³ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ First of all... Depending on which PCBoard executable you use (PCBOARDM.EXE or PCBOARD.EXE) select the appropriate line for you. If you use PCBOARD.EXE then you will want to add example line #2 above to your $$LOGOFF.BAT file. If you use PCBOARDM.EXE then you will want to add example line #1 to your $$LOGOFF.BAT file. Secondly... You will want to change the part underscored with the ^ characters with the path to where you have installed ULP_PPE and don't forget to include the name of the PPE itself (ULP_PPE.PPE)! ---------------------------------------------------------------------------- You're now ready to give it a whirl! If things don't work out on the first try, double check your PATHS to make sure they're correct, since it is essential to this PPE's operation. ALL I ASK --------- If you find this program of use, all I ask is that you let me know how it's working for you, if you have any suggestions, comments, etc. I can be reached in these ways: =============================================================== Internet - michael.chen@misbbs.com FIDO - 1:161/510 Rime - METROPOLIS Salt Air BBS (801) 261-8976 The Metropolis Information System (My Board) (510) 231-0353 ================================================================ SUPPORT ------- As a FREEWARE program, I make no promises of support, and am under no obligation to provide any. However, as time permits, I will "support" the program and help get you up and running. UPDATES ------- Updates when available, are released on Salt Air BBS and BBP (the ULP Support BBS). COMING SOON? ------------ Depending on the future development of ULP and/or PCBoard itself, I might add the ability to have the names of the failed files INCLUDED into the canned messages somehow. Right now, if you have a user upload 10 files yesterday, and get a message from ULP_PPE saying that their upload failed due to being a duplicate, they won't know which file it was, you'll have to go through your ULP-WORK logs to find out for them. On the other hand if they just uploaded one file, then they'll know which one it was . This can't be avoided right now, but I'll see if I can't talk either CDC or Stacy Smith into adding some code to achieve this some how. LAST WORDS ---------- I'd hate to see anyone give up on this after one unsuccessful installation. So write me netmail if you get stuck, and I'll see if we can't get it setup on your system.