Beijing Paradise BBS Backup

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

/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / UPDN71B.ZIP / UPDN.DOC < prev next >

Wrap

Text File | 1991-09-11 | 51.9 KB | 1,181 lines

░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░ ░▒███████████████████████████████████████████████████████▒░ ░▒█╔═══════════════════════════════════════════════════╗█▒░ ░▒█║ ║█▒░ ░▒█║ ██ ██ █████ █████ ███ ██ ║█▒░ ░▒█║ ██░░ ██░░ ██░░░█░ ██░░░█░ ██░█ ██░░ ║█▒░ ░▒█║ ██░░ ██░░ █████ ░ ██░░ █ ░ ██░░█ ██░░ ║█▒░ ░▒█║ ██░░ ██░░ ██░░░░░ ██░░ █ ░ ██░░ ███░░ ║█▒░ ░▒█║ ███████░░ ██░░ █████ ░ ██░░ ██░░ ║█▒░ ░▒█║ ░░░░░░░ ░░ ░░░░░ ░░ ░░░ ║█▒░ ░▒█║ ║█▒░ ░▒█╠═══════════════════════════════════════════════════╣█▒░ ░▒█║ The Ultimate Bulletin Maker for Any RBBS System ║█▒░ ░▒█╚═══════════════════════════════════════════════════╝█▒░ ░▒███████████████████████████████████████████████████████▒░ ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ [[ Version 7.1 ]] [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 1 ]] Table of Contents =-=-=-=-=-=-=-=-= Page # Zip File Contents ..................................... 2 What Updn Does ........................................ 3 Why Use Updn? ......................................... 3 How to Run Updn ....................................... 3 Types of Bulletins .................................... 3 Bulletin 1 ........................................ 4 Bulletin 2 ........................................ 4 Bulletin 3 ........................................ 5 Bulletin 4 ........................................ 5 Bulletin 5 ........................................ 6 Bulletin 6 ........................................ 6 Bulletin 7 ........................................ 7 Bulletin 8 ........................................ 8 Bulletin 9 ........................................ 9 Command Line Arguments ................................ 10 The Parameter File and How to Use ..................... 10 Parameter File Format ................................. 11 Examples of PRM Files ................................. 14 Bulletin 7 - Sysop Configurable Bulletin .............. 15 Changing Bulletin 7 ................................... 16 About the Program ..................................... 17 Changes to Data Files ................................. 18 Errorlevels ........................................... 19 Append Switch ......................................... 19 Callers File 'Care & Feeding' ......................... 20 Trouble Shooting ...................................... 20 All I ask is .......................................... 22 In Closing ............................................ 22 Free Registration ..................................... 22 Registration Form ..................................... 23 History of Releases ................................... 24 [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 2 ]] [[ ZIP CONTENTS ]] The original UPDN70.ZIP file is zipped using PKZIP with Authenticity Verification and contains the following files. BULET -> Sample non-ascii bulletin file BULETC -> Sample ansi bulletin file BULETG -> Sample ascii bulletin file BULL7 .CFG -> Sample bulletin 7 configuration file CONVERT .DOC -> Instructions for convert.exe CONVERT .EXE -> Converts pre v. 7.0 data files to v. 7.0 format README .1ST -> Contains IMPORTANT information that may keep your C: drive from being formatted REGISTER.DOC -> Instructions to insert registration number into parameter file REGISTER.FRM -> Registration form to help put my kids through college UPDN .EXE -> THE EXECUTABLE FILE UPDN .PRM -> Sample parameter file UPDN .DOC -> This file WHATS .NEW -> History of revisions for UPDN Check it to see if your problem has been fixed Many BBS's rezip uploaded files. That will remove the PkZIP Authenticity Verification. In addition updn.exe will create the following files when executed prm = parameter file base name c = alpha character (abcdefg...) prmc.def -> holds the first record and last read record number of the callers file. One produced for each callers file (node) listed in the parameter file prm3.dat -> Ascii data file for bulletin 3 (Top 30 Files) prm7.dat -> Binary data file for bullein 7 (Sysop config) prm8.dat -> Binary data file for bulletin 8 (Time Util) prm9.dat -> Ascii data file for bulletin 9 (Top 30 Door Users) [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 3 ]] [[ What UPDN Does ]] Updn produces bulletins for RBBS-PC bulletin boards. Every BBS has a bulletin section. Sysops are sometimes at a loss as how to create bulletins for this section. UPDN solves this problem. It creates all kinds of text files that can be used as bulletins, news files, announcements etc. UPDN uses information read from the users and callers files to create bulletins. As a result the bulletins give accurate up to date information about your BBS. [[ Why Use UPDN? ]] Why? Why NOT! If you use RBBS and can think of a reason why you should NOT use UPDN, then give me a call! To the point, UPDN creates just about ANY Statistic Bulletin you can dream of accurately and up to date. You can even place it in a batch file (registered version) to keep them updated all the time or place it in a daily or monthly event batch file (registered version). Users just love to read the board statistics to see which files are good, which games are played the most, who calls the most, etc. [[ How to Run UPDN ]] UPDN, of course, can be executed from the DOS prompt. However, the best way to use it is in a batch file. The daily event batch file is the best way to run it. All bulletins would then be updated at a regular interval and give sysops and users the most accurate information. Registration must be enabled by a proper registration number in order to use UPDN in a batch file. Unregistered users must run UPDN from the DOS prompt. [[ Types of Bulletins ]] UPDN was originally called UPDN because it only created bulletins for Top Uploads and Top Downloads. UPDN quickly grew to what it is today, so why change the name. UPDN creates nine different bulletins that can be placed in any order and in any file. These bulletins include: Number What it does ------ ---------------------------------------------- 1 List of the Top 15 Downloaders on the System 2 List of the Top 15 Uploaders on the System 3 List of the Top 30 Files Downloaded 4 Complete Sorted List of Users 5 Basic Statistics of the Current User 6 List of the Top 15 Users on the System 7 Sysop Configurable Statistics Bulletin 8 Two page Time Utilization Stats and Time vs Calls graph 9 Top 30 Door Users Each bulletin can be completely controlled by you. All have three types created, non ascii, ascii and ANSI. The bulletins you are about to see are the non ascii bulletins using the default border of *. [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 4 ]] Here they are : Bulletin One - List of Top 15 Downloaders on the System =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= {NS THE AUBURN BBS - TOP 15 DOWNLOADERS as of 06/03/90 ******************************************************* * 1 - MARK KEOUGH 190 * * 2 - TOM VALENTINE 144 * * 3 - BILL WOODWORTH 142 * * 4 - MARK FORD 139 * * 5 - JASON CRIAZZO 130 * * 6 - JAMES SHOWERS 129 * * 7 - KERRY SMITH 129 * * 8 - TIM FORD 127 * * 9 - RAJAH RODGERS 120 * * 10 - MITCH HAMMOND 108 * * 11 - CHARLES RIFFLE 108 * * 12 - ERIC TOLL 92 * * 13 - STANLEY SWIZDOR 89 * * 14 - DAVID SLYWKA 63 * * 15 - BILL MINNIER 63 * ******************************************************* {PB Bulletin Two - List of Top 15 Uploaders to the System =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= {NS THE AUBURN BBS - TOP 15 UPLOADERS as of 06/03/90 ******************************************************* * 1 - JON VALDINA 74 * * 2 - NICK BRINDAK 66 * * 3 - MARK KEOUGH 55 * * 4 - CHARLES RIFFLE 53 * * 5 - MARK FORD 52 * * 6 - CHARLES CULVER 39 * * 7 - MIKE BENTKOFSKY 38 * * 8 - PETER VALDINA 36 * * 9 - BILL WOODWORTH 33 * * 10 - TIM FORD 31 * * 11 - TOM VALENTINE 27 * * 12 - TOM HANSEN 27 * * 13 - MICHAEL SAGE 22 * * 14 - JASON CRIAZZO 22 * * 15 - DAN SHORE 21 * ******************************************************* {PB [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 5 ]] Bulletin Three - List of Top 30 Files on the System =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= {NS THE AUBURN BBS - TOP 30 FILES as of 06/03/90 *************************************************************** * 1 - FILES.ZIP 115 * 16 - LARRY.TXT 14 * * 2 - AREABBS.TXT 40 * 17 - AUTO-OFF.ZIP 14 * * 3 - PKZ101.EXE 32 * 18 - SUSAN.ZIP 13 * * 4 - PKZ102.EXE 29 * 19 - TALK2ME.ZIP 13 * * 5 - UPDN58.ZIP 29 * 20 - CTUTOR.ZIP 12 * * 6 - CHICKS.GIF 24 * 21 - PORTAL3.ZIP 12 * * 7 - DOORGAME.ZIP 21 * 22 - PREVUSER.MOD 12 * * 8 - PKZ092.EXE 20 * 23 - PUTPUT.ZIP 12 * * 9 - MICHELE.GIF 18 * 24 - KARATE.ZIP 11 * *10 - UPDN420.ZIP 17 * 25 - TEEOFF.ZIP 11 * *11 - ANGEL.GIF 17 * 26 - FINGER3.ZIP 11 * *12 - UPDN54.ZIP 16 * 27 - JAN89.GIF 11 * *13 - UPDN440.ZIP 15 * 28 - ADDGRF1.ZIP 11 * *14 - SUPERZAX.ZIP 15 * 29 - 3D-STAR.ZIP 11 * *15 - BASSTR26.ZIP 15 * 30 - AWARD.ZIP 11 * *************************************************************** 4,044 Files Downloaded {PB Bulletin Four - List of Users on the System =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= INFO QUEST RBBS - USER LIST as of 12-03-1989 ***************************************************************************** * ALBRYCHT, MARC - CARBONDALE, IL * MANXAM, IVAN - CARBONDALE - IL * * ALLISON, JAMES - PHOENIX ARIZONA * MARCUS, ROBERT - WINCHESTER, VA. * * ANTHONEY, PAUL - CARBONDALE, IL * MARTIN, DOUG - CARBONDALE ILLINOIS * * BAILEY, TERRY - CARBONDALE, IL * MARTINO, LEON - GUILDERLAND, NY * * BAKER, JEFF - CARBONDALE, IL * MAY, ROBERT - FRANKFORT, IL * * BAKER, THOMAS - MARION, IL. * MCBRIDE, SCOTT - CARBONDALE IL * . . . . . . * LYCZAK, JOE - CARBONDALE, IL * WILLIAMS, TIM - CARBONDALE, ILLINOIS* * LYNN, GARY - MCLEANSBORO IL * WINTERNHEIMER, TERRY - CARBONDALE, I* * MAGEE, CLIFF - CARBONDALE IL. * WRIGHT, ROBERT - MARION, IL * * MALIWANAG, ALEX - CARBONDALE,IL * WUNDERLICH, MARK - CARBONDALE, IL * * MAN, FAT - CARBINDULL IL * ZILZ, TONY - CARBONDALE * ***************************************************************************** 256 Users Listed {PB [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 6 ]] Bulletin Five - Basic Stats of the Current User =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= This bulletin does not change, but is included to allow it to be appended to the other bulletins. {NS THE AUBURN BBS - YOUR STATISTICS as of 09/13/90 *************************************************************** * {VY * * Stats for {FN * * {LN * * From {TY {CT {TN * * * * Security Level ................ {SL * * Time Left Today ................ {TR * * Time Used Today ................ {TE * * * * Files Downloaded ................ {DL * * Bytes Downloaded ................ {DB * * * * Files Uploaded ................ {UL * * Bytes Uploaded ................ {UB * * {VN * *************************************************************** {PB Bulletin Six - List of Top 15 Users on the System =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= {NS THE AUBURN BBS - TOP 15 USERS as of 06/03/90 ******************************************************* * 1 - PETER VALDINA 1225 * * 2 - JON VALDINA 955 * * 3 - MARK FORD 487 * * 4 - MIKE BENTKOFSKY 478 * * 5 - TOM VALENTINE 311 * * 6 - MARK KEOUGH 301 * * 7 - DAVID FORD 301 * * 8 - GILES SMITH 257 * * 9 - JAMES DUNN 219 * * 10 - BILL WOODWORTH 211 * * 11 - TIM FORD 166 * * 12 - PAYTON SMITH 156 * * 13 - WOOD STOCK 151 * * 14 - KERRY SMITH 147 * * 15 - STANLEY SWIZDOR 136 * ******************************************************* {PB [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 7 ]] Bulletin Seven - Sysop Configurable Statistics Bulletin =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= [[ Auburn BBS Statistics ]] Compiled from 10-01-89 to 05-31-90 *********************************************************** * * * 242 Days in Period Total Daily * * * * [[ Caller Statistics ]] * * =-=-=-=-=-=-=-=-=-=-=-= * * * * Logins 4,441 18.4 * * * * At 9600 Baud (local) 40 0.2 * * At 2400 Baud 2,598 10.7 * * At 1200 Baud 1,638 6.8 * * At 300 Baud 165 0.7 * * * * Accesses Denied 146 0.6 * * New Users 162 0.7 * * Dropped Carriers 1,811 7.5 * * AutoLogoffs 403 1.7 * * Sleep disconnects 40 0.2 * * Security Violations 227 0.9 * * Time Limit Exceeded 120 0.5 * * Sysop Pages 222 0.9 * * Sysop Chats 326 1.3 * * * * [[ Message Statistics ]] * * =-=-=-=-=-=-=-=-=-=-=-= * * * * Message Reads 2,212 9.1 * * New Messages 818 3.4 * * * * Bulletin Reads 3,686 15.2 * * * * [[ File Statistics ]] * * =-=-=-=-=-=-=-=-=-=-= * * * * Files Downloaded 2,479 10.2 * * Files Uploaded 512 2.1 * * * * Attempted Duplicate Upload 90 0.4 * * Not Enough Time to DL 96 0.4 * * Aborted File Transfers 533 2.2 * * * * [[ Game Statistics ]] * * =-=-=-=-=-=-=-=-=-=-= * * * * Doors Opened 2,590 10.7 * * * *********************************************************** [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 8 ]] Bulletin Eight - Time Utilization Statistics Bulletin =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= This is a two page bulletin. {NS THE AUBURN BBS - Time Utilization as of 06/03/90 ******************************************************* * * * Time Period 10-01-89 - 05-31-90 * * Total Days 242 * * * * Total Calls 4,441 * * Calls / Day 18.4 * * * * Total Use 1,398 Hrs, 6 Min, 34 secs * * Daily Use 5 Hrs, 46 Min, 38 secs * * * * Utilization 1 Node 24.1% * * Busiest Time 10 PM with 329 Calls * * * ******************************************************* {PB {NS 100 Percent Calculated as 10 PM with 329 Calls 100 * 95 * 90 * * * 85 * * * * * * 80 * * * * * * * 75 * * * * * * * * 70 * * * * * * * * * * 65 * * * * * * * * * * * * 60 * * * * * * * * * * * * * 55 * * * * * * * * * * * * * * 50 * * * * * * * * * * * * * * * 45 * * * * * * * * * * * * * * * 40 * * * * * * * * * * * * * * * * 35 * * * * * * * * * * * * * * * * 30 * * * * * * * * * * * * * * * * * * 25 * * * * * * * * * * * * * * * * * * * 20 * * * * * * * * * * * * * * * * * * * 15 * * * * * * * * * * * * * * * * * * * * * * 10 * * * * * * * * * * * * * * * * * * * * * * * 5 * * * * * * * * * * * * * * * * * * * * * * * * 12 1 2 3 4 5 6 7 8 9 10 11 12 1 2 3 4 5 6 7 8 9 10 11 AM % Frequency of Calls vs Time of Day PM {PB [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 9 ]] Bulletin Nine - Top 30 Door Users Bulletin =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= {NS THE AUBURN BBS - TOP 30 DOOR USERS as of 05/30/91 *************************************************************** * 1 - MIKE MORGAN 42 * 16 - ALLISON LAW 4 * * 2 - DAVE LEPAK 28 * 17 - KATHY HALLETT 3 * * 3 - MARTY SHORT 25 * 18 - MICHAEL SAXTON 3 * * 4 - GILES SMITH 24 * 19 - JOEL FITZSIMMONS 1 * * 5 - MARK FORD 24 * 20 - SEAN ELDER 1 * * 6 - TED LEPAK 15 * 21 - STAN DEAVER 1 * * 7 - MIKE BROWN 15 * 22 - MIKE MURPHY 1 * * 8 - PAYTON SMITH 11 * 23 - WARD VUILLEMOT 1 * * 9 - PETER VALDINA 9 * 24 - WILL PIERCE 1 * *10 - MIKE LIONS 9 * 25 - BRIAN FEDIGAN 1 * *11 - WILLIAM CERCHIA 8 * 26 - MARY DENNIS 1 * *12 - PAUL WILLIAMS 8 * 27 - JOHN SMITH 1 * *13 - CHRIS TRIM 7 * 28 - GEORGE JONES 1 * *14 - JAN KOWALSKI 6 * 29 - ALFRED NEWMAN 1 * *15 - BRANDYN MOORE 6 * 30 - GEORGE BUSH 1 * *************************************************************** 255 Doors Opened {PB [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 10 ]] [[ Command Line Arguments ]] UPDN [[bulletins]] [[-parameter file]] [[/graphics switch]] [[/a]] [[/w]] All arguments are optional - defaults to UPDN 12345689 -updn.prm * note 7 not included in default graphic switches /b forces mono /c forces color used in the event of the program not sensing the correct graphics card /a - used to append the created bulletin to an existing bulletin without destroying the original. Not needed to append created bulletins - those are automatically appended to each other if they have the same path/file name. /w inhibits all UPDN screen writes including the UPDN banner REGISTERED USERS ONLY (starts in ver 7.1) [[ The Parameter File And How to Use it ]] UpDn can be controlled as to which bulletins it makes by a simple command line. If the command line is left blank, it will default to 12345689 as the command line. If however, you wish to create the bulletins in a specific order or only some of the bulletins you can specify that in the command line. * NOTE * Bulletin 7 will not be created unless a command line argument is used such as updn 123456789 For Example: UPDN 34 will generate bulletin 3 (Top 30 Files) and bulletin 4 (Users List). Other Examples include: UPDN 12364578 UPDN 54321 ********** UPDN 12 UPDN 21 to get bulletin 7 UPDN 1245 UPDN 123467 must use command line UPDN 7 UPDN 4 ********** All are valid as long as you do NOT leave a space between the numbers ie,. UPDN 1 2 3 4 is not valid. Also you must create an ascii parameter file that UPDN can use for information on things like what directory and name to put certain files, what borders and colors to use, etc. UPDN can use the name of this parameter file in the command line as well. If no parameter file name is used then it will default to use UPDN.PRM in the current directory. If you wish to use a different parameter file then just precede the path and name of the file with a dash [-]. Example: UPDN -UPDN.PRM <---The default UPDN -C:\RBBS\MY.PRM This allows for multiple runs of UPDN using different PRM files to create different bulletins for different nodes or different conferences other than the main board. [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 11 ]] If you wish to use different parameter files the format of the command line is: UPDN [list of bulletins] -[parameter file] Example: UPDN 123 -D:\FILES\OTHER.PRM will create bulletins 1,2 and 3 using the PRM file OTHER.PRM. UPDN -C:\RBBS\MY.PRM will create all bulletins 1 through 9 (except 7) using PRM file MY.PRM. Remember to use the dash before a PRM file.. For Example: UPDN 123 MY.PRM <---WON'T WORK!! Forgot to use -MY.PRM [[ Parameter File Format ]] The format of the parameter file is as follows: Line # Example Explanation =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Line 1 { * Control Character,space,border Character Line 2 0 Include Sysop in bulletins 0=No 1=Yes Line 3 C:\RBBS\USERS Path and Name to Users File Line 4 C:\RBBS\CALLERS Path and Name to Callers File Separate each node callers file by a space Line 5 The Auburn BBS Name of the BBS Line 6 SECRET NAME Sysops Secret Name Line 7 Jon Valdina Sysops Real Name Line 8 C:\RBBS\BULET1 37 44 T Path/name of Bullet 1 ForeClr BackClr Frame Move Line 9 C:\RBBS\BULET2 37 44 D Path/name of Bullet 2 ForeClr BackClr Frame Move Line 10 C:\RBBS\BULET3 37 44 S Path/name of Bullet 3 ForeClr BackClr Frame Move Line 11 C:\RBBS\BULET4 37 44 D Path/name of Bullet 4 ForeClr BackClr Frame Line 12 C:\RBBS\BULET5 37 44 Path/name of Bullet 5 ForeClr BackClr Frame Move Line 13 C:\RBBS\BULET6 37 41 T Path/name of Bullet 6 ForeClr BackClr Frame Move Line 14 C:\RBBS\BULET7 37 41 N Path/name of Bullet 7 ForeClr BackClr Frame Line 15 C:\RBBS\BULET8 37 41 D Path/name of Bullet 8 Foreclr BackClr Frame Move Line 16 C:\RBBS\BULET9 37 41 D Path/name of Bullet 9 Foreclr BackClr Frame Move Line 17 2000 Registration Number Line 18 C:\RBBS\STATS.CFG Path and Name to Bulletin 7 Config File Line 19 20 Assistant Sysop <>leave out security level [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 12 ]] Now to explain Each line a little better. Line 1 This contains the control character for RBBS for Smart text. RBBS uses { as the control character, but the sysop can change this. Following the control character is a space then an alternate border character for none ascii bulletins. If this is left out UPDN defaults to * Also there MUST be a space separating the control character and the border character. Line 2 If you want to include the sysop in the bulletins then place a 1 here, otherwise use a 0 and the sysops name will not show in the bulletins. Line 3 This is the path and name to the Users file. Line 4 This is the path and name to the Callers file. Registered Users can include names of other callers files for sub boards or other nodes. The extra names will be ignored for unregistered users. Line 5 This is the BBS Systems Name and will be used for the tops of the bulletins. For registered users this is used to calculate your registration number. Contact me if you need to change this. I'll issue you a new number. Line 6 This is the Sysops secret name. Line 7 This is the Sysops name as you want it to appear in the bulletins. ( 2 words separated by a blank ) Line 8-16 This is the path and name to each of the separate bulletins mentioned above. The file name can be a maximum of seven characters with no extension. The file name MUST be supplied or a dummy name used to prevent an error from occurring even if the bulletin is NOT used. The name and path of the bulletin files determines where UPDN will write the bulletins. If the same name is used for all bulletins, then one large bulletin will be produced. Any combination of files can be supported, but this tells UPDN where to write each bulletin. Following each name there could be a foreground color, a background color and a frame type. Be sure to separate each color and frame by a space. An optional M may be placed to enable moving ansi borders. Available for bulletins 1,2,3,5,6,8 only. [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 13 ]] Foreground and Background colors are used for the ansi bulletins only. If foreground, background or frame are left blank then UPDN will default to white foreground, blue background and thick frame. Foreground Background Color =-=-=-=-=-= =-=-=-=-=-= =-=-= 30 40 Black 31 41 Red 32 42 Green 33 43 Yellow 34 44 Blue 35 45 Magenta 36 46 Cyan 37 47 White Frame Types include : T Thick Line Frame D Double Line Frame S Single Line Frame N No Frame at all Moving Borders : Enable moving ansi borders by following frame type with the letter M. Line 17 This is your registration number for registered users. This will enable batch file operation and unlock other registered features in later versions. This number is keyed to the BBS name in line 5. If you wish to change the name in line 5, contact me and I will issue you a new number. Unregistered users should enter 2000 on this line. This line should not be left blank or left out. [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 14 ]] Line 18 This is the path and name of the configuration file to be used for Bulletin 7. You must use a dummy argument if you plan to leave it blank and not use Bulletin 7. Line 19 This is used as the Assistant Sysop Switch. In case you have any users security level you want omitted from the bulletins. If left blank then all users will be included. [[ Examples of PRM Files ]] ; starting with ver 7.1 comments may ; be placed in the parameter file ; providing they start with a ; in col 1 { | 1 c:\rbbs\users c:\rbbs\callers c:\rbbs\callers2 The Auburn BBS SECRET NAME JON VALDINA C:\RBBS\HLP\BULET7 37 44 T M C:\RBBS\HLP\BULET7 37 44 D M C:\RBBS\HLP\BULET5 37 44 S M C:\RBBS\HLP\BULET7 37 44 D C:\RBBS\HLP\BULET7 37 44 T M C:\RBBS\HLP\BULET8 37 41 T M C:\RBBS\HLP\BULET9 37 41 N C:\RBBS\HLP\BULET3 37 41 T M C:\RBBS\HLP\BULET9 37 41 T M 2000 C:\RBBS\BULET7.CFG 20 OR { 1 c:\rbbs\users c:\rbbs\callers The Auburn BBS SECRET NAME JON VALDINA C:\RBBS\HLP\BULET1 C:\RBBS\HLP\BULET2 C:\RBBS\HLP\BULET3 C:\RBBS\HLP\BULET4 C:\RBBS\HLP\BULET5 C:\RBBS\HLP\BULET6 C:\RBBS\HLP\BULET7 C:\RBBS\HLP\BULET8 C:\RBBS\HLP\BULET9 2000 C:\RBBS\DUMMY.CFG [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 15 ]] [[ Bulletin 7 - Sysop Configurable Bulletin ]] The Sysop configurable Bulletin creates statistics of whatever you wish to make statistics on. UPDN does this by taking a search string and counting its occurrence in the callers file. The format of the configuration file is as follows: HEADER SEARCH STRING,STRING TO PRINT SEARCH STRING,STRING TO PRINT FORMAT STRING etc. The only restriction to the CFG file is that the first line MUST be a header and the search string and string to print MUST be separated by a comma. The rest is up to you. For example: Auburn BBS Statistics Callers Stats =-=-=-=-=-=-= on at, Total Callers doors opened, Access to Doors 1200 Baud, Number of 1200 Baud Callers 2400 Baud, Number of 2400 Baud Callers Downloaded, Number of Files Downloaded will create a bulletin like: Auburn BBS Statistics Compiled from 01-01-1989 to 12-31-1989 Total Daily Callers Stats =-=-=-=-=-=-= Total Callers 100 0.3 Access to Doors 76 0.2 Number of 1200 Baud Callers 25 0.1 Number of 2400 Baud Callers 75 0.2 Number of Files Downloaded 200 0.5 Some key points to note here are that the search string is NOT case sensitive and MAY contain a comma. The printed string however can NOT contain a comma. The format string can be anything including a blank line but CANNOT contain a comma. All headers, printed strings and format strings will appear as you put them and UPDN will center them in the bulletin. If you search for bulletin 1 and bulletin 10 bulletin 1 will be counted twice (string in string) - Got to work on that one. [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 16 ]] [[ Changing Bulletin 7 ]] Some important things to note! If you wish to change the Configuration file you must observe a few points. If you wish to change the search strings in any way, you MUST DELETE the UPDN data files prm7.DAT and start from scratch. You CAN change the contents of a string but you CAN NOT change the order or the number without restarting the data file. This is because the count of these strings (not the strings) is saved in order in these data files. It keeps these totals so that if you delete your callers file after the program is run it will not loose the counts. The printed string can be changed at any time. [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 17 ]] [[ About the Program ]] Most of the data used is from the taken from the users file. The top 30 files and bulletin 7,8 & 9 are read from the callers file and will be as accurate as the callers file. After the program runs two or three times the callers file may be deleted at will. The program maintains a total of old files and bulletin 7,8,9 data. UPDN checks the first record of the callers file to determine if the callers file is new or not. There may be an error in counts if a new callers file somehow has an identical first record as the old file. Several files are created by the program. They are created in the parameter file directory. prm = parameter file base name c = alpha character (abcdefg...) prmc.def -> holds the first record and last read record number of the callers file. One produced for each callers file (node) listed in the parameter file prm3.dat -> Ascii data file for bulletin 3 (Top 30 Files) prm7.dat -> Binary data file for bullein 7 (Sysop config) prm8.dat -> Binary data file for bulletin 8 (Time Util) prm9.dat -> Ascii data file for bulletin 9 (Top 30 Door Users) ****** NOTE ****** If you use a parameter file name other than UPDN.PRM files will be created using the first 6 characters of the parameter file name. Name the parameter file carefully so you don't overwrite any of your existing files. Also, if you use multiple parameter files for conferences and subboards, make sure they don't have the same first six characters or the data files will overwrite each other. If your parameter file is Myfile.prm than the top 30 files will create Myfile3.dat Bull 7 will create Myfile7.dat MyfileA.def will also be created for node 1's callers file. ****************** If you want to start the program from scratch delete all files except UPDN.EXE and your parameter file and config file. The program works well on my small country BBS. Some Sysops with many users, nodes, and +++ megabytes of files may get different results. Let me know about your problems and I'll try to correct them if I can. [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 18 ]] [[ CHANGES TO DATA FILES ]] As of version 5.6 the top 30 files downloaded data files have been changed to ascii format. The program will sense and automatically change the old data files to the new format. (Removed in v. 6.0 to save space. Use version 5.8 (available on Auburn BBS) to convert pre 5.6 data files.) These files are updn1.dat and updn2.dat or parameterfile1.dat and parameterfile2.dat. Convert.exe v 2.0 must then be run to convert the 1 & 2 data files to the ver 7.0 format. You can now edit and change files and counts to modify your top 30 files and doors users bulletin. The format of the file for bulletin 3 is: Filename,count for example: GEMINI.ZIP,1 DGLABEL.ZIP,2 TALK2ME.ZIP,13 AUTOTALK.ZIP,9 DOORGAME.ZIP,12 SIMCGA.ZIP,3 GALACTIC.ZIP,3 IBM-MAP.ZIP,4 The format of the file for bulletin 9 is: Username,count for example: JOHN SMITH,1 JANE DOE,2 WILLIAM JONES,13 [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 19 ]] [[ Errorlevels ]] Updn now produces an errorlevel upon termination. These can be used for redirection in *batch files. There will usually be a message in the status box indicating the nature of the error. This may, however, not always be true. All error conditions that produce an errorlevel greater than zero will cause the program to immediately terminate. * Note - The non registered version of UPDN requires keyboard input to terminate the program which makes batch file operation difficult. The registered version has this removed. That's the only difference. The following is a list of errorlevels and their possible causes.. Errorlevel Cause --------- ----- 0 Normal exit from program - no errors (I think) 1,2,3 Can't find or incorrect parameter file name. Parameter file name must have an extention 4 Error reading or verifying data from parameter file. 5 Can't find Bulletin 7 parameter file 6 Error reading or verifying data from bulletin 7 parameter file 7 Error in reading callers file 8 Error in reading users file 9 Corrupted callers file 10 Error allocating memory 11 Error processing or writing bulletin 1 12 " 2 13 " 3 14 " 4 15 " 5 16 " 6 17 " 7 18 " 8 19 " 9 [[ Append Switch ]] A new command line switch /a has been added in version 7.0. This allows appending an updn bulletin to the end of an existing file. The existing file can be any other file including a previously created updn bulletin. Remember that updn will automatically append bulletins written to the same file as it is running. Use the /a switch to prevent updn from deleting an already existing file. [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 20 ]] [[ Callers File 'Care & Feeding ]] UPDN now keeps track of the last record of the callers file that has been read. On subsequent runs it starts reading from the first new record. As a result certain conditions must be met for proper operation of UPDN. These are... 1) Callers files should never be altered. Programs that modify callers files should not be used. 2) You may delete a callers file at any time after running UPDN and after the updn data files are updated. 3) After setting up UPDN you should always run it with the same bulletins/parameter file combination. This condition applies to bulletins 3,7,8,9. If you run updn 3789 and then run updn 789 you will lose some data in bulletin 3. Set up a different parameter file for each different run of UPDN. 4) Multinode users should NEVER change their sequence of callers file names in the parameter file. The def files are set up in the same order that the callers files names appear in the parameter file. [[ Trouble Shooting ]] Q: It just doesn't work Jon! No matter what I do it don't work! A: Check the PRM file first of all. A large number of all errors can be found in there. Be sure there is no carriage return before the last line. Read the docs and compare it to what it should be. Q: When I run UpDn, the main menu comes up but then nothing..lockup! A: Be sure you have enough ram to run UPDN. The More Bulletins you are trying to create the more memory the better. Don't run from a shell. Q: When I look at bulletin four from RBBS, it skips lines or looks funny. Why? A: Don't worry about it! Its all ok..its not your fault but RBBS.. To the user it looks fine..but locally..who knows! Use the DOS type command to check it. Q: When I tell it to make more than one bulletin it don't work? A: Be sure there is NOT a space between the numbers and that the PRM file is all ok. [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 21 ]] Q: I told it to use a different Border character in the PRM file but it doesn't use it? A: Be sure there is ONE and ONLY one space after the Control Character and the Character you want to use. Q: I can't get the program to run properly no matter what I do. A: If you could, and want your problem corrected, zip up all your files including your prm, cfg, users, callers, bulletins produced, and data files produced and upload them to The Auburn BBS with a note describing the problem. I will then attempt to find the problem and will upload to your BBS a correction and/or new .EXE file. Not only will you help yourself, but you will also provide the world of crazy sysops (you have to be crazy to be a sysop) a bug free program. ***NOTE*** If doing this results in a bug fix you will receive FREE registration number. Q: No matter what I do I can't get bulletin 7 to work. A: The command line defaults to 123456. Bulletin 7 will not be produced unless a command line argument is used. For example, updn 1234567 Q: I keep getting a 'Hit any key to continue ...' before the program ends which stops my computer during batch file operation. A: Send in your registration and a registration number will be sent to you. Q: It won't read additional callers files listed in the parameter file. A: Send in your registration and a registration number will be sent to you. Q: I REALLY want to send you money but don't know what to do! A: Oh shucks! The address is below if you really Must! [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 22 ]] [[ All I ask is..]] IF ANYONE HAS A CONSCIENCE AND USES THIS PROGRAM THEY COULD SEND A DONATION WHICH WILL BE USED FOR FUTURE SOFTWARE DEVELOPMENT. SEE THE REGISTRATION FORM ON THE NEXT PAGE. 315-253-2600 The Auburn BBS 24 hours % Dr. J. P. Valdina 188 Genesee Street Auburn, New York 13021 CompuServe ID: 73767,3055 [[ IN CLOSING ]] Version 7.1 Please note : This program has and is being upgraded frequently as a result of feedback from users. The latest copy of UPDN will be in the download section of The Auburn BBS. I expect to add many changes in the next few months. Many will be just tightening and improving the coding and speed, but many will be in response to suggestions from users as to what they would like the program to do. Any other suggestions about the kinds of utilities RBBS sysops would like to have will be taken into consideration. Unverified users can download the file in the PERSONAL (new user) download section on their first call. The Auburn BBS (315) 253-2600 Many Thanks to Tom Hazel (Info Quest BBS) for rewriting the documentation. A chore I kept putting off. Enjoy [[ Free Registration ]] Anyone who discovers a bug and zips up all the necessary files including your prm, cfg, users, callers, bulletins produced, and data files produced and uploads them to The Auburn BBS with a note describing the problem. I will then attempt to find the problem and will upload to your BBS a correction and/or new .EXE file of the 'registered' program. (applies only to bug fixes - NOT incorrect use) [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 23 ]] The Auburn BBS % Dr. J.P. Valdina 188 Genesee Street Auburn, New York 13021 315-253-2600 CompuServe ID: 73767,3055 Name __________________________________ Address __________________________________ City _________________________________ State _______ Zip ________ BBS Name ____________________ Data Phone # ____________________ Voice Phone # ____________________ Version of UPDN.EXE that you are using - 7.1B Where did you get the Updn files? _____________________________________ BBS name exactly as it appears in line 5 of your parameter file. (Case sensitive) ______________________________________________ This will be used to calculate your registration number which should be placed in line 17 of your parameter file when you receive it. I would like to register UPDN.EXE . Please enclose the registration fee of $25.00. Registered users will receive Tech Support, and minor customizing if possible. The registered version has the 'Hit any key to continue' removed so that batch file operation is enabled. Comments or suggestions _________________________________________________ _________________________________________________________________________ _________________________________________________________________________ _________________________________________________________________________ [[ Auburn BBS Documentation to UpDn - Version 7.1 Page 24 ]] [[ HISTORY OF RELEASES ]] Check the file WHATS.NEW which is included in the UPDN.ZIP file package which lists all changes to the UPDN program.