System Operator Pager v1.4 Copyright (C) 1995, by Cutting Edge Online All rights reserved. Programming and Documentation by John Marx Cutting Edge Online (318) 537-7089 Voice 6372-B Kucinski Street (318) 537-7746 BBS Fort Polk, LA 71459 Hayes Optima 28.8k U.S.A. FidoNet: 1:3817/9 System Operator Pager v1.4 ---------------------------------------------------------------------------- System Requirements The requirements for using this PPE are as follows: a. PCBoard 15.21+ (This program was created with PPLC v3.0 and will not work with any version less than 15.21.) b. Enough space on your hard drive for installation of the program. c. It's not needed but placing this PPE and all your PPE's into different subdirectories is helpful. This allows you to more easily update or remove a PPE with it's accompanying files. Plus if you place more than one PPE in a directory you may run into the program trying to use a file it shouldn't. This is all that is needed to run this program. System Operator Pager v1.4 ---------------------------------------------------------------------------- Program Overview This program was designed for the fact that PCBoard didn't allow multiple times to be paged. If any of you are like me then you know that you're not at your computer the same time everyday. This program will allow you to set the times which you are available for each day and each hour you feel you will be available to be paged. Some of the features which help set this program apart are: þ 100% multilingual þ All commands, colors, etc are 100% SysOp definable. þ No NAG-me-to-death screens. This is a risk we're taking on our part to make the program available to you and we hope that if you use it you will support the shareware concept. þ Holiday support with special times for holidays þ Normal day support þ Optional Screen display if the system operator isn't available for chat at the time of the page þ Option to turn the sound off if you don't wish to hear the paging user þ Special user overide. Users who may page whenever they feel like bugging you. þ Bad user list of users who cannot use the page command no matter what there security level is. þ This replaces your (O)perator page command and doesn't interfere with your chat program. So whether you use PCBoard's internal chat feature or a PPE this program is right for you! þ Show your users whether you're available for chat or not upon logon. Just follow the step by step instructions below and you will be running in no time. System Operator Pager v1.4 ---------------------------------------------------------------------------- Program Installation With this quick installation we will have you up and running in no time flat. Just follow the step-by-step guide below and you'll be ready to use this program in just a few short minutes. 1. unZIP this program into its own respective subdirectory. 2. Edit the following files to suit your needs: a. SAMPLE.CNF This is the sample configuration file. When you save it save it as PAGE.CNF. b. BADUSER.DAT This is the bad user list. These are the users who absolutely cannot page you for any reason. One name per line. c. HOLIDAY.DAT This file is a list of all the days which are considered a holiday to you. You may have upto 65,000 holidays. Each holiday is on one line in MM-DD-YY format. If you place a 00 in either the month, day, or year then this will be considered a wildcard and will work for every month, day, or year. As an example, see below: 01-01-00 02-14-00 07-04-00 10-31-00 12-25-00 NOTE: The more holidays you have the longer it will take the program to load! d. HOL-TIME.DAT This is the valid times allowed to be paged if there trying to page on a holiday. The format will look like the following: 0000000000111111111122222 0123456789012345678901234 SU NNNNNNNNNYYYYYYYYYYYYYYNN MO NNNNNNNNNYYYYYYYYYYYYYYNN TU NNNNNNNNNYYYYYYYYYYYYYYNN WE NNNNNNNNNYYYYYYYYYYYYYYNN TH NNNNNNNNNYYYYYYYYYYYYYYNN FR NNNNNNNNNYYYYYYYYYYYYYYNN SA NNNNNNNNNYYYYYYYYYYYYYYNN Note that the first two lines are the time. The time is in military format. The first three rows are the days (SU for Sunday, MO for Monday, etc). The rest is a box of either Y or N for Yes I may be paged or No I may not be paged. So if we place a Y in 09 the user will be allowed to page you from 09:00 to 09:59. The NOR-TIME.DAT file works in a similar manner as this. e. NOR-TIME.DAT This is the times in which you are allowed to be paged when the date is not a holiday. The format of this file is the same as the HOL-TIME.DAT and will not be re-explained for you should already have grasped this concept. f. OVERIDE.DAT This is a list of users who are authorized to page you no matter what time it is, whether it's a holiday, etc. One name per line. g. BADUSER.* This file is displayed to the if they're designated as a bad user on the system. This is a multilingual file. h. STATUS.* This file you may decide to show your users upon logon to let them know what your status is; whether you're available or not. To use this on the logon process add the following statement to your LOGIN file: [drive]:\[path]\PAGE.PPE STATUS 3. Now that we have the hardest part done lets add the command to our CMD.LST file so that the changes will take effect.Make the following addition to your CMD.LST file: O 10 [drive]:\[path]\PAGE.PPE That's all there is to it. Now your operator page will go by whatever time you've designated for whatever day it is. Enjoy. System Operator Pager v1.4 ---------------------------------------------------------------------------- Possible Error Codes There are several reasons for error codes. The main reason is something went wrong in the program. Even though all efforts have been made to remove any and all possible errors there still may be some configuration we haven't thought of. As such we've included extensive error checking in all of our programs to eliminate any and all possible errors. Errors will be shown to the caller on the screen explaining what went wrong and why if the program can determine without a doubt what it was. All errors will be logged to the callers log! This allows you to correct any problems that your users might not tell you. A lot of times when an error occurs the users like "that's nice." We feel that even as nice as it would be for the user to explain to the SysOp what they were doing when such errors occur, we know not to expect it so we've added this to the code as well. When it logs this information to the callers log it also logs the exact saying that it gave to the user. This gives you the most complete information we can. You may also wish to check out the "Frequently Asked Questions" at the end of this document for it may cover a question you are currently having about PCBoard and PPE's. ySystem Operator Pager v1.4 ---------------------------------------------------------------------------- Contacting the Author I can be reached on either my BBS or through my home phone number at any time. If I'm not home and you receive the answering machine just leave your name and number with a short explanation, if you can, of the problem. I WILL call you back as soon as I can and if you gave me a description of your problem will more than likely have an answer for you when I do call you back. When you do call us with information about a bug in the program please give us the following information. This information will help us determine what the problem is: 1. Program name and version number. 2. Type and brand of computer, hard disk, plus any peripherals. 3. Version of DOS plus any TSRs or device drivers in use. 4. Explanation of your AUTOEXEC.BAT and CONFIG.SYS files. 5. Description of what is in memory from the MEM command (DOS 4 and above users only) or a similar utility. 6. The exact problem you are having. Please be as specific as possible. Having a printout of the screen and/or being at your computer will be helpful. The Cutting Edge Online BBS operates 24 hours a day, is using a Hayes Optima 28.8k modem, PCBoard 15.2/10 and the number is (318) 537-7746. You will be able to download if you wish on the first call. There are no callback doors. We do use CALLER-ID for just this purpose. I personally don't like callback doors and am sure many others feel the same. We've recently upgraded the system bringing the system to 13.2 Gigs online with 5 CD-ROMs. I'm available also on the PCBoard Support BBS, Salt Air. I only call once a week, normally on Saturday so the replies won't be as quick as you may like. I'm also in the FidoNet PCBoard, PCB-Net conferences. Our FidoNet address is 1:3817/9. If you have a problem, suggestion, comment, download or just wish to talk please call and we will be more than glad to serve you. We're not happy until YOU are happy so let us know if we're doing something wrong. If we're doing it right tell your fellow PCBoard SysOps, if not tell US!