컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 굇�[CLCB]檳굅 � Custom Last Caller Bulletin PPE (c) 1993-94 � 갚금[CLCB]檳� 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 浜 頰頰頰� Custom Last Caller Bulletin 沆頰頰頰 � Author: Robert Hunter 넷 浜 頰頰頰頰� Version: 1.51 Standard 沆頰頰頰頰� � a.k.a: Midnight Slasher 넷 浜 頰頰頰頰頰頰頰� [11/10/94] 沆頰頰頰頰頰頰頰� � E-Mail: mslasher@io.org 넷 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 浜 CONTENTS � 1. Files Included 5. General Program Information 넷 浜 OF � 2. Brief Program Summary 6. Distribution 넷 浜 DOCUMENTATION � 3. Installation 7. Legal-ese 넷 浜 � 4. External Files 8. Registration / Author Notes 넷 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 굇� FILES INCLUDED 檳굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 浜 CLCB.BOT ....... 305 .. Bulletin's Footer Display File 浜 CLCB.DAT ..... 4,254 .. Main Data Configuration File 浜 CLCB.DOC .... 17,717 .. Documentation / Installation Guide (Please Read) 浜 CLCB.HST ..... 5,265 .. Revison History / Whats.New 浜 CLCB.PPE .... 14,560 .. Last Caller Bulletin PPE 浜 CLCB.TOP ....... 331 .. Bulletin's Header Display File 浜 CLCB.TOT ....... 911 .. Bulletin's Totals Template File 浜 _CLCB.EXC ....... 17 .. Exclusion Names List (Optional) 浜 FILE_ID.DIZ ..... 462 .. Description Identification File 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 굇� BRIEF PROGRAM SUMMARY 檳굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇� 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� A .PPE (* PCBoard Programming Language Executable *) for PCBoard v15.2+ BBS. This PPE generates and displays a _Fully Sysop Configurable_ last X callers bulletin. It allows full configurability of the Header and Footer files, the format of the last caller display lines, as well as a fully configurable 'Totals' file which has the ability to list Today's, Yesterday's and Record High System totals. This is all accomplished via the usage of replacement codes. (Somewhat like PCBoard @???@ macros). 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 굇� INSTALLATION 檳굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� This PPE REQUIREs that the PCBSTAT PCBoard Supported Allocation (PSA) be installed in your user file. This PSA simply records user statistics, which the bulletin generator will use in some if its calculations. To install this PSA: 1. Run PCBSM 2. Press D (User Info File Maintenance) 3. Press C (Add PCBoard Supported Allocations) 4. Press E (Caller Statistics Support) 5. Press Y (to add the PCBSTAT PSA) 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 1. Load all your PCBTEXT file(s) into MKPCBTXT.EXE (/PCB/GEN/MKPCBTXT) 2. Press F3 and enter 192 (Goto Prompt #192) 旼컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� � Record No: 192 Record Length: 40 Justification: Left � 쳐컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� � Minutes Used: @OPTEXT@ � � !DRIVE:\PATH\CLCB.PPE /192 � 읕컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 浜 IE: C:\PCB\PPE\CLCB\CLCB.PPE /192 /ALIAS 浜 浜 NOTE: The /192 command parameter tells CLCB to update the bulletin. 浜 浜 Command Line Parameters: 浜 ------------------------ 浜 /192 : Tells CLCB to update the bulletin 浜 /ALIAS : If the user has their ALIAS on and this parameter is used, 浜 the 'Name Field' will reflect their alias rather than their 浜 real name. 3. Press ESC to Exit and Save. 4. Place the line: !DRIVE:\PATH\CLCB.PPE eg: !C:\PCB\PPE\CLCB.PPE somewhere in your logon procedure. You could add this line somewhere to your NEWS file, main conference INTRO file, or attached to some other PPE. *It MUST BE RUN every time a user logs on.* It displays the last few callers bulletin, but it also creates a temporary file to store the initial stats of a user. If it is not run, the bulletin will not be updated with that caller's information. If you are unsure of how to make PCBoard show a file only once; here is one way to do it. Run PCBSETUP, press G, press D, and enter "Y" on the "Display NEWS file only if changed" prompt. Edit your NEWS file and on a blank line, insert the !DRIVE:\PATH\CLCB.PPE line. Then set the file date on your NEWS file to a date far in the future (12-12-99). I realize that some people may wish to setup a 'TurboLogin' feature that will skip to the main menu without forcing the user to view the last few callers bulletin. If you have a setup such as this; you still must run the CLCB.PPE every time a user logs on; but you can use the /NOSHOW parameter to only have it create the temporary data file and not display anything to the user. ie: !C:\PCB\PPE\CLCB.PPE /NOSHOW Example: If you do have a TurboLogin feature, just make sure you run CLCB.PPE /NOSHOW before the TurboLogin. You can run CLCB.PPE without the /NOSHOW parameter in your login sequence later on (you can run it as many times as you want per call) since it will not overwrite the temporary data file once it has been created for the caller! 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 굇� EXTERNAL FILES 檳굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� Packaging Note: You may notice that many files come packaged as _FILE.EXT . This is because they are optional files. They will not be used unless you rename them to FILE.EXT (remove the _). It is packaged this way to prevent users who want to use the defaults provided in the program from using these files unintentionally, which simply slows down the loading process. ----------------------------------------------------------------- CLCB.DAT : The configuration line / replacement code template for the last callers display line. Instructions are contained within the file. ----------------------------------------------------------------- CLCB.TOP : The Header File. You can also use this file to run any PPEs or display any files BEFORE the last caller's bulletin. You do this by putting a line such as: %C:\PCB\DISPLAY\LOGON.TXT or !C:\PCB\PPE\LOGON.PPE on any blank line in the CLCB.TOP file. These should come before the graphics of the header for your bulletin. ----------------------------------------------------------------- CLCB.BOT : The Footer File. Just like the CLCB.TOP file, you can run PPEs or display other files after the last caller bulletin with this file. (Delete it if you don't want a Footer File, deletion works with the header file too) *** Note: If you wish to display the .BL2 file (which will be the output of the .TOT file), make sure the path is correctly setup in this file. It uses a %DRIVE:\PATH\FILE.EXT line to point to the .BL2 file. Edit this file in a text editor and change the path to reflect your setup. ----------------------------------------------------------------- CLCB.EXC : The Exclusion List. If you do not want certain user names to be listed in the Last Callers Bulletin, simply add their names (one to a line) in this file. ----------------------------------------------------------------- CLCB.TOT = The optional file template for CLCB.BL2. This file can use the following replacement codes to sum up today's, yesterday's and record high total board usage: %TMPT : Total Messages Posted Today %TMPY : Total Messages Posted Yesterday %TFUT : Total Files Uploaded Today %TFUY : Total Files Uploaded Yesterday %TFDT : Total Files Downloaded Today %TFDY : Total Files Downloaded Yesterday %TKUT : Total Kilobytes Uploaded Today %TKUY : Total Kilobytes Uploaded Yesterday %TKDT : Total Kilobytes Downloaded Today %TKDY : Total Kilobytes Downloaded Yesterday %TSCT : Total System Calls Today %TSCY : Total System Calls Yesterday %RTUK : The record number of K Uploaded (in one day) %RTUF : The number of files uploaded on the record UL K day %RTUD : The date the record number of K was uploaded %RTDK : The record number of K Downloaded (in one day) %RTDF : The number of files d/loaded on the record DL K day %RTDD : The date the record number of K was downloaded %RTMP : The record number of posted messages (in one day) %RTMD : The date the record number of messages were posted %RTCS : The record number of calls to the system (in one day) %RTCD : The date the record number of calls were made These codes are not padded/justified, consequently if you need a border around these codes (or need them at a certain X,Y co- ordinate, please use the @POS:XX@ PCBoard macro. An example .TOT file has been included with this archive. This file is simply a template. It is read in, and CLCB.BL2 is output based upon this file (with all the codes filled). 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 굇� GENERAL PROGRAM INFORMATION 檳굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇� 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 1. Miscellaneous points to remember ----------------------------------------------------------------------------- If a CLCB.STT file ever exists on a permanent basis, delete it. It is a temporary file that will impede the update of the .TOT/BL2 files (and slow down the logoff procedure). It will be deleted automatically during bulletin generation, but if something goes wrong (reboot during this process, etc) make sure to delete it. CLCB.PPE /192 must be run as prompt #192. This is the generator mode of the PPE. CLCB.PPE must be run during every user's login (to display the bulletin, and create the temporary data file). The Caller Statistics PSA must be installed in your user file. Please try not to use @more@ / @wait@ macros within any of the display files, this may lock the file on one node (while waiting for a keypress) causing another node trying to update the bulletin to abort its update. If you need to pause the display, please use a @wait@ code after the entire bulletin(s) have been displayed. 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 굇� 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. 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. This, however, is a completely voluntary action. 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: 沆頰� 넷 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴� 굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇굇� 檳� 컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴컴�