Piper's Pit BBS/FTP: ibm 0560

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

/ Piper's Pit BBS/FTP: ibm 0560 - 0569 / ibm0560-0569 / ibm0563.tar / ibm0563 / LASTCA15.ZIP / LASTCALL.DOC < prev next >

Wrap

Text File | 1995-11-18 | 15.8 KB | 316 lines

┌─┐ ┌───────┐ │ │ ┌──────┐ ┌──────┐ ┌───────┐ │ ┌─────┘ ┌──────┐ ┌─┐ ┌─┐ │ │ │ ┌──┐ │ │ ┌────┘ └──┐ ┌──┘ │ │ │ ┌──┐ │ │ │ │ │ │ │ │ └──┘ │ │ └────┐ │ │ │ │ │ └──┘ │ │ │ │ │ │ │ │ ┌──┐ │ └────┐ │ │ │ │ │ │ ┌──┐ │ │ │ │ │ │ └────┐ │ │ │ │ ┌────┘ │ │ │ │ └─────┐ │ │ │ │ │ └────┐ │ └────┐ └──────┘ └─┘ └─┘ └──────┘ └─┘ └───────┘ └─┘ └─┘ └──────┘ └──────┘v1.2 The LAST today's CALLers information utility you will ever need (c) Copyright 1995 by Brian Still LASTCALL is Copyrighted by Brian Still as of November 1995 and is covered by US and International Copyright laws. The author reserves all rights. LASTCALL is FREEWARE, and requires a no fee for continued use after a 30 day evaluation period. All I ask is a netmail telling me that you are using this PPE, and at least one suggestion on what I could do to improve this software. ╒═════════════════════════════════════════════════════════════════════════════╕ │ BACKGROUND │ ╘═════════════════════════════════════════════════════════════════════════════╛ The reason I decided to undertake this project was twofold. First, I wanted to write a PPE to begin with, thats why I bought PPCL <grin>. Second, I couldn't for the life of me find a decent Today's Callers list program. I only found two and they were both not very well thought out. They used unconfigureable graphics, and unconfigureable colors. Both of which I give you total control over. This utility will look as good or as bad as you want it to... IT IS ENTIRELY UP TO YOU TO SET THE LOOK OF THIS UTILITY. The only thing not configureable is the information displayed, and I'm thinking of an workable way to make that information configureable also. ╒═════════════════════════════════════════════════════════════════════════════╕ │ FEATURES │ ╘═════════════════════════════════════════════════════════════════════════════╛ ■ All graphics displays are 100% configureable. You can even pick your favorite ANSI screen to use. ■ The colors used in displaying the list of callers are all configureable. ■ There are three different display files you can modify, BEFORE, HEADER and AFTER. You can just delete them if you don't want to use them. ■ You can list the latest callers at the TOP of the list, or at the BOTTOM of the list ■ You can choose between two different display options: 1) SCROLL the list off the top ofthe screen, or 2) CLEAR the screen between each screen full of information. ■ You can use either REAL names or ALIASes. ■ Uses custom output, and you can have the ENTER prompt wait indefinately, or for 1 to 255 seconds befor continuing. ■ You can choose a maximum number of today's callers to display, 1 to 1000 or all users. ■ Detects if config or data files are missing, and recreates them automatically. ■ Detects if the user logs in LOCAL and displays LOCAL rather than the port's locked baud rate. ■ Sysop is prompted befor being added to the today's caller list. ■ You can decide whether the sysop should ALWAYS, NEVER or be PROMPTed whether they would like to be included in the today's callers list. ■ Ability to define a block of security levels that will be included in the list. All security level's outside those defined will not be added. ■ You can use a sysop defined system caller number or use the system caller number returned by PCBoard. ■ ╒═════════════════════════════════════════════════════════════════════════════╕ │ INSTALLATION │ ╘═════════════════════════════════════════════════════════════════════════════╛ 1. Make directory for LASTCALL and place these files in that directory. 2. Use MKPCBTXT to add LASTCALL.PPE to prompt #192. - Go to the directory where your language files are located. - type MKPCBTXT and press [ENTER] - Press [F3] and enter 192 and press [ENTER] - Change the prompt to read: !C:\PPE\LASTCALL\LASTCALL.PPE ADD - Exit back to DOS ***NOTE***: Many Today's Callers utilities are replacements for prompt #166, however, this is a replacement for prompt #192. This allow for the addition of those callers who drop carrier as well as those who logoff normally. Prompt #192 is displayed every time someone logs off or drops carrier, #166 is only displayed when someone logs off normally. 3. Run PCBSETUP and press [B], [D]. Highlight "Name/Loc of Logon Script Quest." and press [F2]. Add the following line to the logon script: !C:\PPE\LASTCALL\LASTCALL.PPE DISPLIST *NOTE: These two commands are necessary for LASTCALL to function, and these are my suggestions of where to put the commands. They can, however, be placed anywhere. 4. the default output looks as follows: Today's Caller's... ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ Date: 11-11-95 Sluggo's Playhouse Time: 23:46 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ System Time Time Total Sec caller# logon Name onln logns lvl Speed Calling from ──────── ────── ───────────────────── ──── ───── ──── ────── ────────────────── 12536 23:19 BRIAN STILL 29 326 255 LOCAL ATLANTA 12537 23:30 JOHN SALMON 10 427 100 28800 ATLANTA 12538 23:46 JONATHAN SMITH 34 2 50 2400 NORCROSS GA ───────────────────┤ LastCall v0.9beta (c) Copyright 1995 by Brian Still ├──── Looks better in color, but you get the idea. You can quit now, and this is the output you will receive. 5. I'm guessing you want to modify the output you look like the rest of your BBS, so lets get started. You will need to modify the following files: - BEFORE <── First file displayed - HEADER <── This is the column headings, you can change the look or wording or whatever... - AFTER <── This file is displayed after the copyright line. If you do not want anything displayed at the end, delete the file accompanying this PPE - LASTCALL.CFG <── Modify this file to change the colors of each column, and various settings *NOTE: The display files are not necessary for the PPE to function properly. All these files may be deleted if you do not want to use them. 6. Using PCBEDIT, modify the graphics files to suit your taste. 7. The header contains the column heading, the format of the column output is as follows: 79 Characters ┌──────────────────────────────────┴──────────────────────────────────────────┐ System Time Time Total Sec caller# logon Name onln logns lvl Speed Calling from ──────── ────── ───────────────────── ──── ───── ──── ────── ────────────────── 12536 23:19 BRIAN STILL 29 2326 255 28800 ATLANTA │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌Calling from │ │ │ │ │ │ │ └(18 char) │ │ │ │ │ │ ┌User's connect speed │ │ │ │ │ │ └(5 char) │ │ │ │ │ ┌User's security level │ │ │ │ │ └(3 char) │ │ │ │ ┌Total number of times user has │ │ │ │ └called the system (4 char) │ │ │ Minutes user was online (3 char) │ │ The name of the caller (can also display alias) (20 char) │ This is the time of day the user logged on (5 char) This is the 12536th call in the history of the BBS (7 char) *NOTE: Each column heading is separated by two characters of empty space. 8. Modify the LASTCALL.CFG file to suit your needs: N <── #1 120 <── #2 TOP <── #3 0 <── #4 CLEAR <── #5 PROMPT <── #6 0 <── #7 255 <── #8 PCBOARD <── #9 @X04 <── #10 @X0F <── #11 @X0A <── #12 @X0B <── #13 @X0D <── #14 @X09 <── #15 @X06 <── #16 @X08 <── #17 @X0E <── #18 @X0B <── #19 @X0E <── #20 @X0F <── #21 #1: 'N' to use real names, 'Y' to use aliases #2: # of seconds to pause between screens waiting for user to press [ENTER]. Setting this value to 0 disables time checking. Valid range is 0 to 255. #3: 'TOP' to add new callers to the top of the list, 'BOTTOM' to add new callers to the bottom of the list. #4: Maximum number of today's callers to display. Valid range is 0 to 1000. A setting of 0 displays all callers. #5: Determines whether LastCall clears the screen between each screenful of information (header is frozen at the top of the screen) or if the information just scrolls off the top of the screen. Valid options are 'CLEAR' and 'SCROLL'. #6: 'PROMPT' Sysop whether they should be included in the today's callers list or 'ALWAYS' add sysop to the today's callers list, or 'NEVER' add sysop to the today's callers list. This setting overrides security levels defined below. #7: Lowest security level to be added to the today's callers list. #8: Highest security level to be added to the today's callers list. This setting is overridden by #6. #9: 'PCBOARD' uses PCBoard's internal caller number while 'LASTCALL' uses LASTCALL's system caller number. The problem with PCBoard's internal system caller number is that sometimes people on different nodes can end up with the same number. If set to 'LASTCALL', the current caller number is contained in a file called 'CALLNUMB'. #10: Color of System Caller #11: Color of Logon time #12: Color of callers Name #13: Color of Minutes online #14: Color of Times users has called #15: Color of Security level #16: Color of Connect speed #17: Color of City #18: Color of Copyright line #19: Main color of the "Press ENTER to continue" prompt #20: Color of the word "ENTER" in the "Press ENTER..." prompt #21: Color of the seconds in the "Press ENTER to continue or wait 120 seconds" *NOTE: If this file is not present, the file will be created with the above defaults. Once you do all that, you are ready for your first caller! ╒═════════════════════════════════════════════════════════════════════════════╕ │ LASTCALL'S FILES │ ╘═════════════════════════════════════════════════════════════════════════════╛ These files are the files necessary* for LASTCALL to run: - LASTCALL.PPE <── Lastcall executable - BEFORE <── First file displayed. May be deleted. - HEADER <── This is the column headings, you can change the look or wording or whatever. May be deleted. - AFTER <── This file is displayed after the copyright line. May be deleted. - LASTCALL.CFG <── Modify this file to change the colors of each column, and various settings. If deleted, it will be recreated next time LASTCALL is run. - CALLNUMB <── This file is used to maintain the current system caller number if you decide to use LASTCALL's internal system caller number support. If this file does not exist, this file will be recreated using PCBoard's internal system caller number. This file is created the first time you run LASTCALL. - DATE <── This contains the current date, and is used by lastcall to determine when the day has changed and when it need to reset. This file will be created the first time you run LASTCALL, or recreated the next time LASTCALL is run if the file is deleted. - LASTCALL <── Contains the list of today's callers. * Some of these files are only necessary if certain options are utilized. Some also may be deleted if the feature is not desired. ╒═════════════════════════════════════════════════════════════════════════════╕ │ COMMAND LINE OPTIONS │ ╘═════════════════════════════════════════════════════════════════════════════╛ ADD - Adds the current users information to the list of current callers. DISPLIST - Displays the list of today's callers to the user. ╒═════════════════════════════════════════════════════════════════════════════╕ │ TO REPORT PROBLEMS, REQUEST FEATURES OR JUST COMMENT │ ╘═════════════════════════════════════════════════════════════════════════════╛ Brian Still SluggSoft BBS: Sluggo's Playhouse (770)813-5596 Fidonet: 1:133/6010 Due to the increased volumn of netmail, please poll back for a response... ╒═════════════════════════════════════════════════════════════════════════════╕ │ BBS DISTRIBUTION │ ╘═════════════════════════════════════════════════════════════════════════════╛ BBSs are granted a limited liscense to distribute LASTCALL in a compressed format. The distributing BBS is not limited to the type of compression method used for distribution. However, the BBS must follow the following guidelines: 1. No BBS is authorized to add any files to the archive which are not part of the original LASTCALL archive as distributed by the author. 2. No user may be charged any additional fee just to download LASTCALL from the BBS. ╒═════════════════════════════════════════════════════════════════════════════╕ │ SHAREWARE VENDOR DISTRIBUTION │ ╘═════════════════════════════════════════════════════════════════════════════╛ This copyrighted software and documentation and is NOT PUBLIC DOMAIN. However, LASTCALL may be distributed at no charge, or for a charge not to exceed $10 US to cover shipping and media costs. When secondarily distributed, LASTCALL must be in its original compressed form and accompanied by its full documentation. The distributed software and documentation may not have been modified in any way. A secondary distributor must notify the author of their intention to include this group of files in their distribution. A secondary distributor may be granted exceptions to these conditions, only in writing from the original author. The author reserves the right to change any of these conditions without notice and any changes become retroactive. Failure to abide by this license agreement may result in either Civil Lawsuit or Criminal charges being filed.