ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý[CWTU]Þ±±° Custom Weekly Top Users (Bulletin) PPE (c)1993-94 °±±Ý[CWTU]Þ±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Þ³ úúúúúúúù Custom Weekly Top Users ùúúúúúúúúúú ³ Author: Robert Hunter ³Ý Þ³ úúúúúúúúù Version: 1.00 Standard ùúúúúúúúúúú ³ a.k.a: Midnight Slasher ³Ý Þ³ úúúúúúúúúúúúúúù [11/15/94] ùúúúúúúúúúúúúúúúú ³ E-Mail: mslasher@io.org ³Ý ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Þ³ CONTENTS ³ 1. Files Included 5. Distribution ³Ý Þ³ OF ³ 2. Brief Program Summary 6. Legal-ese ³Ý Þ³ DOCUMENTATION ³ 3. Installation 7. Registration / Author Notes ³Ý Þ³ ³ 4. General Program Info ³Ý ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý FILES INCLUDED Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Þ³ CWTU.COL ..... 1,112 .. Main Color Configuration File Þ³ CWTU.DAT ....... 474 .. Main Data Configuration File Þ³ CWTU.DOC .... 14,386 .. Documentation / Installation Guide (Please Read) Þ³ CWTU.PPE .... 23,614 .. Bulletin Generator PPE Þ³ _CWTU.EXC ........ 22 .. Exclusion List File (Optional) Þ³ FILE_ID.DIZ ..... 462 .. Description Identification File ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý PROGRAM SUMMARY Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ A .PPE (* PCBoard Programming Language Executable *) for PCBoard v15.2+ BBS. This program runs in your logoff sequence. It has the ability to create a bulletin of either the Weekly Top Uploaders (measured in _Bytes_ ) or Weekly Top Downloaders (measured in _Bytes_ ) or both. It runs during each user's logoff process, and once daily, will perform a total cycle which evaluates all users and creates totals for the day. (this can also be run more times per day if you want more current results). ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý INSTALLATION Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This PPE requires the installation of TPA(s) into your user file. They are used to store raw data. If you wish to use this PPE to keep track of the Weekly Top Uploaders, you must install the CWTU TPA. If you wish to keep track of the Weekly Top Downloaders, you must install the CWTD TPA. You must install BOTH TPAs if you want to use this PPE to create both bulletins. TPAs are easy to install, and just as easy to un-install if you do not wish to use this PPE. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Installing the CWTU TPA: All nodes must be down/at the Call Waiting screen. It is a one time install into your users.inf file. This TPA is used for the Weekly Top *UPLOADERS*. 1. Run PCBSM 2. Press D ( User Info File Maintenance ) 3. Press E ( Add/Update Third Party Application ) 4. Enter the name of the Third Party Application: CWTU 5. Version : 1 Static Size : 15 Dynamic Size : 0 Keyword : CWTU 6. Press PGDN ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Installing the CWTD TPA: All nodes must be down/at the Call Waiting screen. It is a one time install into your users.inf file. This TPA is used for the Weekly Top *DOWNLOADERS*. 1. Run PCBSM 2. Press D ( User Info File Maintenance ) 3. Press E ( Add/Update Third Party Application ) 4. Enter the name of the Third Party Application: CWTD 5. Version : 1 Static Size : 15 Dynamic Size : 0 Keyword : CWTD 6. Press PGDN ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This PPE must be installed in the logoff procedure. There are many ways to accomplish this task, one being: 1. Load all your PCBTEXT file(s) into MKPCBTXT.EXE (MKPCBTXT in /PCB/GEN) 2. Go to record entry #192 (Press F3 and then 192) 3. Replace the line: ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ Record No: 192 Record Length: 40 Justification: Left ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ Minutes Used: @OPTEXT@ ³ ³ %DRIVE:\PATH\LOGOFF.TXT ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ 4. Edit LOGOFF.TXT in a text editor so that it looks like: ----------------- Minutes Used: @OPTEXT@ !DRIVE:\PATH\CWTU.PPE (Command Line Parameters) ----------------- Possible Command Line Parameters: --------------------------------- /U ...... Process the Weekly Top Uploaders /D ...... Process the Weekly Top Downloaders /RUN .... Force a Complete Cycle/Bulletin Update (Do not use in logoff.txt) /NHU .... No Hang Up during Processing /ASCII .. Output Bulletins will use Ascii Characters (Instead of ANSI) This makes it easy to add other PPEs into your logoff sequence, simply by adding them to the LOGOFF.TXT file. Example: If you have installed both TPAs and want the PPE to update both the UL and DL bulletins, use the following in your logoff.txt: !DRIVE:\PATH\CWTU.PPE /U /D or if you want ASCII bulletins: !DRIVE:\PATH\CWTU.PPE /U /D /ASCII ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You can then EDIT the CWTU.DAT file and CWTU.COL file to change the running configuration and color configuration for the bulletin(s). Instructions are contained within both of these files. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You then must display the output bulletins (wherever you want them placed) on your board. If you want them as bulletins, you can set them up in your BLT.LST file. (PCBSETUP - Select a Conference - Setup the bulletin by pressing F2 on the Bulletin Path/Lst file) You can also display one (or more) during the logon process, by inserting a: %DRIVE:\PATH\CWTU.BLT or %DRIVE:\PATH\CWTD.BLT ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý GENERAL PROGRAM INFORMATION Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 1. General Operation ----------------------------------------------------------------------------- When the program is run, it first looks in the .PTR file that it creates to see when it was last run. (The .PTR file just lists the last date that the program generated the bulletins). If proper command line parameters are given, it will search its own data base after each logoff and see if the bulletins must be updated. If its a new day (or its time to do a Total Cycle according to what the .DAT file says) it will cycle through all the users in the user file and re-update the bulletins along with the Total's information which is contained in the header file of the bulletin. A total cycle only has to be done ONCE a day. The program will automatically update the bulletins after each call (providing they need to be updated). You can have a total cycle run more than once per day -- the only thing that will be updated are the running totals. Since the program uses a pointer file that can rely on the system date and time, please make sure to set all workstations to use a central SysTime or problems (repetitous total cycles) may occur. The CWTU.EXC file is a text file, listing user names (one to a line)that will be excluded from the bulletin(s). Rename the packaged _CWTU.EXC file to CWTU.EXC if you wish to exclude user names from the bulletins. On day 7 a message will be posted containing the results of the weekly top bulletin. It will be posted in the conference specified in the .DAT file (unless you turn this option off). ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý DISTRIBUTION Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ You are always welcome to send Internet E-Mail requesting program info, ask any questions you may have, or to request a UUEncoded copy of any supported program (that is what that specific account is for!), or: "FINGER mslasher@io.org" anytime via your internet accessible account to view up-to-date information about: þ Program information concerning the latest released version .............. þ þ Directions to official distribution site(s) ............................. þ þ A list of other supported programs ...................................... þ þ Other miscellaenous information ......................................... þ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý LEGAL-ESE Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ USAGE OF THIS SOFTWARE INDICATES YOUR ACCEPTANCE OF THE SOFTWARE LICENSE TERMS ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ This software is the property of the authors, Robert Hunter / G.L., the registered copyright owners. They only license the software's use, public distribution does not transfer ownership of this copy.In addition, you assume responsibility for the selection of the software to achieve your intended results and for the installation, use and results obtained from the software. This license is effective until terminated. You may terminate it at any time by destroying the software together with all copies. You agree upon such termination to destroy the software together with all copies. Among other things, you may not: rent, lease, modify, translate, disassemble, decompile, reverse engineer, or create derivative works based upon the software. If you fail to comply with any terms of this license agreement, your license is automatically terminated. This license will be governed by the author's residential provincial or state laws except as to copyright and other proprietary matters which may be preempted by federal laws and international treaties. In the event of any dispute involving this license, the Licensee consents to exclusive jurisdiction and venue in either the authors residential provincial/state or federal courts and agrees that the prevailing party shall be entitled to its attorney fees and costs. In the event any provision of this license shall be deemed unenforceable, void, or invalid, such provision shall be modified so as to make it valid & enforceable and as so modified the entire agreement shall remain in full force and effect. No decision, action or inaction by the author(s) shall be construed to be a waiver of any rights or remedies available to them. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BY USING OR BEING IN POSSESSION OF THIS SOFTWARE YOU ACKNOWLEDGE THAT YOU HAVE READ, UNDERSTOOD, AND AGREE TO BE BOUND BY THIS AGREEMENT'S TERMS & CONDITIONS. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±Ý REGISTRATION / AUTHOR NOTES Þ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ We understand that software license enforcement is far from easy; copyright violations are much easier to report to the proper authorities. We also understand that the segment of persons that might be interested in this software is not one that enjoys paying for every utility (simple or not) that they deem useful. No monetary registration is required to use this software. If you do use this software you must register is usage. Obviously we're in no position to enforce this, but a quick EMail message containing your name, your BBS name and telephone number is appreciated. This process also lets us know a) who is using what software and b) what software is being used, aiding in the prioritization of updates. We doubt this is asking for too much, considering the time spent creating this software. If you find this utility useful & wish to support its development (or support the development of this PPE in combination with other .PPEs we have publicly released) via a monetary donation, please contact us at the posted EMail address. We certainly appreciate any support you chose to give. We have always, and will always try to accomodate all users of this product. If you have a suggestion or request for an optional or permanent addition, please initiate contact by sending EMail to the posted address. -- Thank you. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Þ³ úúúù Contacting the Author Via Internet E-Mail: ùúúúú ³Ý ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±Ý Þ±± ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ