Transcendence BBS Copyright ½ 1989 - 1993, Southern Software Programming By David Brown and Wayne Watson All rights reserved. No part of this manual may be reproduced by any means (electronical or mechanical) without prior written consent from Southern Software. PREFACE The Transcendence BBS package was originally conceived by David Brown in 1986. He began researching BBS programs, how they work, and how they don't work. At this time he did not know the first thing about computer programming (His first computer was a 520ST, in Oct. 1985). He began teaching himself how to write this type of software by programming online "door" software. In mid 1987 He began work on the "STark" BBS program. Soon he was joined by Jason Dickens. They worked on the program for about 2 years, and due to some problems, had to terminate their joint-effort. For a one year period he was without the source code to the STark BBS program. Since BBS programming was his work away from work, He started a new one. This program was entitled "STairway" (it was never completed). He then obtained the source code to STark, and used the two programs to create what is now "Transcendence." Soon after starting on Transcendence, he asked me to help re- write many of the old STark routines. I began work on the File Areas and wrote the transfer protocols along with many other support modules for the BBS. Since David and I started working together, we haven't stopped to take a breath. The program has gone through massive rewrites and modifications. The current program is beyond what we ever thought we could do. We feel that we have succeeded in creating the most flexible, powerful, user-friendly, and sysop-friendly BBS system ever. Our sysops seem to agree. In January, 1993, David decided to get out of development of Transcendence and asked me to take over marketing, selling, updating and supporting the program. I will miss the times that we spent working together. David has taught me a lot about programming telecommunications software and other things. It was a very good partnership. Although we keep in touch, it will not be the same. I wish David the best of luck in all his efforts and in life. Thanks David for so much! I wish you luck in your adventures as a Sysop and hope that Transcendence will make your experience a pleasant one. Wayne Watson - 1 - INTRODUCTION PRECAUTIONS In development of the Transcendence BBS package, we have attempted to create a bug-free system, with no harmful side affects. Unfortunately, with a program of this size, it is impossible for us to predict every configuration a sysop could create. Due to this we must ask you to use the software at your own risk. We can not be held responsible for damage (Or loss) of data, hardware or software. There are NO backdoors into the BBS program. We feel that if we want access on your system, then we can apply for an account just like everyone else. This is for your protection. SUPPORT POLICIES One of the main benefits to the Transcendence BBS system is our support. All updates to our software are 100% free. You pay only the phone bill, or postage. We are planning a modular version of the BBS system, there will be a minimal update fee for this, but it will be a one time fee. We rely on our sysops to give us feedback on the program. A lot of the features in the software are features requested by one of our sysops. Unlike other companies, we actually listen to our clients. You can obtain your free updates by calling one of our support BBSs, or by mailing a Self-Addressed-Stamped-Envelope, with a disk enclosed to me. We encourage you to give us suggestions. We can only improve the program if you let us know how. We also need to know if something is not working correctly. If you find any "bugs" in the software, let us know. We can't fix 'em, if we can't find 'em! Southern Software c/o Wayne Watson 1129 lake Cunningham Rd. Greer, SC 29651 Data: (803) 879-4186 14.4k Supra v.32/v.42bis Voice: (803) 879-4959 or (803) 968-0817 NOTE: Since I have a full time job, there may be times when it will be hard to get ahold of me. I hope you will be patient and understanding during those times. I do what I can with the free time I have to work on the BBS and to help my customers. Also, since I only have the one phone line strictly for my use, I use it for other things also. I also only have the one computer to do real development on so the BBS may be down at times. I will usually quit what I am doing and boot the BBS for you to use however. I am also on GEnie. If you have a GEnie account, you can reach me by Email at the address R.WATSON15. We also have a Topic in the BBS RoundTable for support. Please drop by to visit. - 2 - SYSTEM REQUIREMENTS To run the Transcendence BBS System you need the following hardware: o 520, 1040, Mega ST, STe, or TT o At least 1 meg of RAM o A modem (Hayes Compt. preferably) o A hard drive with at least 20 megs of space o Color or MONOchrome monitor (Medium & high resolution only) The following software/hardware is preferable, but not required: o Printer o XYZ external Zmodem protocol o Software or hardware backup utility o Micro Emacs Editor (Remote version) o 2.5 or more megs of RAM o TOS 1.4 or above COPYRIGHT NOTICES The Transcendence BBS program, all associated programs written by Southern Software and this manual are copyrighted by Southern Software. Unauthorized reproductions of those files, or the manual is strictly prohibited by international copyright laws. This software is not allowed to be "rented" or "borrowed". Such acts are clearly a violation of copyright laws. We reserve the right to deny updates & support to anyone, for disobeying the copyright. We have always provided you with a non-copyprotected BBS package, with the hopes that you will not distribute it without our written permission. "Pirating" software, as illegal copying is often called, only hurts the authors of the program, and those who paid for the program. Please do your part and do not support software piracy. All associated files, programs or documentation not written by Southern Software are copyrighted by their authors. - 3 - YOUR MASTER DISK With this documentation you should have received two disks. The disks are in DS/DD format. If you can not read that type of disk, contact Southern Software to get a replacement. Before doing anything else, make backup copies of all your disks. Use the backups when possible, store the originals for safekeeping. If you have trouble creating a backup copy of your original disk consult your Atari owners manual for "Duplicating" disks. These disks are not setup to run files from floppies! They are designed to first be copied to a hard drive, and then used. Transcendence was not made to run from floppy systems, although it should be possible to run a VERY small BBS from floppies, we do not recommend it. DISK ONE : Contains the BBS and associated files in LZH form DISK TWO : Third party programs. These are programs written by people not involved with the development of our software. NOTE: Any of these disks may contain a README file in their root directory, if so it probably contains updates to this manual, or important information about something on the corresponding disk. YOUR KEYCODE.DAT FILE The file called KEYCODE.DAT is a private-key type of file. In this file is your name, and serial number. This file is not to be given out to anyone, for any purpose. If someone gets a copy of your KEYCODE.DAT file please contact Southern Software for a replacement copy. (We can prevent 'stolen' KEYCODE.DAT files from working.) We can also find out what information is in the KEYCODE.DAT file when/if we log onto your system. This is not a back door to the program, it is just a special key sequence that will display the information. - 4 - Chapter 1: Creating a New BBS Now for the fun part, creating your own BBS! This chapter explains how to set up a new BBS, using our GEM System Editor. We assume you already have a working knowledge of Atari's GEM environment. If you have never used the GEM environment, please refer to your computer's owners manual for details. While we have attempted to make this chapter easy to understand, please remember that Transcendence is LOADED with options. Almost everything is configurable, and optional. PREPARING FOR YOUR BBS INSTALLATION Installing your BBS can be a very short process, or it can take hours. This will depend on how many message bases and file areas you want, and also on many other things. This chapter will attempt to make this process easier (or shorter) by giving you a few tips on what you should do before beginning the installation. There are many things to consider before you begin the installation process. Many new sysops overlook these details, we hope we can prevent you some heartache down the road. The Transcendence BBS System takes up a lot of Hard Drive Space. Before installing the BBS you must make sure you have enough hard drive space. To do this, delete old files you do not need and copy files you do not use often to floppy. If you were to create a BBS allocated for 100 users and five message bases (100 messages each, 20 lines long), that would take about 2-3 megs of hard drive space (It still greatly depends on other factors.) Hopefully that will give you some idea of how much room you will need. You can tell Transcendence what partitions to use for each type of data it creates/uses. For example, you can have your download files on drive C & D, your message base files could be on drive F, and all other files on drive H. While you clear off your hard drive space take into consideration where you want your different types of data. You can use the same partitions for all of the data files the BBS uses, or use many different ones, it all depends on what you want. When doing this remember that the partitions dedicated to file areas will eventually take up the most space. Transcendence uses "Pre-Allocated" data storage. That is, whenever possible the BBS makes all data files to their full size. This makes file access faster, and reduces the chance of DISK FULL errors (No BBS can prevent DISK FULL errors, only the Sysop can!). Whenever Transcendence has to create a file, it picks the drive with the most space (assuming you have it set up to use more than one drive). - 5 - Transcendence uses a lot of different types of data files for storing and retrieving information from your hard drive. It is possible for Transcendence to use hundreds of files. Since there are so many files used by the BBS, we had to come up with some way to organize them. The method we use is a storing each type of data in its own folder. In addition all of the folders used by the BBS may be contained in a "Main" folder. If you choose, you can bypass the "main" folder, and have all of your data folders right on the root directory of your drive. Although, for several reasons we do not recommend this. Mainly, throughout the entire manual we always use a main folder in examples, and explanations. Also, if you make a mistake during your installation, and want to start over you have to delete each folder individually, whereas if you used the main folder you could delete everything by only deleting the main folder. In this manual we will refer to the different folder names by their default names, which are: Main Folder: TRANS Data Files: DATA Text Files: TEXT Message Bases: MESSAGE File Areas: FILES Backup Files: BACKUP Module Files: MODULES Fmail/Fmessages: FMAIL Temporary Files: TEMP When you create your BBS these are the default names for the different data types. You may change the folder names, but again, we do not suggest it. In this manual we will refer to the different folders names by their defaults (listed above), which may become confusing if you have changed them. - 6 - HOW TO LAYOUT YOUR NEW BBS Before you actually begin the installation, you should consider exactly how you want your BBS setup. For example, how many message bases you want, and how many file areas you want. There are several other things to decide also. Ask yourself the following questions, and write the answers down so you can reference them while creating your BBS. o How many message bases do I want? - What are their names (30 characters max.)? - How many messages will each base handle (10-512)? - How many lines can each message be (5-256)? o How many file areas do I want? - What are their names (30 characters max.)? - How many lines can be in each description (2-256)? - What will the folder-name be for that file area? o How many users shall I allocate space for? o Should I let my users define their own macros? o How many Email messages should I make space for? - How many lines should I allow for each Email message? o What partitions should I use for each type of data? - Different Data types: Data Files, Message Base, File Areas, Temporary Files, Fmail/Fmessage Files, Text Files, Backups, Modules. o Decide which partition will be your "Main BBS partition", this is the drive your will actually be running the board from. Of course there will be a lot of other questions you will have to answer while creating your BBS. It might be wise to read this chapter before actually creating your BBS. - 7 - QUICK SETUP Copy the TRANS.LZH, LHARC.TTP and the INSTALL.PRG file onto the drive that you are going to install the BBS on. This should be where you want all of your text files, data files, BBS program, etc. on. Now, run the install program and follow the prompts. Everything is pretty much self explanatory. Once this phase is complete, you can now run TRANSBBS.PRG. You may copy the LHARC.TTP file to your MODULES folder. This is version 2.01L by Yoshi Questor. The BBS will come up and go through some initial loading of files. It will then come to what is called the 'WaitCall Screen'. At this point, it will log on and ask you if you wish to join the BBS. Enter in the information. This will set you up as the very first user in the USERS.DAT file. Once you have entered the information, the logon process will continue. You will then see an Auto-Informer message that a New User has logged on. At this point, just select 'V' for Validate and enter in 100 as the Mask to apply. The Auto-Informer will be explained later. You should now log off. The BBS is now setup in it's default mode and is available for use. You might also want to set up record #2 for your use. Just select 'D' at the WaitCall Screen and type 'New' at the prompt. You will go through the New User setup once again and be assigned record number 2. When you log off, just select 'A' at the WaitCall screen and you will once again be informed of a New User. Just repeat the process above. That is all there is to it. You now have a BBS system set up and ready to go. Of course, there are things you will want to change and add. Just read this chapter through and most of the settings for the system will be explained. - 8 - CREATING A NEW BBS If you want to start completely over and create a BBS from scratch, then delete the TRANS.DAT file. If you have files that you would like to keep that are in the FILES folder(s) (files uploaded, etc.), then copy them somewhere safe. If a file exist when you are setting up the BBS, you will be asked if you want to overwrite it. Once you have done this, you can create a New BBS setup. Just run the SYSEDITG.PRG and follow the prompts. Just select CANCEL when the BBS ask you to select the TRANS.DAT file to load and answer Yes to the question asking you if you are creating a new BBS. Please read over this chapter. It contains a lot of important information that is necessary for the proper operation of the BBS. This will help you in your setting up of New BBS also. The MASKS.DAT, COMMAND.DAT and the PROTOCOL.DAT files are pre- configured for you. You may want to copy them somewhere else as a backup. - 9 - THE SYSTEM EDITOR The System Editor is one of the most important parts of the BBS. With it, you control how your BBS acts, reacts and looks. It is the gateway to the BBS. Go ahead and run it and I will try and take you through it. You will need to have the following files in the same directory as the System Editor (SYSEDITG.PRG) program. If you want the program to automatically load in the TRANS.DAT information, then place these files in the same directory as the TRANS.DAT file. SYSEDITM.RSC - The Monochrome Resource file. SYSEDITC.RSC - The Color Resource file. After you run the System Editor, you will be presented with a dialog box with some general information. When you are ready, select OK or hit RETURN. The BBS program will load in the required information (assuming it exist) and tell you if there is anything it could not find. if the program does not find the TRANS.DAT file, it will ask you to locate this file by presenting you with a fileselector. Once the information is loaded, it will present you with a GEM Menu Bar. We will go through this menu from Left to Right, Top to Bottom. The Menu Bar titles are in BOLD UPPERCASE. The selections within each title are in normal UPPERCASE. Options on alternate menus within these selections are in ITALICS UPPERCASE. Any other selection, etc. is in Bold Upper/Lower case. These distinctions will not show up in the disk based version of this chapter. Keyboard shortcuts to the menu entries will be listed to the right of the option. The diamond shaped character means to hold down the Alternate key while pressing the letter next to it. The ^ character means to hold down the Control key while pressing the letter next to it. Anytime you see a triangle beside a selection, it is a mouse selectable field. You click on it with your left mouse button. Some of these fields may also be a combination of mouse selectable and text fields. You will be able to tell the difference. Anytime you see a time field (On At: 00:00:00 Off At: 00:00:00), a time of On At: 00:00:00 Off At: 00:00:00 will tell the BBS this option is on all the time. If you have On At: 01:00:00 Off At: 21:00:00, then the option will be on from 1:00 am till 9:00 pm. All times are in military time. 21:00:00 refers to 9:00 pm. To find out what a time is after 12:00 midday, just subtract 12 from the number (21 - 12 = 9). ********* Warning ********* If you plan on doing any major modifications, it is suggested that you backup ANY data you plan on editing. This is just a precautionary measure. It will allow you to restore things if something goes wrong. I am not saying I know something will go wrong, I just feel better by warning you. Things happen you know. - 10 - DESK This is where you will find your Desk Accessories and the About Me dialog box. SYSTEM EDITOR (ALT-A) This will bring up the About Me dialog box. This will tell you the version number of the System Editor, ordering information and other information. FILE This is where you Load and Save the TRANS.DAT file and Quit the program. LOAD TRANS.DAT (ALT-L) This option will allow you to Load in a TRANS.DAT file. When selected, it will bring up a file selector for you to choose TRANS.DAT file. By providing you with a file selector, it allows you to load in a TRANS.DAT file that may not be located in the same directory you ran the System editor from. SAVE TRANS.DAT (ALT-S) This option will allow you to Save the TRANS.DAT file. When selected, it will bring up a file selector allowing you to choose where to save the TRANS.DAT file. It will default to the location the System Editor was ran from. If the program asks you if you want to Save a particular file when you exit that setup area, then that data is not part of the TRANS.DAT file. This will include the data for the Command Tables, Protocols, Macros, Events and Masks. If you edit these areas, then you will not need to Save your TRANS.DAT file before you exit the program. QUIT (ALT-Q) This option allows you to Quit the System Editor. If the program thinks you have changed some information that belongs in the TRANS.DAT file, it will ask you if you want to Save the TRANS.DAT file before it actually quits. This is just incase you forgot to Save the file first. - 11 - EDIT This is where you will find the majority of the setup selections. MESSAGE BASES This is where you edit or setup your Message Bases. You will be presented with another dialog box with some options. EDIT MESSAGE BASES This option will allow you to edit the information for a Message Base. You will be taken to the first Message Base and be presented with another dialog box that contains the information for that base. Following is a description of those options. Name This is the Name you want to give to the Message Base. This name will be displayed to the user when selecting a message base to go to, etc. Maximum Messages This is the maximum amount of messages you want to have in the message base. Once the message base reaches this amount of messages, it will roll over. If you assign 50 message slots and the program reaches 50 messages in the base, the first message will then be deleted and the next message (# 51) will take it's place. The higher the number of maximum message you assign, the larger the data file. Maximum Lines This is the maximum number of lines that a user can enter as a message. Anything past this point becomes an Extended message and will be saved in the EXTENDED folder. The higher the number, the larger the data file. ** To calculate the amount of space a Message Base will take, use this formula. Max. # Messages * Max. # Lines * 75. If you allowed 50 messages and 20 lines per message, the Message Base data file would take up 75,000 bytes (50 * 20 * 75 = 75000). Minimum Age The user's age must be at least this age before he/she can enter a message base. This is good in that if you have an Adult type Message Base, you would not want to have users under age to be able to read these messages. ** You may enter On or Off in the following fields or you can click on them with the mouse to toggle them On or Off. Upper or lower case is accepted. - 12 - Remote Message Ops This will tell the BBS whether or not to allow Remote Message Ops. Not used at the moment. Anonymous This tell the BBS whether or not to allow anonymous messages. Alternate Message Header This tell the BBS whether or not to use an alternate headers for message status (if available) or not. With the use of variable tags, you can design your own headers in a text file that includes Message number, Status, etc. Whatever you want. This relates to the file MHDR_xxx.TXT. The xxx is the message base number. Allow Any Name This tells the BBS whether or not to allow the user to post a message using any name he/she wishes. Obviously this should be a very controlled privilege and should not generally be used. There may be Message Base that this would be allowed but, not usually. Allow ESC Codes This tells the BBS whether or not to allow the use of ESC codes in a message. VT52 text and graphics use ESCape codes to control text color, background color, etc. With this off, the program will filter out the ESC character and display the control number. With this option on, the user could include VT52, ANSI, etc. graphics in a message. Allow Variable Tags This will allow the use of variable tags within a message base. Variable tags are used in the text files you create also. For instance, if you wish to post a message and each time a caller logs on and reads that message, if you place the variable tag for the user's name in the message, then the user's name would appear in the message and it looks as if it is a personal message to that user. This can also be a touchy feature. If a user post a message with the variable tag for the user's password and that user logs on and reads the message, it will put their password in the message and it appears that anyone would be able to see it when, in reality, each user will only see his/her password. It can upset some people if they do not know what is going on. Once you have all the information the way you want it, select Next to go the next Message Base, Prev to go to the previous message base or Exit. The program will then create all the necessary files. You can page forward or backwards through all the message bases. The information will be remembered. If you make a total mess of things, you can go back to the main menu (menu bar) and load the TRANS.DAT file again and it will restore things back to the way they were. - 13 - REFORMAT 1 BASE This option will allow you to Reformat, Convert or Restore a Message base. When selecting this option, you will be presented with a list of available Message Bases to choose from. Once you make your selection, you will be presented with the dialog box to change your Message Base information. Once you have it set the way you want, you will be presented with a dialog box giving you 3 options. When you choose one of the 3 options, you will be asked if you are sure and given the chance to abort by selecting NO. Reformat This option will allow you to reformat your Message Bases. This will delete ALL messages, etc. from this base. If you changed any of the information in the setup dialog box, it will create the new files based on this information. You should make sure this is what you want to do. Convert This option will allow you to convert your Message Bases to a new layout (more messages or longer messages) without loosing your data. If you wanted to increase the number of lines a user can enter, then you would enter the new number on the setup screen and select exit and choose Convert. When you convert to a higher number of lines, all the messages that are not extended messages will be reserved as the same type of message it is. If you convert to a lower number of lines, the messages falling outside the new range will be converted to extended messages. If you convert to a lower number of messages allowed, those falling outside the range will be deleted. This option will make a backup of your Mxxx.DAT and Mxxx.SPD files so that you can do a Restore Original later on. The information is read from the backups and placed into the new files. These files will NOT be deleted by the program. It is suggested you write down the layout of the current Message Base in case you need it later on if you do a Restore Original. Restore Original This option allows you to restore a previously Converted Message Base. To do a Restore Original, just delete or move the current Mxxx.DAT and Mxxx.SPD files and rename the Mxxx.DA file to Mxxx.DAT and Mxxx.SP to Mxxx.SPD. You would then run the System Editor and go through the motions of reformatting a Message Base. When you come to the setup screen, enter the old information (hopefully you wrote it down somewhere) and select Exit. You would then select Restore Original and Yes (if you really want to do it). Once this is done, the program will calculations based on the info you gave it and if all is correct, the old information will be restored. - 14 - REFORMAT ALL BASES This option is like the Reformat 1 base but, it will go through each and every base until it is finished. You have the same options available to you as above. It will start with Message Base 1. Once you finish editing the information on the setup screen, select Exit and you will be presented with the Reformat, Convert, Restore Original dialog box. Once you make your choice, you will asked if you are sure. Once it is complete with what it is supposed to do, you will taken to the next Message Base to do it all over again. EDIT A BASE This option is much like the Edit Message Bases option except it gives the choice of the Message Base to start editing at. You can still page forward or backwards to the other message bases using the Next and Prev options. DELETE A BASE This option allows you to delete a base. You will be presented with a list of Message Bases to choose from. Once you make your selection, you will be asked if you are sure. Once you delete it, the data files are deleted so there is no turning back once you select Yes. You will then be asked at what user number to start the change for access to that base. This allows you to bypass the first 2 records that are reserved for you (the Sysop). Once a base is deleted, all the other bases will be renumbered and the associated files will be adjusted/renumbered. INSERT/ADD A BASE This option will allow you to Insert a Message Base between 2 message bases or add it to the end. You will be presented with a list of the currently available Message Bases. Choose where you want to place the new base. If you Insert a message base, it will place it BEFORE the number you choose. If you wanted to Insert the base between base 1 and base 2, you would enter 2. You will be asked for the standard information. Select Exit when you are done and you will be asked if you are sure. You will then be asked at what user number to start changing the access to that base. You can bypass the first 2 records which are reserved for you (the Sysop). If you Insert a base, all associated files from that point on will be renumbered. - 15 - RESET MESSAGE COUNTERS This option will allow you to reset the user's counters (high message read) to the number you enter. You will be asked if you are sure you want to do this. You will be presented with several options. Make sure you read the prompts as it will give you some information. Just hit RETURN if you do not want to go through with this and answer NO to the question Are you sure?. ALL counters This will allow you to reset the user's counters in ALL the message bases to a specified value. One Counter This will allow you set the user's counter in 1 message base. You will be presented with a list of the currently available message bases to choose from. Some Counters This option will allow you to reset the user's counters in certain bases. It combines the 2 options above. It will step you through each message base allowing you to enter a number to set the counters to. If you do not want to change the counters in that base, then just hit return and answer NO to Are you sure?. The program will then go onto the next base. CREATE MULTIPLE BASES This option will allow you to do a MASS creation of Message Bases. It will ask you how many message bases you want and then ask you for the information on the setup screen. The program will apply this information to ALL the bases it creates. You can then go back and change this information in the ones you want to. Just do a Edit A Base or Edit Message Bases and enter the information. Select Exit and if you changed the information, it will ask you if you want to reformat the message base. Just continue until you are finished editing all that you want to edit. EXIT This option will take you back to the Main menu. - 16 - EMAIL This option will allow you to edit the Email section. You will be presented with a dialog box with 3 options. RENAME EMAIL This will allow you to Rename your Email section. REFORMAT EMAIL This will allow you to reformat your Email. You will be presented a dialog box to enter the information in. Once you have entered the information, just select Exit. You will then be given the option of Reformat, Convert or Restore Original. These options work the same as explained in the Message Base section above. Once you make you choice, you will be asked if you are sure. Just select the appropriate response. EXIT This will allow you to exit back to the Main menu. Name This allows you to chose what you want to call Email. Max. Messages This will tell the BBS how many Email messages to allow. Once the BBS has this many Emails, it will not allow anymore until some are deleted. The larger the number, the bigger the file. 50 is a good number to begin with. If you expect a lot of Email traffic, then you may want to use a larger number. You can always increase it later. Max. Lines This will tell the BBS how many lines to allow before it becomes an Extended Email Message. This works the same as Extended Messages. Once you have Email set up the way you want, select 'Exit'. The program will then take you through the steps described above. Exit Allows you to Exit the setup screen. - 17 - FILE AREAS This allows you to edit your File Area information. You will be presented with a dialog box with several options. Most of these options work just like those described above in the Message base section. I will not go into as much detail as it is just duplicate information. A lot of the choices will take you through the same steps. The only difference is this is for the File Areas. EDIT A FILE AREA This will allow you to edit the File Areas. This option will step you through each File Area asking for the new information. Just select Exit after you edit the area and follow the prompts. If no information is changed and you either select Exit or Next, the program will just go to the next File Area or Exit back to the File Area dialog box. If it has changed, you will be asked if you are sure you want to do this. Below is the setup screen for the File Area. Name This is the Name of the File Area. This is the name that the users will see when they make their choice as to what File Area to go to. Folder This is the name of the folder that will hold all the files associated with that File Area. The files that are uploaded and the description files will go here. You will be asked if you want the program to create this folder. If it is already there, then there will be no problem if you say YES. Maximum Lines This is the maximum number of lines that will be allowed for entering a description. If it is set to 15, then only 15 lines of description can be used. You don't want to have too many lines but you also don't want to have too few lines. 10 - 15 lines is generally enough. In the File Area where I have ST Reports and Znets, I have it set to 15 because the contents of that issue usually run about 11 lines. Minimum Age This is the minimum age of a user that is required in order for them to enter into the File Area. 0 = Any Age. Upload Level This is what level the uploads will default to if the user that uploads the file does not have the privilege of choosing/setting the upload level. The user must have this File Access Level before he/she can see it. If he/she cannot see it, then they cannot download it, etc. I have all my files default to 255 when uploaded. This means that only I or anyone with that access level (generally only those with sysop access should have this level) can see it until it has been validated/released by me. I do this by changing the level of the file. - 18 - Alternate Drives This option will allow you to set up different drives for that File Area. If you wanted you Atari St Utilities to go to DE, then enter DE here. Each File Area can have it's own drive partition. These drives MUST ALSO be in the File Area field in the Drives and Paths screen. If you choose DE for your partition for this File Area, DE must also be in the File Area field in the Drives and Paths section. The below settings can either have the words On or Off typed in them or they can be toggled On/Off by clicking on them with the mouse. It does not matter if you type it in upper or lower case. Remote File Ops This tells the BBS that Remote File Ops are allowed. Not used at the moment. The below settings with the exception of Auto-Compress will tell the BBS to ask for this information when a user enters the description of a file that he/she uploaded or when the description of that file is being edited. Anonymous This tells the BBS that a user can upload a file anonymously. Ask Computer Type This tells the BBS to ask for the Computer Type. If you have the COMPUTER.DAT file in the DATA folder, then that file will be displayed and the user will have to make a choice. If the file is not found, then they will be able to enter in anything they want. See the explanation for COMPUTER.DAT for further information. Ask Monitor Type This tell the BBS program to ask for Monitor type. If you have the MONITOR.DAT file in your DATA folder, then the file will be displayed and the user will have to make a choice. If the file is not found, then they will be able to enter in anything they want. See the explanation for MONITOR.DAT for further information. Ask Program Type This tell the BBS to ask for the type of program. It was designed for asking whether or not the file is a Utility, Application, Game, etc. You can use it for whatever you want. If the file TYPE.DAT is in the DATA folder, then it will display it and the user will choose from this list. If it is not found, the user will be able to enter in any information they want. See the explanation for TYPE.DAT for further information. - 19 - Alt. File Header This tells the BBS to look for FHDRxx.TXT (xx = File Area number) and display it. This is the header information where it tells all about the file. It includes things such as Filename, Filenumber, Uploader, Date of Upload, etc. You can create this file using any of the variable tags and put in the information you want. If it does not find this file, then the built in header will be used. Auto-Compress This will tell CLEANUP.PRG whether or not to compress files that are not already compressed. If you want files to be compressed (such as text files, etc.) during execution of CLEANUP.PRG, then set this field to on. The type of compression used is set in the Cleanup section. Ask File Type This tells the BBS to ask for the type of file. It was designed to ask if the file is an LZH (LH1), LZH (LH5), ARC 6.02, etc. type of file. If the file 'FTYPE.DAT' is found in the DATA folder, then the BBS will display that file for the user to choose from. If it isn't found, then the user can enter anything they want here. You can use this file to hold any kind of information you want. Once you have set up the File Area the way you want it, select 'Exit'. The program will then create the necessary folders and files. You can also select Next or Prev to go to the next or previous File Area in order to edit it. Upon exiting using either option, if any changes were made, the program will respond and ask you questions and do what it is supposed to do. REFORMAT 1 AREA This option will allow you to reformat a File Area. You will be asked to choose the File Area and then you will be asked to enter the information. Once you have entered the information, you will be given the option of Reformat, Convert or Restore Original. These options work the same as explained in the Message Base section. The only difference is that if you Convert an Area to a new format and the number of lines is lower, then the file descriptions will be cut off after that many lines. There are no Extended file descriptions. You will be asked whether or not you want to do this. REFORMAT ALL AREAS This option will allow you to step through ALL the File Areas offering the same options as Reformat 1 Area. It will start at File area 1 and step through each and every File Area giving you those options. If you do not want to change anything, just select NO when asked if you are sure. This works the same as Reformat All Bases. - 20 - CREATE MULTIPLE AREAS This option will allow you to create a lot of File Areas at one time. You will be asked how many File Areas you want. You will then be asked to enter the information in on the setup screen. These settings will be applied to all the file areas that are created. You can then go back later and change this information on the File Areas you want to setup differently. EDIT AN AREA This option will allow you to edit a File Area. You will be presented with a list of available File Areas to choose from. Once you choose the area, you will be asked to enter in the information on the setup screen. If you change anything, you will be told this and asked if you want to reformat it. If you choose Yes, you will be given the option of Reformat, Convert or Restore Original. You will then be asked if you are sure. You can select Exit to quit editing or select Next or Prev to go to the next File Area or the previous File Area. Either way, if you change anything, you will be asked what you want to do before it goes to the next or previous File Area. DELETE AN AREA This option will allow you to Delete a File area. You will be presented with a list of available File Areas to choose from and then asked if you are sure. If you answer Yes, there is no turning back. You will then be presented with a choice of where to start at when changing the user's access. If you start at 1, then your (the Sysop's) access is changed. This will allow you to bypass changing access in the first 2 records which are reserved for you. If you delete a File Area that is before another one, the program will renumber all associated files. INSERT/ADD AN AREA This option will allow you to Insert a File Area. If you choose number 2 for instance, then the File Area will be inserted BEFORE File Area 2. to Add a File Area, just type in a number 1 higher than what is available. You will then be presented with the setup screen to enter your information in. Once you select Exit, you will be asked if you are sure. You will then be asked if you are sure. You will be asked what user # to start at when changing the access to this file area. You can bypass the first 2 records which are reserved for you (the Sysop). If you Insert an area, all File Areas above that number will be renumbered. EXIT This option will return you to the Main menu. - 21 - COMMAND TABLES This will allow you to setup your Command tables. This is where you define what command will be available to the user, etc. The are the Commands that will be available from the Main Menu, File Menu and Message Menu. You will need to know what the PROCEDURE names are. These are built in PROCEDURES that the BBS recognizes. You can also set up external programs, text files, etc. from the Command Tables also. Please refer to the Built in Procedures section for the names and explanations of these procedures. You should have gotten a COMMAND.DAT example file with the program. It is located in your DATA folder. You will be presented with a menu giving you 3 options. EDIT COMMAND TABLES This will allow you to edit your Command Tables. You will be presented with a menu with 3 options of editing Main Menu, File Menu or Message Menu. Choose which one you want to edit and you will then be presented with a dialog box with several options to setup the Command. RELOAD COMMAND TABLES This will allow you to reload the Command Tables from disk into memory. if you really make a mess of things and wanted to start over, you could just exit from the Command Tables and select this option and start over. This of course only works if you have not already saved the Command Tables. EXIT This will take you back to the Main Menu. Below is the layout of the Command Table screen. Keystroke This is the key that will need to be entered in order to use this command. Status This will tell the BBS whether the Command is On or Off. If you wanted to temporarily disable a Command, just click on Status and it will switch to Off if it is On or On if it is Off. - 22 - Type There are 4 type of Commands. Click on this field with the mouse and you will be presented with 4 items to choose from. Once you have chosen one of the below types, the program will return to the setup screen and the type will be in the Type field. Internal BBS Procedure These are the Commands built into the BBS. These built in procedures are listed in the Built in Procedures section along with an explanation of what each one does. If it is not a Built in Procedure, then it one of the below. Text/Menu/Script This tells the BBS that the name in the Filename field is one of these type of files and that it should display it to the user. Text files, Menu files or Script Files (not available yet) are to use this type. External Module This tells the BBS that the name in the Filename field is a program of some type and that it will need to execute it. You can run programs from the Command Table if the user chooses the Command. External BBS Module This also tells the BBS that the name in the Filename field is a program that it needs to execute BUT, there is a big difference in this type of file and the one above. This will tell the BBS to ALSO pass along certain information to the program. The User Editor is of this type of program and the location of the User information in memory is passed along to it. DO NOT use this type of field unless told to. If you do, it may have devastating results. Other modules will be written to specifically take advantage of this information and will tell you to set it up this way. Filename This is where you place the name of the Built in Procedure, the name of the Text File, Menu File or external program name. If no drive and path information is entered here, then the BBS will look in the MODULES folder for this file if it is a External Module or External BBS module or, if it is a text file, it will look in the TEXT folder for the file. If you want the BBS to look somewhere else for the file, the enter in the drive, path and filename of the file. Example: J:\MODULES\CHAT\CHAT.PRG or K:\MYSTUFF\JUNK.TXT. Reaction This is what will be sent to the user if he/she has Hotkeys enabled. You would enter something like 'Page Sysop!' if they selected the command to page the Sysop. Hotkeys just allows the user to make a selection without having to press return. - 23 - Access This will tell the BBS that user needs to have this Command Table Level (CTL) in order to use this command. This level is set in the User Editor under Security Levels for that user. If you assign New Users a CTL of 0 and you didn't want them to get into the File Areas, then you could enter a 1 here and New Users would not be able to access the File Areas. This works with ANY command. Parameters This will allow you to pass on parameters to programs that you execute from the Command Table. This is similar to passing parameters to a TTP file but, it allows you to pass them onto any type of program as long as the programs will accept them. The program should tell you what it needs. You can also place variable tags on this line. Please refer to the Variable Tags section for what is available. If a program took a parameter of the user's name for instance, you could put the variable tag {3} here and the user's name would be passed onto the program. Now you will notice some time fields. Remember, these times are to be entered in military time. They go from 00:00:00 to 23:59:59. Days of Week Down the left side of this screen, you will notice the days of the week. You can have a Command only on for certain days of the week if you wanted to and they would only work on that day. If the day is highlighted, then the Command is ON for that day. On At and Off At Times You will notice beside each day there is an On At and Off At time fields. This allows you to have that Command only on for certain times of the day. You can combine this with certain days of the week. Just enter the times you want this Command available. If you have the On At AND Off At times set at 00:00:00, then the command is considered ALWAYS ON. If you have some other time say, On At: 01:00:00 and Off At: 01:00:00, this would be the same as having that command turned OFF. You can have several commands with the same KEY entry and only have 1 on at a time. For instance, you could have your Online Games only on Monday through Friday from 18:00:00 (6:00 pm) to 23:00:00 (11:00 pm) and the rest of the time, that KEY would be used for something else. When you come to a blank spot in the Command Tables, the times will default to On At: 00:00:00 Off At: 00:00:00 and all the days will be highlighted. This makes the default for that command ALWAYS ON on every day of the week. Since this is what you will normally have anyway, we just saved you the trouble of having to do it. - 24 - Daily Schedule You will notice a box with the words Daily Schedule in it. This option allows you to set all the days to ON and all the times to a certain time for each day of the week. Just click on this box with the mouse and you will see a dialog box pop up. In it you will see On At: and Off At: with the time field beside each one. You can enter your On Times and Off times here and select Exit. It will return to the Command setup screen and ALL the days will be highlighted and all the times set to what you entered. This is just a quick way to enter all the On and Off times. When you select this item and you only want to change the Off time, then you could TAB over to the Off time and change it and the On Time would remain set at what it was. the same goes for just setting the On time. Exit This will allow you to Exit the setup screen. When you do, you will be asked if you want to Save the Command Tables. Choose what you want to do. Even if you do not want to Save them, the changes you made will still be in memory so the next time you coma to the Command tables, your changes will still be there. This is one of the purposes of the Reload Command Tables. It allows you to reload them from disk if you have chosen Exit and do no want the changes in memory (start over in other words). Once you save the Command tables however, the changes are permanent until you change them again and save them. All changes will NOT be Saved to DISK until you tell it to when it ask you. Cancel This option allows you to also exit from the Command Tables setup screen but, choosing this option will tell the program to forget what you have done. The program will not ask you if you want to Save the Command Tables either. if you selected it by mistake, you will have to go back in and make your changes again. This is the ONLY command that will make the program FORGET what you have done. ALL others will save the info into memory. Change Tables This option will allow you to change to one of the other Command Tables. You will be presented with the same dialog box that you got when you chose the Edit Command Tables option. Choose which Command Table you want to go to. Using this option will also save the changes you made to memory. Find Key This will allow you to search the currently selected Command Table for a particular KEY (entered in the Key field). You can enter upper or lowercase letters. - 25 - Print Tables This option will allow you to print out your Command Tables. You will be presented with 4 options. This option will only print out the Commands for the currently selected Command Table. If you want the other Command Tables printed out, then select them using the Change Tables option and reselect this option. Print Commands Only This option will print out the top portion of the setup screen only. It will not print out the time schedule for that Command. It will print out 8 Commands per page. Print Commands With Schedule This option will print out all of the information in the setup screen including the time schedule. It will print out 4 Commands per page. Print Commands With Partial Schedule This option is much like the one above except, it will only print the days in the schedule that are turned on (highlighted). If you only had Saturday and Sunday turned on in a Command, then it would only print out those days and times. It will print out 4 Commands per page. Command Summary This option will present you with a dialog box that contains a summary of the Commands available in the currently selected Command Table. It will display 8 commands at a time. It will show you the Keystroke, Filename and Reaction of each command. Click on the arrows to page up or down through the Commands. If you click on a Filename field, the program will take you back to the setup screen and will display the Command you selected. This is a quick way to locate a Command or even a blank spot to put something in. - 26 - PROTOCOLS This option will allow to edit the key that chooses the protocol and the filename of the external transfer program. Currently, the BBS uses it's own transfer program for everything except Ymodem-G and Zmodem. Ymodem-G is currently unavailable but will be added later on. You will be presented with 3 options. EDIT PROTOCOLS This will allow you to edit the Key required to choose the protocol and the filename of the program. You should have received a PROTOCOL.DAT file with your program. It should be in the DATA folder. There are 2 transfer programs called XFER.TTP (our own program) and XYZ.TTP. These files need to be placed in the MODULES folder. You can rename the files if you like keeping up with version numbers or whatever. Just make sure everything matches. XFER.TTP should be used for everything except Ymodem-G and Zmodem. You will be presented with a dialog box with the following options. Key This option allows you to assign a key to that particular protocol. Filename This is the filename of the external program. This must match with the name of the file in the MODULES folder. Next This will take you to the next available protocol. Selecting this option will save any changes you made to memory. Previous This will take you to the previous available protocol. Selecting this option will save any changes you made to memory. Cancel This option will allow you to exit without any of the changes being saved to memory. - 27 - Exit This option will allow you to Exit the setup screen. The program will then ask you if you want to Save Protocol Data. Selecting NO will still leave the changes in memory. You can select the Reload Protocol Data option if you wish to have the data put back to the way it was. Once you Save it though, the changes are permanent until you change them again and Save the information. RELOAD PROTOCOL DATA This will allow you to reload the protocol information from disk. If you made some changes and decided you wanted to start over, then select this option. EXIT This will take you back to the Main Menu. - 28 - MACROS Macros allow the user to enter in key sequences, characters, or whatever into a string which is saved to disk. When the user logs on and this file is found (located in the DATA folder), it will pull up the Macro data for that user. This will allow them to use this macro by pressing Control-A and then the number of the Macro. They do NOT hold down Control-A while pressing the number. If I stored my name in macro number 1, then anytime I wanted to put my name somewhere, all I would do is press Control-A and then the number 1 and my name would be inserted where the cursor is. You can allow up to 256 macros with up to 256 characters per macro per user. This is a little of an overkill though. Generally you would allow 10 macros with up to 20 characters per macro. You will be presented with 3 options. REFORMAT This will allow you to reformat/redefine your macros. When you choose this option, the program will ask you the number of macros to allow for each user and then how many characters to allow per macro. Selecting Exit with NO numbers in either dialog box that is presented will allow you to abort the operation. Once you have entered the information, the program will inform you that the MACROS.DAT file exist and ask if you want to overwrite it. DELETE This option will allow you to delete the MACROS.DAT file. You will be asked if you are sure you want to do this. EXIT This option will return you to the Main Menu. - 29 - EVENTS The Event System in the BBS is a way to allow you to schedule programs to run at certain times of the day and certain days of the week. This allows you to run maintenance programs, network programs, etc., that must be ran at certain times. Some programs are designed to run in this fashion. The EVENT.DAT file is stored in the DATA folder. This will provide you with 6 options. EDIT EVENTS This will allow you to edit an existing Event's information. Below is the Event setup information. Filename This is where you place the drive, path and filename of the program to execute. There is no default location that the BBS will look for these files so, you must tell it where to find the file. If there is no information in this field, then the Event will not be ran. Parameters This is where you would place any parameters that must be passed onto the program. This is like passing parameters to a TTP program. Priority This is where you would tell the BBS what priority this Event has when it comes to someone being Online when it comes time to run this event. There are 5 priorities. 0 - This will turn the Event off. 1 - This is Low priority. This will tell the BBS to wait until a user has logged off of the BBS before running it. If the time limit for this event has expired (the current time is later than the off time), then the Event will not be ran. If you really want this Event to run, then allow enough time between the On and Off time so that the difference will be greater than the amount of time a user has per call or, set it to a higher priority. 2 - This is Medium priority. This will tell the BBS too execute this program while the user is still online. It will warn the user ahead of time (set by the Warn Events Activating in xx Minutes on Settings page 2) that the event is going to take place and then when the time comes, it will tell them that it is executing the event. This would be okay for quick programs that need to be ran but, you don't want to kick the user offline in order to run it. - 30 - 3 - This is High priority. This tells the BBS to run this program no matter what. It will warn the user that the event is executing at the On time and will reduce the user's amount of time left for that call by the appropriate amount. When there time is up, the BBS will hang up on them and then execute the event. There will be a 1 - 2 minute difference between the time the user gets kicked off and the time the event actually runs. It will NOT however, kick the Sysop off. Your time left online will start counting into the negative numbers. 4 - This priority tell the BBS to run this Event after each call. When a user logs off (even the Sysop), the event will run. 5 - This priority is the same as 4 except, it will not execute after a local call (you logon from the keyboard). It will only run if the user is on remotely. Modem Info This is used to send information to the modem before executing this Event. If you wanted the phone to be taken offhook while the Event ran so that nobody could call, then you would enter the appropriate command that would tell the modem to take the phone offhook. For a Hayes Compatible type modem, this would be ATH1. After the Event has executed and the BBS returns to the WaitCall screen, the modem will be reset and ready for a call. Days of Week and Time Fields You can tell the BBS that you want this Event to be ran at certain times of the day and certain days of the week. To activate the Event for that day, just highlight the day(s) you want it ran. To highlight the day, just click on it with the mouse using the left mouse button. Set up the time that you want the Event to execute by entering the time in the On At and Off At fields. The BBS will execute the program at that that time or before the Off At time. To turn it on ALL the time, then enter 00:00:00 in both the On At and Off At fields. This tell the BBS that you don't care when it get ran that day, you just want it to be ran. Normally you would enter in certain times. These times are in military time. To turn it off for that day, you can also enter in something like On At: 01:00:00 and Off At: 01:00:00. This is the same thing as deselecting the Day to turn it off. - 31 - Daily Schedule If you click on this box with the left mouse button, you will be presented with a dialog box that has a On At and Off At time field. This will let you configure the Event to be ran the same time every day. It will set ALL times to what you enter and highlight ALL the days. This is just a quick way of setting the times up. If you want to only change all the On At times, then you could select this option and only enter the new On At time and the Off At times will be left alone. This goes for only changing the Off At time also. Next This will take you to the Next available Event. Previous This will take you to the Previous Event. Exit This will allow you to Exit the editing of an event. You will be asked if you want to save your Event Data. Even if you do not save your Event Data, all changes are still in memory. REFORMAT EVENTS This will wipe out ALL Event data. You will be asked if you are sure before it does it. EXTEND EVENTS This option will allow you to add more Events to your Event Data file. If you have for instance, 3 Events and you want to add more, just select this option and enter the number of events you want to add. You can abort this by not entering any information and selecting Exit. You MUST use this option in order to add more Events. DELETE EVENT This option will allow you to Delete an Event. You will be asked which Event number to Delete and then asked if you are sure. When you Delete an Event, the others are pulled up to take it's place. In other words, if you delete Event number 2, then number 3 will become number 2 and number 4 will become number 3, and so on. RELOAD EVENT DATA This will allow you to reload the Event data from disk. If you change a lot of stuff and just want to start over and you haven't saved the Event data, then you can use this option. EXIT This will allow you to return to the Main Menu. - 32 - DRIVES DRIVES AND PATHS The "Drives & Paths" menu is where you tell the BBS how it should store its data. We suggest leaving the path names the same, but you may change them to something you prefer. If you are going to use only one drive for each type of data, then simply only enter the one drive-letter in the appropriate field. If you plan to use multiple drives for a data type then enter all of the drives with no spaces between them. For example, if you would like to use drives C, D, and F for your data file, then enter "CDF" in that proper field. (Do not include the quotes of course). When the BBS sees this drive list (CDF) it will first check drive C for a file, then drive D, and lastly drive F. You may rearrange the order of the drive list. For example, if drive "F" was a RAMdisk you would want it checked before drives C & D, since a RAMdisk is so fast. The different types of data stored by the BBS are as follows: Data Files This is where files such as the userlog, mask information, and .LOG files are stored. Message Bases This is where all the Message Base and Email files are stored. File Areas This is where all the File Area folders and information are stored. Text Files This is where all text files are stored. These are file such as MAINMENU.TXT, LOGOFF.TXT, etc. Backups This is where all files that are backed up by the BBS are stored. Module Routines This is where external "modules" are stored. These are files such as ARC.TTP, LZH.TTP, XYZ.TTP, Event Modules, etc. Fmail/Fmessages This is where all Fmail and Fmessage files are stored. Fmail is just Email with a file attached and Fmessages are just messages with a file attached. Temporary Files This is where files such as Informer files are stored. - 33 - Main BBS Folder This is where all the folders and information above is stored. If you wanted ALL files associated with the BBS in the folder TRANS (We recommend it) then do not alter this field, otherwise change it to what you want. Exit After you have set up your drives & paths select the "Exit" button. The system editor will now create all of the folders for you. If you have selected a lot of partitions this may take a little while. If you have already created the folders, then there will be no harm in it trying to create the folders again. This is just to insure that ALL folders have been created. After the folders have been created, the program will copy some of the files to their proper location if it finds them. Cancel This will allow you to Exit the setup screen without any changes being saved to memory. You will not be asked anything and will return to the Main Menu. - 34 - USERLOG This option will allow you to Reformat your Userlog or change the size of it. You will be presented with 4 options. The USERS.DAT file is located in the DATA folder. You may want to back it up occasionally. REFORMAT USERLOG This option will allow you to zero out your ENTIRE Userlog. You WILL be asked if you are sure. It's a good way to piss off your users. INCREASE USERLOG This option will allow you to add more User slots to your USERS.DAT file. DECREASE USERLOG This option should be used with care. It will allow you to decrease the number of slots available in the USERS.DAT file. A very large number of user slots will slow the program down. If you find that you set the BBS up for too many users, then you can use this option to decrease it. There is a safety feature built in. The program will first search the USERS.DAT file starting at the end and working it's way back to the start. When it comes to a slot that has information in it, it will stop and tell you how many slots you can delete. Enter any number up to that point. The program will make a BACKUP copy of the USERS.DAT and USERS.IDX file. It will rename them to USERS.DA and USERS.ID. It will use these files to copy the information to the newly created USERS.DAT file and USERS.IDX file. If you change your mind, then you can delete the new files and rename the old files to their appropriate names. If a user has joined since you created the new file however and you do this, then their information will be lost. EXIT This option will return you to the Main Menu. REFORMAT MASK This option will allow you to Reformat your MASKS.DAT file which is located in the DATA folder. A Mask is a way to set up user information in a record so that you can apply all the information stored in the mask to the user. It is easier than having to enter the information into the user's record by hand each time. You just tell it what mask to apply and that's it. There are 100 mask available for you to use. There should already be a MASKS.DAT file in the DATA folder with the first couple of Mask defined and the last mask (number 100) defined. Number 100 is setup to apply to the Sysop or anyone you want to give this access to. 100 has everything maxed out. You set up a Mask in the User Editor. - 35 - CLEANUP This option allows you to set up the information for the Cleanup program. The Cleanup program is a program that you can run as an Event to do certain BBS maintenance functions. Questions with a triangle beside it can either be selected with the mouse or the information typed in. The Cleanup program is currently in the testing stages and is not available at this moment. Delete Email after ____ Days This will tell the program how long to keep Email before it is deleted. If you enter a zero here, the program will not delete any Email now matter how old it is. Delete Fmail after ____ Days This works the same as above except for Fmail messages. Fmail is just Email with a file attached. If you enter a zero here, the program will not delete any Fmail. Delete Fmail File Also ___ This tells the program whether or not to delete the Fmail file when it deletes the Fmail message. Archive File Areas ___ This tells the program whether or not you want it to compress files that are not already compressed. This goes hand in hand with the Auto-Compress selection in each File Area setup. Archive File Areas with (ARC/LZH) ___ This allows you to select either ARC or LZH as the compression type. Backup Files in BACKUP.DAT ___ This tells the program whether or not to backup the files that are listed in the BACKUP.DAT file. Delete Inactive Users after ___ Days This tells the program how long a user should be inactive before he/she is deleted from the User Log. Each user can be set up to be bypassed when this operation is performed. Refer to the User Editor section for more information. If you enter a 0 (zero) here, then no users will be deleted. - 36 - Keep TRANS.LOG for ___ Days This tell the program how long it should keep a backup of the TRANS.LOG file. If you enter a number greater than 0, then the program will backup that file using a number system to track it. For instance, if you wanted the TRANS.LOG file to be kept for 2 days, the program would copy the TRANS.LOG file to the BACKUP folder and name it TRANS1.LOG. It would then create a new TRANS.LOG file. On the second night, it would copy the file to the BACKUP folder and rename it to TRANS2.LOG and create another new TRANS.LOG file. The third night, it would delete TRANS1.LOG, rename TRANS2.LOG to TRANS1.LOG and copy TRANS.LOG to the BACKUP folder and rename it to TRANS2.LOG and create a new TRANS.LOG file. The higher the number, the more backups it will make before deleting the first file. This helps keep the TRANS.LOG file manageable and also provide you with a backup. Re-Run BBS Each Night ___ This tells the BBS to RERUN itself each night so that memory can be cleared. Reboot Computer Each Night This will cause the computer to re-booted so that memory can be cleared even better. This helps keep junk from getting into memory and causing problems. You will need to make sure that you have the BBS program setup so that it will auto-boot after the computer re-boots. Keep DOWNLOAD.LOG for ___ Days This works the same as TRANS.LOG except it's for the DOWNLOAD.LOG Keep UPLOAD.LOG for ___ Days This works the same as TRANS.LOG except it is for the UPLOAD.LOG. Keep CLEANUP.LOG for ___ Days This works the same as TRANS.LOG except it is for the CLEANUP.LOG. - 37 - EDIT SETTINGS This selection will take you to another menu/dialog box. This is called the Setting Pages menu and gives you the option of choosing pages 1 through 5. The settings control a lot of the BBS and are broken down into 5 pages. The next five screens are the general settings for your BBS. These sections contain all of the normal questions you would expect from a BBS program, plus many that are unique to Transcendence. The first three pages are all text fields, (with the exception of one) and the last two are ON/OFF settings. The ON/OFF settings can be toggled by clicking on that field with your left mouse button. PAGE 1 BBS Name This is the name of your BBS. This is used sometimes in the program. Sysop Password This is the password that will be needed if the user has Sysop Access. Whenever the Secondary Password is asked for, this is the password that needs to be entered. The password is not case sensitive, but the BBS will disconnect the user if it is misspelled. System Password This is the password that is needed when you have "Private BBS" (explained later) turned On. Last Caller This contains the Handle of the last caller to the BBS. Last Run Date This is the date the BBS was last ran. Keep Last How Many Callers This is the number of how many callers the BBS will track as who's called the BBS. When the user selects the command of 'Who's Called' they will see this many callers. Password Echo Character This is the character that is echoed back to a user when a password is entered. You want it to be a character that is recognized by all computers. You may want to use something like a period or an asterisk. Do not use the plus '+' character, it will put most modems into command mode! - 38 - Idle Baud Rate This is the Baud Rate that the modem idles at. In other words, the Baud Rate at which the modem is set to between calls. Normally this would be the maximum baud rate of your modem. If you are using a high speed modem, then you may want to set this field to 19200. Min. Baud Rate This is the minimum Baud Rate that you will accept from a user. If you don't want 300 baud callers, then enter 1200 and so on. Max. Baud Rate This is the maximum Baud Rate you will accept. Normally this would be the maximum baud rate of your modem. If you are using a high speed modem, then you may want to set this field to 19200. Default Country When a user is asked for their Country, if they press return, this is what the BBS will default to. New User Mask This is the mask that will be applied to ALL New Users. A user is considered New if he/she does not have an account on the BBS and answers Yes to the question of whether or not they wish to have an account on the BBS. The mask system is explained in detail in the User-Editor section. Guest User Mask This is the mask that will be applied to Guest users. A user is considered a Guest when he/she does not have an account on the BBS and answers No to the question of whether or not they want an account on the BBS or if they type "Guest" or "Visitor" for their handle. Verified User Mask When using the Auto-Verifier, this mask will be applied if the user passes the auto-verification. Auto-verify is explained later. Idle Timeout This is the amount of time that elapses when no interaction to the BBS has taken place by a user. After this amount of inactivity has taken place, the BBS will automatically log the user off. He/She will be warned 30 seconds before hand. This number is in seconds, and can range from 30 to 255. - 39 - PAGE 2 Calls Today This just displays the number of calls the BBS has received today. Calls Total This is the total amount of calls the BBS has received since it was created. If you were previously running a BBS you may want to put the number of calls from that BBS program, here. The number of calls will start at that point. Otherwise leave it blank. Node Number This is for Networking, for now leave it at its default. Node Name This is for Networking, for now leave it at its default. Node City This is for Networking, for now leave it at its default. Send Feedback to User # This will allow you to redirect Feedback to any valid user. Normally this is set to you number but, if you wanted to go on vacation and had a remote sysop handling things, you could tell it to redirect all feedback to that user number. Before changing this number, be sure the user number you change it to does exist! Local Dial This is the prefix for your modem to dial a local number, normally this would be "ATDT" (Tone) or "ATDP" (Pulse). Long Distance Dial This is the prefix for your modem to dial long distance. Normally this would be "ATDT1" (Tone) or "ATDP1" (Pulse). Area Codes These are the area codes that you can reach locally. This is how the BBS can tell if a caller is local or long distance. - 40 - Chat On This tell the BBS what time to start allowing the users to page you. Chat Off This tell the BBS what time to stop allowing the users to page you. Initialize Modem Every xx Minutes This tells the BBS how often to send the modem initialization string to the modem between calls. The BBS will resend it this many minute(s) later. Enter '0' if you do not want this option. 255 is the maximum input for this option. Warn Events Activating in xx Minutes This will tell the BBS when to start warning a user that an event is about to take place. If a user has 60 minutes online, and their time limit is shortened due to an upcoming event, the BBS will tell them. This is only if their time left is greater than this figure. You may enter values up to 255 in this field. Upload File Area This tells the BBS what file area to send ALL files to. This was designed to allow the Sysop to have all files sent to one area and then decide where to put them when validated. This setting works hand in hand with 'Uploads go to Sysop File Area' on page 5. One will not work without the other. This number (File Area number) must be higher than 0 if this function is going to be used. Select '0' if you do not want to use this function or you can turn it off on Page 5. BBS Operation Hours This is the time that the BBS will be active. Click on the words "BBS Operation Hours" and a dialog box will appear. If your BBS will only be up certain hours of the day, then enter the hours in these fields. During "ON" times (When your BBS should be up) the BBS will send the normal string to your modem, so the modem will answer the phone. During "OFF" times, the BBS will send a string to the modem causing it not to answer the phone. - 41 - PAGE 3 Lock Baud Rate This tell the BBS to lock the Baud settings in the computer to a certain baud rate. This is only needed if you have a high speed modem or MNP (Data compression) modem. When you use this the BBS will always "talk" to the modem at this baud rate, although the users can still call at other baud rates. This is explained in more detail in the section on configuring your modem. Auto-Informing Messages to User # This works the same as Feedback goes to User #. Any Informer messages goes to this user. Normally this would be the Sysop (User #1). The Auto Informer is explained later. Default Window Size This is the default size of the window when Transcendence is booted up. The next 2 items are templates. This will allow you to set up how you want the user to enter in the State or Phone Number. There are 4 types of characters the BBS will recognize in this mask and act on. The BBS used to these 2 items automatically but, due to European information being in a different format, I had to change it and decided to leave it up to the Sysop as to how he wanted it. X (uppercase X) will tell the BBS to convert the data the user enters to uppercase. The user will not have to press the Shift key to do this. This character will also tell the BBS to accept ANY printable character as input. x (lowercase x) will tell the BBS not to convert the data to uppercase if the user does not have the Shift key pressed. If they do, then the BBS will accept it as an uppercase though. This will also tell the BBS to accept ANY printable character as input. # (number sign) will tell the BBS to only allow numbers for this position in the template. | (the BAR character) will tell the BBS to wait for the user to hit RETURN before processing this data. If this is left off, then when the user reaches the maximum number of characters that can be entered, the BBS will automatically process the data as if the user hit RETURN. Any other character in the template will be automatically inserted by the BBS as the user enters the data. For Example, the Phone Number template was (###) ###-####|. The BBS would then automatically enter the '(', ')', ' ' (space) and '-' as the user typed in his Phone Number. - 42 - State Mask This is where you set up the template for the State information. The way it was set up in the BBS before was XX|. This would tell the program to allow 2 characters to be entered and convert them to uppercase and wait for the user to hit RETURN. You can enter up to 20 characters in this field. You can use all 20 for data and not use the '|' or you can use 19 characters for data and use the '|'. Phone Mask This is where you set up the template for the Phone Number. The way it was set up in the BBS before was (###) ###-####|. This would tell the BBS to allow the user to enter in 10 numbers and automatically insert the other characters as the user type in his Phone Number. You can only use up to 14 characters for data. The last space is only to be used by the '|' character. If you do use it for something else, it will be ignored. Time Left for Online Game This allows you to set the amount of time (in minutes) that is required for a user to have left Online before they can play an Online Game. For example, if you set it to 15 minutes, then the user will have to have 15 or more minutes left online for that call in order to play the game. This will help stop a user waiting to the last minute to go into an Online Game and spending more time than he is allowed online. PAGE 4 The next two pages are "toggle" fields. Using your left mouse button you can toggle them on or off. If the field is highlighted, then it is ON. RTS/CTS This tell the BBS to set RTS/CTS On/Off. This is only used for high speed modems or MNP modems. Most versions of TOS have a problem with RTS/CTS and require a patch to use it. Most of the patch programs can be found on the Transcendence Support BBS. RTS/CTS prevents remote users from getting too much text at once, or loosing text, when they connect to a high speed modem. This is known as hardware handshaking. Allow Remote Sysops If this is off the BBS will not allow a remote user to get into the Sysop Mode, even if they have access. It is simply a precautionary measure. - 43 - Screen Saver This tell the BBS to activate it's built in screen saver. The screen saver will toggle between a black screen and a normal screen if you are using a color monitor. If using a monochrome monitor, it will just toggle between black/white and white/black. The screen saver is a simple one and there are better ones already available that you may want to use. Allow Handles This tells the BBS whether or not to allow handles. If Off, the user's handle will be the same as their real name. Show VT52 Codes If this is turned on the BBS will display VT52 codes (Escape sequences) on the local end. If it is off you will see the actual ESC sequences, and won't see the color changes, text effects, etc. Snoop Mode This tells the BBS whether or not to have Snoop Mode default to On or Off when it is booted up. When snoop mode is on the sysop can see what a user is doing while online. If snoop mode is off, then the sysop can not see anything the user is doing. Having snoop mode off can increase the modem output slightly. This can also be toggled on/off with a function key. Printer Echo This tells the BBS to echo everything to the printer. You can use a lot of paper this way. If you want to generate a lot of paper to recycle, then this is for you. It just logs everything that is done by all users to the printer. This can also be toggled on or off with a function key. Disk Log This tells the BBS to send all Log information to TRANS.LOG in the DATA folder. Printer Log This tells the BBS to send all Log information to the printer. Fido This tells the BBS that you are Using Fido (BinkleyTerm). The BBS will look for SPAWNBBS.BAT (Created by Binkley), and react according to its contents. After the call is over the BBS attempts to run FIDOMAIL.BAT, which should have Binkleyterm's filename in it. - 44 - Local Security This tell the BBS that anytime the BBS is accessed from the keyboard, that it should ask for the Local Security Password. This is to help prevent those that come over to your place and decide they want to get at some information. This applies to access to the BBS, Sysop Functions (Dos commands) and the System Editor. If you implement this feature, and forget what the password is you can not run the System Editor, or get into your own BBS (Other than normal logon). It is very important you use this feature with caution. Term At logon This tell the BBS to ask for the terminal type each time a user logs on. If this option is off the BBS will allow the user to set up his/her terminal preference in their settings. The system will default to whatever is in the MENUS0 folder (normally ASCII text files) until the user logs on if this option if off. Hard Drive This tell the BBS that you are using a HD for the BBS. If this is turned off (Please, not a floppy based BBS!!!) the BBS will ask you to insert your data disk(s) after it reads the TRANS.DAT file. This is so (People have actually done this!?!) someone can run a BBS from a floppy, and swap the "Boot" disk with the "BBS" disk. Hopefully you will never experience this feature. You cannot run a good BBS from floppy. New User Email This will force a New User into Email when they apply for an account on the BBS. The Email will be sent to the user setup to receive Feedback on Settings Page #2. The BBS will look for a file called NEWEMAIL.TXT and display it just before it puts the user in the editor so you can explain what is about to happen. Warn Low Space This tell the BBS to warn you when you are getting low on disk space. Whenever a partition has less than 500k free, you will get a warning when you log on. Printer Bells This tells the BBS to ring the printer bell also when it rings the system bell. This is handy if you have your monitor off and the system bell is sounded. You will need to have your printer on of course. Not having the printer on will cause the BBS to lock up until you turn it on. Some printers do not have speakers, refer to your printer manual to see if yours does. - 45 - Post? During QuickScan This will tell the BBS to ask the user if he/she wishes to post on that base during a QuickScan. If the user has QuickScan Message Bases turned on and comes to the end of the new messages, then the BBS will ask them if they wish to post on that base before it proceeds to the next base. If the user has replied to a message, then it will not ask them if they wish to post. Acknowledge Local Call If this is turned off the BBS will ignore local logons. The logon will not update the caller numbers, or be reported in the "WHO'S CALLED" list. Settings, New User This will force the new users into the Settings menu. This is where they set a lot of their defaults that is to be used by the BBS while they are online. Color Toggling This will tell the BBS to cycle through the colors. This is another form of a "screen saver," and it may be used in color or monochrome. Ring Back Local Ringback is a feature that lets the BBS call users back. If this is on the BBS will be able to call users back, if their area code is in your AREA CODE LIST (Settings Page #2). Ringback was designed mainly for users getting bad line noise, or are on "measured service" lines. When making a ringback call the BBS uses the "Data Phone Number" of the user, that is the second phone number it asks them for. - 46 - PAGE 5 Ringback Long Distance This is a ringback feature for long distance callers. Under normal circumstances you would want this feature off, unless you want to incur the expense of calling long distance users back. A long distance user is someone who's area code is not in your area code list (Settings Page #2). Auto Verify Local The Auto-Verify feature is used to verify a new users phone number. When a new user logs on, and is in your area code list, (Settings Page #2) the BBS will display a text file explaining what the auto-verify is, and then it will call them back and expect their modem to answer the call. The BBS will make three attempts to call them. If it succeeds, it will ask them their name & password, if it is correct they will have the "Auto-Verify Mask" applied to them instantly. This can ensure you that users give you a good phone number, and bypass you having to manually call them for verification. Auto Verify Long Distance This is the long distance equivalent of the above feature. Normally you would not want this feature on, since it would really rack up the phone bill. Uploads go to Sysop File Area This will tell the BBS that all uploads should go to the File Area defined here. This goes hand in hand with the corresponding question on page 2. Visual Alerts This will cause the screen to flash anytime the system bell is rang. This is to help the hearing impaired and those that may have the volume on their monitor turned down. Inform New Logon This tells the BBS to inform the user, set in Auto-Informer Messages to User # (Settings page 3) that a new user has logged on. When the user defined to receive informer-messages (Normally the Sysop) logs on they will be notified that a new user has logged on. The BBS will display some of their information, and allow the Sysop to preform routine maintenance right there. See the section on "The Auto Informer" for further information. - 47 - See Passwords Locally This tells the BBS whether or not to allow passwords to be seen locally. When this is off the Sysop (Or anyone else local) will see the "password echo" characters, instead of what the user is actually typing. Otherwise anyone local could see the password as the user types it. Inform of Bad User Logon This works the same as Inform New Logon except it informs you that a user that has been flagged as Bad, has logged on. Questor LZH Mode This is no longer used. Private BBS This tell the BBS not to allow anyone onto the BBS unless they know the System Password (Settings Page #1). There may be times in which you only want to have certain users be able to logon. BBS Answers Phone This tells the BBS that your modems "Auto-Answer" feature is turned off, and that the BBS should send an Answer command to your modem when it detects the phone ringing. This is explained in more detail in the section on setting up your modem. - 48 - MISC. VIEW SETTINGS This option will allow you to page through the settings showing you what you have selected. It will also show you the Message Base info and File Area info. Data CANNOT be edited while viewing your settings. SET COLORS This option will allow you to set up the colors the BBS will default to when ran. To increase the numbers, just click on the + field and to decrease the numbers, click on the - field. If you click and hold on one of the fields, the system will continue to increase or decrease the numbers. The colors will change as you change the numbers. BAUD RATE EDITOR This option will allow you to setup what baud rates are allowed at what times during the day. This will allow you to lock out certain baud rates during peak hours or whatever. - 49 - Chapter 2: Built-in BBS Procedures The BBS Built-in Procedures are commands that you allow the user to have access to. They can have their own KEY, set at certain access levels, turned on and off, turned on and off on certain days and at certain times, access text files, access external programs and much more. You activate and setup these commands via the Command Tables section in the System Editor. There is four sections of commands. These are, General, Main Menu, Message Menu and File Menu. Below is what each command will do. GENERAL These commands can be used in the Main Menu, Message Menu, File Menu or the Menu Processor (menus). CALLSYS Allows the user to PAGE the Sysop. CONTLIST Allows the user to toggle Continuous Scroll On/Off for the file listings. EMAIL Allows the user to access the Email section. FEEDBACK Allows the user to Leave Feedback. This will cause the user to enter the Email section but, the program automatically sends the message to the user that has been defined in the 'Leave Feedback to User #' field in the System Editor. FILE_xxx This command allows you to access the File Area # (xxx) from within a MENU file. Example... 1 p FILE_1 * Will send the user to File Area #1. GOODBYE Allows the user to log off of the BBS. - 50 - MACROS Allows the user to access the Macros section to define their Macros. MAIL_xxx This will allow you to send Email from within a MENU file to the User# (xxx). This is good for adding a logoff choice to send Email to the Sysop, Co-Sysop, etc. before the user logs off. You can also have several feedback choices from the Main Menu. Example... 1 p MAIL_1 * Will send the user to Email and select User #1 as the recipient. MARKBASE Allows the user to Mark which Message Bases he/she wishes to take part in. MSG_xxx This command allows you to access the Message Base # (xxx) from within a MENU file. Example... 1 p MSG_1 * Will send the user to Message Base #1. OFF Allows the user to use the OFF command instead of goodbye. This is a quicker method of logging off. This will also display the OFF.TXT file instead of the LOGOFF.TXT file. OFFNOT Allows the user to abort logoff in the menu processor. Example... MENU Selection: 2 1 p MAIL_1 2 p OFFNOT [1] Send Mail to Sysop [2] Abort Logoff - 51 - ONLINE Allows the user to access the Online Games section. OTHERBBS Allows the user to access the Built-in BBS Listing. PARMEDIT Allows the user to edit their parameters. The user (unless he is a new user) will not be able to change their Name or Handle. All other items can be changed. The user will have to request this to be done by you (the Sysop). This was added so that the user could not change his Name or Handle and re-enter an online game as someone else. RINGBACK Allows the user to request the RINGBACK feature. SCANEDIT Allows the user to mark which File Area he wishes to be active for things such as Searches, Scan for New Files, etc. SETTINGS Allows the user to adjust their settings. When this command is used, the BBS will display the EDITUSET.TXT file. SYSOP Allows the user to access the Sysop/DOS mode. TERMINAL Allows the user to set his/her terminal(VT52, ASCII, etc.) type. UEDITOR Allows the user to access the User Editor. USERLIST Allows the user to get a listing of the current users of the BBS. USERMES Allows the user to send a message that each caller will see as part of the logon sequence. USTATS This is another form of PARMEDIT. It only allows the user to change his Password (at the moment). VIEWCALL Allows the user to view the Who's Called Listing. - 52 - MAIN MENU These commands can only be used for the Main Menu. FILES Allows the user to gain access to the File Areas. F_SCAN Allows the user to scan the File Areas for new files. When using this command, the user will be returned to the Main Menu after the scan for New Files is completed. JUMPBASE Allows the user to Jump to another Message Base. MESBASE Allows the user to choose from the currently available Message Base to go to. Q_SCAN Allows the user to QuickScan the Message Bases for new messages. ZIPSCAN (Currently inactive) Allows the user to collect all of the new messages and have them either ARCd, LZHd, or sent as ASCII. He then can download these messages so he can read them offline. A QuickMail compatible version of this command is in the works. It may also end up as a separate program. - 53 - MESSAGE MENU These commands can only be used for the Message Menu. BASEINFO Allows the user to get information about the current Message Base. CHECKM Allows the user to check for message [T]o the user [F]rom the user or [B]oth. ENTERMSG Allows the user to enter a message. EXITMSG Allows the user to Exit the Message Base. MARKREAD Allows the user to read the message he previously marked for reading. MTOPIC Allows the user to view/change the Message Base Topic. NEW_MSG Allows the user to read new messages in the current Message Base. NEXTBASE Allows the user to move to the next available Message Base without a listing of available Message bases. OTHERMSG Allows the user to go to another Message Base and provides a listing of the currently available Message bases. PREVBASE Allows the user to move to the previous available Message Base without a listing of available Message Bases. READBACK Allows the user to read messages in reverse order. READFORW Allows the user to read messages in foward order. - 54 - READMSG# Allows the user to start reading messages at a certain number. SEARCHM Allows the user to search the contents of messages for certain words, etc. SETHIGH Allows the user to set his/her High Message Counter. - 55 - FILE MENU These commands can only be used for the File Menu. ARCUTILS Allows the user to go to the ARC/LZH DL Utilities. BTCHSEND Allows the user to start downloading the files that have been marked for batch download. CATALOG Allows the user to get a Catalog (short) listing of available files in the current File Area. DOWNLOAD Allows the user to enter the number/name of a file(s) to download. EXITFILS Allows the user to exit the File Area. FILOCATE Allows the user to do a Global search for a filename. FSYSOP Allows the user to access the File Maintenance section. LISTING Allows the user to get a Full Listing of the available files. MARKFILE Allows the user to Mark a file(s) for download. NEWFILES Allows the user to get a listing of all new files in all available File Areas. When using this command, the user will be left at the last File Area that was scanned. NEXTSIG Allows the user to move to the next available File Area without a listing of available File Areas. - 56 - OTHERS Allows the user to choose from the list of available File Areas to move to. PREVSIG Allows the user to move to the previous available File Area without a listing of available File Areas. READFILE Allows the user to enter the name/number of a file to read. - 57 - SEARCH Allows the user to globally search the contents of a file for a particular word, letter, etc. SETLIST Allows the user to update his New Files Scan Date to the current Date so that ALL the files will not appear as New Files to him. SINCEDTE Allows the user to globally search for files uploaded since a certain date. UPLOAD Allows the user to upload a file to the current File Area. VIEWMARK Allows the user to view the file that have been marked for batch download. WIDELIST Allows the user to get a WIDE listing of all available files. - 58 - Chapter 3: Transfer Protocols Transcendence uses external programs to do it's file transfers. Currently, there are two different programs to do your transfer with. The first program is 'XFER.TTP'. This program is included with the BBS program. It includes Xmodem Checksum, Xmodem CRC, Xmodem 1K, Ymodem Batch and Fmodem Batch. The second program is XYZ.TTP from Alan Hamilton 'Starfall Software'. This program is available on most BBS systems including my BBS. I do not have the rights to distribute the program with the BBS, therefore it cannot be included with the package. You should use version 2.01 or higher of XYZ.TTP. Any version lower than 2.01 will not work correctly with the program. This program is Shareware so if you use it, please register it. It is well worth the small amount of money he is asking for. Both of these programs should go in your MODULES folder. Hopefully in the future, I will have ALL transfer protocols in one single program. Ymodem-G is being worked on. Refer to Chapter 1 for instructions on setting up these protocols. - 59 - Chapter 4: Personalizing Your BBS This chapter deals with personalizing your BBS to the way you want it. The Menu Processor, Data Files and Text Files are one of the major ways you can do this. Through the use of these files, you can make your BBS look TOTALLY different from the other guy's. Also, the use of Variable Tags in these files can be used to display variables that are stored by the BBS internally or Sysop definable variable Tags. MENU PROCESSOR The Menu Processor allows you to design Menus to control quite a few things. One of the major uses is for Online Games. It does however have a lot more uses than that as the majority of the BBS Procedures can be used from within a Menu. This opens up a wide range of possibilities. Through the Menu Processor, you can have the BBS execute programs, display Text Files, use the BBS Procedures, go to certain File Areas or Message Bases, send Email to certain people, organize your file Area and Message Bases into categories, and so on. Setting up a MENU A MENU must be laid out in a certain way. The first three lines of a menu describe how the menu should work. The first line is the OPTIONS line. It tells the BBS is it's a MENU, if the user can ABORT it, what level a user must be to access it, and many other things. The second line is the PROMPT line. It is the prompt that the user will see after the menu has been displayed. The third line is the number of menu selections available in that menu. After the first 3 lines is your Selection List. This list can be as long as you specified in line 3. After the list is complete, you will then place the text that the user will actually see. The text portion can be anyway you like. You can include VT52 codes, ANSI codes, put text in any location, etc. Whatever you want. - 60 - OPTIONS LINE The OPTION line MUST start with the words MENU or TEXT. TEXT files will be explained later. After that, you can place any of the other options in any order you want. Available Options MENU This tells the BBS that this file is a MENU file. TEXT This tells the BBS that this file is a TEXT file. This is not really needed for a Text File but, if you plan to use the NOABORT option or others explained below, then you will have to place the word TEXT as the FIRST option for a plain text file. NOABORT This tells the BBS to not allow the user to abort the output of this file with a ^C (Control-C). NOPAUSE This tells the BBS to not allow the user to pause the output of this file with ^S (Control-S). LEVEL_xxx This tells the BBS that the user must have a level of at least xxx to see or use this menu. xxx can be any number from 0 to 255. AGE_xx This tell the BBS that the user must be at least xx years old to see or use this menu. MONLY This tells the BBS to only allow Male users to see or use this menu. FONLY This tell the BBS to only allow Female users to see or use this menu. - 61 - FREE This tells the BBS to put the user in Free Time mode. This means that the user will not be charged online time as long as they are in this menu. This was designed so that you can use alternate Chat programs and the user not get charged any time while in chat. This causes the BBS to act as if the built in Chat mode was used as it doesn't charge the user any time. Examples: MENU NOABORT LEVEL_100 This would tell the BBS to only allow users with a Menu Access Level of 100 to see or use this menu and they could not abort the output of the menu with ^C (Control-C). MENU AGE_18 NOPAUSE FONLY This would tell the BBS to only allow users that are 18 or older and Female to see or use this menu. They cannot pause this menu with ^S (Control-S). Selections Line The selection line is anything you want it to be. This is the prompt that will be displayed to the user to make their selection. Usually it would be something like "Make your Selection: ". This line can be any length from 1-80 characters, so you can center it or whatever. Menu Selections You may have up to 256 selections for each Menu file. The number of selections will be reflected in Line #3 of the Menu file. The forth line starts your selections list. This will tell the BBS how to handle that selection. You can have four types of selections from a menu. The syntax for the selection looks like this: key type filename Return (Y or N) Special KEY The key field is the keypress required from the user to use that selection. You can also use the DEFAULT command in the key field. This will tell the BBS that this is the action to take if a key is selected that is not in the selections. Normally this would be combined with the Exit command explained later. Another option in the Key field is the '@' key. This will tell the BBS that if the user presses RETURN, to do this selection. Since it is hard to enter the RETURN character in a file, the '@' symbol is used as a replacement. - 62 - TYPE There are four different Types of selections you can use. Below is a description of each type. P or B Using one of these characters will tell the BBS that this selection is used to perform a COMMAND normally performed by in the COMMAND TABLES (built in Procedures). Refer to the Built In Procedures section for explanations of these Commands. With this, you could have menu options to Page the Sysop, Leave Feedback to a user, or just about anything. You would place the name of the Command in the Filename part of the selection. C, E or X Using one of these characters will tell the BBS that this selection is to be used to execute an external program. An example would be running an separate Split-Screen chat program. The drive, path and filename of the program to execute is placed in the Filename field of the selection. if only the filename is given, then the BBS will look in the MODULES folder for the file. You would place any parameters that need to be passed onto the program in the Special field of the selection. D Using this character will tell the BBS to execute an External BBS Module. This is an external program that is specifically designed to receive the buffer address information passed onto it by the BBS. DO NOT use this Type option unless told to. You should get instructions with the program explaining how to set it up. The programs will use special information passed onto it and if you do set it up properly, the program or BBS will probably crash or do nasty things to the information located in the buffers. The buffers holds information about the user, system, currently defined variables, etc. If the location of this information is not passed on correctly, it can have ill effects. T or M Using one of these characters will tell the BBS that this selection is to be used to display a Text file or a Menu file. You can have Menus within Menus. The complete path and filename of the file to display is to be placed in the filename field of the selection. If you do not include a path, the BBS will look inside the MENUSx folder for the file. You can go to 25 levels of Menus (Menus within Menus). You will get an error message if you go over that limit. - 63 - O or G Using one of these characters will tell the BBS that this selection is to be used to execute an Online Game. The filename is the complete path and filename of the file to execute. If no path is given, then the BBS will look in the MODULES folder for the file. The Return field is used for the type of data file to write. This can be TURBO, FOREM, TRANS, OTHER or STAR. The Special field is used to pass on parameters to the program. Usually something like LOCAL to tell the program that the user is a LOCAL logon (sysop). You can also use a number (1,2,etc) in the filename field. This will tell the BBS to look in the DATA folder for the ONLINExx.DAT file. 'xx' represents the number you placed in the filename field. This is the preferred method of setting up an Online Game and will be discussed in more depth later. Exit This option is placed in the Type field and is used to exit a menu. This must be here in order for a user to be able to exit the menu. Exitall This option is also placed in the Type field and is used to exit the menu but, it will exit all the way back to the Main BBS Menu. This will give the user the choice to abort out of all the menus in one shot without having to select Exit on each menu they have gone into. This is mainly used on menus that are two or more levels deep. FILENAME This is where you place the complete path and/or filename of a program to execute, display, the name of a Command (Built in Procedure) or, the number of the ONLINEx.DAT file to look for in the DATA folder. RETURN This is where you tell the BBS to tell the user to Press Return after the selection they make is completed. For instance, if they choose an option that will display a text file, the BBS will prompt the user to Press Return before coming back to the menu and re-displaying the menu. By placing a Y in this field (or leaving it blank) will tell the BBS to prompt the user. If a N is placed here, the BBS will not prompt the user to press Return. This field can also be used for other things as mentioned above. - 64 - SPECIAL The Special field is used to enter in the parameter that you want passed onto a program. This is similar to passing parameters to a TTP file but, a lot of other types of files also accept parameters. Usually, the programs will tell you what parameters it wants or expects. Some Examples Below is some examples of a menu. MENU <---| Selections [Press return to exit]: | 5 | A t C:\BBS\TEXT\LOVE.TXT | Used by the BBS B t C:\BBS\TEXT\MONEY.TXT | C t C:\BBS\TEXT\CARS.TXT | D t C:\BBS\TEXT\BBS.TXT | DEFAULT EXIT <---- {1}Example Data Base <---| | [A] Meet the women of your dreams | Displayed to [B] How to make $1,000,000.00 in just 2 weeks | the user. [C] Best buys on cars in 1992 | [D] National BBS Listing (Updated 1/20/1990) <---| That is all there is to it. The user sees the part marked as Displayed to the User and the Selection Prompt (line 2). If they choose A, B, C or D, then the proper file will be displayed. If they press any other key (even Return), then the BBS will exit that menu. You will also notice that the RETURN field was not used. Not placing an N there, the BBS will default to displaying the Press Return prompt. MENU NOABORT LEVEL_50 What's it gonna be (Q=Exit)? 4 1 c C:\BBS\SPITSCRN.PRG N 2 c D:\BBS\CHITCHAT.PRG N 3 p CALLSYS N Q exit {1}Chat modes: [1] Split Screen Chat (Vt52) [2] Split Screen Chat (Vt100/ANSI) [3] Normal Chat [Q] Exit Menu In the above example, you will notice some more options on the Options line. This is how they are spaced out. The line translates to 'This is a Menu file and do NOT allow the user to abort the displaying of the menu and they must have a Menu Level of 50 or higher in order to use it". - 65 - The return field was used to tell the BBS not to display the Press Return prompt after the processing of the selection. The first 2 lines of the selections told the BBS to execute external programs and the third line told the BBS to use the Built in Procedure (Command) called CALLSYS. The Menu also has the Exit command in a selection and they have to select Q in order to exit the Menu. Any other key in this instance will just re-display the Menu. Other Information You will notice in each example a '{1}' in there. This is the variable tag that tells the BBS to clear the screen. Variable tags can be used anywhere in the menu (or a text file) except in the Key, Type, Filename and Return fields. Everywhere else is free game. You can even use them as parameters to a program. The BBS will detect a variable tag and replace it with the appropriate variable data. More on this later. Placing the {1} variable tag on a line with the text (as shown above) will cause the BBS to clear the screen and place the text beside it on the first line. Placing the {1} variable tag on the a line by itself will cause the BBS to clear the screen and leave the first line blank. In the section that is displayed to the user, you can put any kind of character in the area. This would include something like the ESC character in order to use VT52, ANSI and other types of graphics. Anything that you want can be placed in this section. You can also do this with the Selection Prompt (line 2 of the Menu file). DO NOT use these ESC codes or whatever in the section used by the BBS except as noted above. It may be a good idea to name your Menu files with the extension of .MNU in order to easily pick out a Menu file from a plain .TXT (text) File. The extension of MNU is not required, just a suggestion. - 66 - ONLINE GAMES Ok, using what you have learned above, I will try and show you the preferred method of setting up an Online Game. You may want to refer to the description of the ONLINExx.DAT file listed below in the DATA FILES section. here is an example. MENU Selection: 5 1 t J:\SEE\TODAY.TXT 2 t J:\SEE\YDAY.TXT 3 t J:\SEE\SCORES.TXT 4 o 1 5 Exit {1}Space Empire Elite ================== [1] Todays News [2] Yesterday's News [3] Player's Scores [4] Play Space Empire Elite [5] Exit In the above example, you will notice the '5 o 1' line. The '5' is what the user selects to cause the BBS to process this selection. The 'o 1' tells the BBS to look for the ONLINE1.DAT file in the DATA folder. Again, refer to the description of the ONLINExx.DAT file in the DATA FILES section. I have a separate file that is seen first by the user that gives a list of the available games. When they choose an Online game from that selection, it will bring up another Menu like the one above. I have the above file named 'SEE.MNU' and when the user selects that games, the BBS will execute they SEE.MNU Menu which will in turn give the user the above options. That is all there is to setting up Menus and Online Games. I hope I have explained it clearly enough. - 67 - DATA FILES The DATA files are files that are stored in the DATA folder. These can be files that you setup to make the BBS do certain things or files that the BBS itself uses. The ones that the BBS itself uses are not editable by the Sysop. A '(*)' beside the name of the file means that the file is a System file and is not editable by the Sysop. ALTDRV.DAT (*) This is where the BBS stores the information for Alternate Drives for the File Areas. Alternate Drives can be defined in the File Area setup screen in the System Editor. ARCHIVE.DAT This is where you tell the BBS where to find the various archivers such as ARC.TTP, LHARC.TTP, etc. This is used for various functions that use these programs. Each line in this file must contain the drive, path and filename of the program. Each line must be kept in order. do not include the comments if you use this example to create the file. Nothing else can be on the line with the program name. if you do not have the file or do not plan on supporting this archive type, then leave the line blank. There must be the correct number of lines in this file which is 7. Example: H:\ARC\ARC.TTP ; ARC program location and name. H:\ARC\LZH201L.TTP ; LZH " " H:\ARC\ST_ZIP21\STZIP.PRG ; ZIP " " H:\ARC\ZOO_201G\ZOO.TTP ; ZOO " " H:\ARC\ARJ\UNARJ.TTP ; ARJ " " H:\ARC\UNSIT\UNSIT.TTP ; SIT " " ; BLANK LINE BACKUP.DAT This file is where you enter the filenames of the files you want backed up. This is done by the Cleanup program. This option is turned on in the Cleanup section of the System Editor. Each file must be on a separate line. The files are placed in the BACKUP folder. Example: BANNER.DAT (*) This file is where the Banner program stores it's information. The Banner program allows you or users to enter in one liners that can be displayed wherever you place the variable tag for it in the PROMPT.DAT file or text files. Although this is is a file that a program stores it's information in, it is just a simple text file and you can add or remove items. - 68 - BBS_S.DAT (*) This file is where the BBS stores the information for the Other BBSes. This is a System File. It goes along with the OTHERBBS command. BCPU.DAT This is where you enter the names of the computer types you want to Black List. When someone enters the Computer Type, the BBS will check this file and if it finds a match, it will not allow the person onto the system. Example: IBM AMIGA MAC BNAMES.DAT This is where you put the names of the people you want to Black List. When a person enters their name, the BBS will check this file and if it finds their name, it will not allow them onto the system. Example: John Doe Mary Jane BPHONE.DAT This is where you put the names of the phone numbers you want to Black List. When a person enters their phone number, the BBS will check this file and if it finds the number, it will not allow the person onto the system. Example: (803) 879-8878 0292 34672 CALLERS.INF (*) This is where the BBS places the callers info for the Who's Called function. It will store the number of callers based on the 'Keep Last xx Callers' setting in the System Editor. COMMAND.DAT (*) This is where the BBS stores the Command Tables that you set up in the System Editor. - 69 - COMPUTER.DAT This is where you place the name of the Computer choices a user has to choose from when the upload a file or the file is edited. If you have 'Ask Computer Type' turned on for that File Area, then the BBS will look for this file and display it to the user when it wants to know what Computer Type the program is for. This is setup on the File Area setup screen in the System Editor. If the file does not exist, then the user will be able to enter in anything. If you have the option turned off, then the BBS will not ask for it and will just bypass the question. This is good if you have an Atari areas and want to be able to distinguish between Atari 8-Bit, Atari ST, etc. A maximum of 20 Computer Types may be entered. Each type must be on a separate line and the file must have a blank line at the bottom. This is a global type file in that it will be for ALL File Areas if the COMP_xxx.DAT file is not found. This also helps keep the data that is entered consistent. Example: Atari ST Atari TT Atari 8-Bit COMP_xxx.DAT This works the same as the COMPUTER.DAT file above except, you can have a separate file for each File Area. xxx represents the File Area number. DEF_TAGS.DAT This file holds Sysop definable Variable Tags. This allows you to define your own variable tags to be used in text files, etc. You can have up to 100 tags defined. Each tag must be on it's own line. Please refer to the Variable Tags section for numbers to use for these tags. DOWNLOAD.LOG This file holds the information for downloads that have occurred. It will tell you the name of the user that downloaded a file, the file that was downloaded and the transfer protocol that was used. It will also show the CPS rating if the user did not use Zmodem. If they did, then the CPS rating will be 0. You can do whatever you want with this file. The program will create a new one if it isn't found. EDONE.DAT (*) This is where the BBS stores the information for what Events have been executed. - 70 - EMULATE.DAT This is where you setup the types of Emulations you support. By Emulation, I refer to VT52, ANSI, etc. Each selection must match your TERMINAL.TXT file. If VT52 Color is on line 1, then choice #1 in TERMINAL.TXT must also indicate VT52 Color. Please refer to TERMINAL.TXT for information on that file. Example: ASCII VT52 Color VT52 Mono ANSI Color EVENTS.DAT (*) This is where the BBS keeps the Event data. This is created by the System Editor when you setup your events. FTYPE.DAT This is where you place the information for File Type. File Type was designed to tell the user if the File is an LZH (LH5), LZH (LH1), GIF, ARC with folders, LZH with folders, etc. It can however be used for whatever you want to use it for. Each Type must be on a separate line and a blank line must be at the bottom of the file. You can enter up to 20 File Types. This is used when the user uploads a file and enters the description for that file. The BBS will ask the user to choose from one of the items in the list if you have this option turned on in the File Area setup in the System Editor. If this file does not exist, the BBS will allow the user to enter in any information they want. If the option is turned off, the BBS will not ask for this information. Example: ARC 5.xx ARC 6.xx ARC with Folders LZH (LH1) LZH (LH5) LZH with Folders Text Other FTYP_xxx.DAT This file works the same as the FTYPE.DAT file above except, it allows you to have a different file for each File Area. xxx represents the File Area number. - 71 - LOGOFF.BAT This is where you place the name of any program you want ran after a user logs off the system. The name of the file must include the drive, path and name of the file. If you want to pass a parameter to the program, just enter it after the name of the file, separated by a space. If you do not want this program to run after a local logon (you logon from the keyboard via the WaitCall screen), then you can place the word NOLOCAL after the filename or any parameter you may have. Each file you want executed must be placed on a separate line and a blank line at the end of the file. Example: J:\CALLTRAK\CALLINFO.PRG something NOLOCAL LOGON.BAT This is where you place the name of any program you want ran when someone logs onto the system. The name of the file must include the drive, path and name of the file. These file will be ran as soon as the BBS gets a CONNECT message from the modem. If you want to pass a parameter to the program, just enter it after the name of the file, separated by a space. If you do not want this program to run when you logon locally (from the keyboard via the WaitCall screen), then you can place the word NOLOCAL after the filename or any parameter you may have. Each file you want executed must be placed on a separate line and a blank line at the end of the file. Example: J:\CALLTRAK\CALLINFO.PRG something NOLOCAL LOGON1.BAT This works much the same way as the LOGON.BAT file except, it will only run AFTER the user has entered their name and password. MACROS.DAT (*) This is where the BBS holds the Macro information for the user. It is created by the System Editor when you setup the Macro file. MASKS.DAT (*) This is where the BBS holds the Mask information. The file is created by the System Editor when you setup the Mask file. It will store the information you setup in the Mask Editor portion of the User Editor. - 72 - MODEM.DAT This is where you put the information about what commands your modem uses for the various functions. In the example below is the commands the BBS will use if no MODEM.DAT file is found. The line numbers (1., 2., etc.) are only included as a reference and do not actually belong in the text file. Example: 1. ATZ S0=1 2. DTR 3. ATH1 M0 4. ATS0=0 5. 5 6. ATA 7. RING 8. 1 9. Line 1: This is the RESET/ANSWER command that you want used. This is the command that the BBS will use to set the modem up to Auto-Answer. If you have S0=1 (turn Auto-Answer on) saved in the modem's memory, then you will not need the S0=1 after the ATZ command. Some modems will not recognize anything after the ATZ command. If your modem can store 2 or more setups, then you can use one for the BBS and one for your use. I have line 1 setup as ATZ1 since I have all the settings setup that are necessary for proper use for the BBS. I then use ATZ0 on line 4. Line 2: This is the command you want used so that the BBS will tell the modem to HANGUP the phone. DTR just tells the BBS to toggle DTR off which if your modem is setup properly, will cause the modem to drop carrier (or hangup). Something like ATH0 can also be used. Line 3: This is the command you want used so that the BBS will tell the modem to take the phone OFFHOOK (answer the phone). This is used for when you logon locally, etc. where the BBS will have the modem to take the phone offhook so that nobody can call in and connect while you are doing something, etc. This line will also be used if you answer YES to the 'Take Phone Off the Hook' question when you go to eXit the BBS (item X on the WaitCall screen). If you answer Yes to this question, the BBS will not use Line 4. Line 4: This is the command you want used so that the BBS will tell the modem to take the phone OFFLINE. Normally this is S0=0 (turn Auto-Answer off). If your modem can store 2 or more setups, then you could setup one of those to do this and use a command like ATZ0. This is what I use since my modem can have 2 setups. This is used if you answer NO to the 'Take Phone Off the Hook' question when you go to eXit the BBS (item X on the WaitCall screen). It is also used when you use the DOS command from the Dos Shell (Sysop mode) which will Quit the BBS and take you back to the Desktop. - 73 - Line 5: This is where you tell the BBS how long to wait after a CONNECT message is received before it is to start sending out data. This was created due to high speed modems. When a high Speed modem calls a normal 1200, 2400, etc. baud modem that does not use MNP/Data Compression, the normal modem will start sending out data as soon as it receives the CONNECT message while the High Speed modem is still trying to negotiate other information. The result is that the user will not receive the first part of the information sent out by the BBS and the BBS will get garbage from the High Speed modem. This basically puts the BBS to sleep for this number of seconds. The Next 3 lines are only used if you have the BBS Answers Phone option turned ON on Settings Page 5 in the System Editor. Line 6: This is the command you want the BBS to send to the modem to answer the phone when it detects a RING or whatever is in line 7. Line 7: The is what the modem should look for when the phone rings. Normally it is set to RING. Line 8: This is the number of rings the BBS is to wait for before answering the phone. Line 9. This is a blank line. MONITOR.DAT This is where you place the information for the Monitor Type. This file was designed to tell the user what type of Monitor is required for this program to run on. It can however be used for whatever you want to use it for. Each entry must be on a separate line and a blank line must be at the bottom of the file. You can enter up to 20 Monitors listed. This is used when the user uploads a file and enters the description for that file. The BBS will ask the user to choose from one of the items in the list if you have this option turned on in the File Area setup in the System Editor. If this file does not exist, the BBS will allow the user to enter in any information they want. If the option is turned off, the BBS will not ask for this information. Example: ST Color ST Monochrome ST Color/Mono ST/TT Color ST/TT Mono ST/TT Color/Mono - 74 - MONI_xxx.DAT This file works the same as the MONITOR.DAT file except, you can have one for each File Area. xxx represents the File Area number. NAMESxxx.DAT This is where you place the names that can be used with the 'Allow Any Name' option in the Message Base setup of the System Editor. If this option is ON, then the user has the choice of choosing a name they wish to save the message as. You provide the names in this list and the Level of the user that is required to use this name. There must be a blank line at the end of this file. You place the Name on one line and the level on the second line. You can have up to 10 names. xxx represents the Message Base number you want this list of names to be used in. Example: Joe Blow 10 Mary Jane 10 John Doe 2 NO_COM.INF This is where you tell the Cleanup what files with the listed extensions to not try and compress when it does the Auto-Compress function. This option is turned On or Off in the File Area setup screen in the System Editor. It is also turned On or Off with the Auto-Compress file Areas in the Cleanup section in the System Editor. The option in the File Area section only affects that File Area. The option in the Cleanup section affects ALL File Areas. Example: ARC LZH ZIP ARJ GIF - 75 - ONLINExx.DAT This is where you enter in the information about an Online Game. It has a special layout that you must follow for it to operate properly. The example will be an extension of the example I used for online games in the Menu Processor section. All parameters must be separated by a space. You can have up to 99 ONLINExx.DAT files and up to 25 sets of information in each ONLINExx.DAT file. You must not leave any blank lines between the sets of information. You can of course only have 1 set of information per ONLINExx.DAT file. This would allow you to group all the Space games together, all the Adventure games together, etc. The BBS will list each game out by it's name (Line 1). The ONLINExx.DAT files can also be used for other things besides games like the Fido network for example. Anything that uses the FOREM.DAT, TURBO.DAT, DORINFO1.DEF, etc. Example: Space Empire Elite <--- Start of the first set of information 2 NO J:\SEE_1021\SEE_1021.TTP LOCAL J:\SEE_1021\SEE_1021.TTP FOREM Overlord <--- Start of another set of information 2 J:\OVERLORD\OVERLORD.TTP LOCAL J:\OVERLORD\OVERLORD.TTP FOREM Line 1: This is the Name of the Online Game. It is not normally used unless you have more than 1 set of information in the ONLINExx.DAT file. This will also help you remember what this file goes with. Line 2: This is the level that is required by the user in order to play the game. This is based on the user's Online Game Level (OGL) that is defined in the User Editor under the Security Levels for that user. You can also place the word NO on this line as shown above. This will tell the BBS to not count this as an Online Game being played. It will not add the count to the user's information. - 76 - Line 3: This is the name of any file that you would want displayed BEFORE the game is executed. The name of the file would include all drive and path information also. Line 4: This is the name of any file you would want displayed AFTER the user exits the game and returns to the BBS. The name of the file would include all drive and path information also. Line 5: This is the name of the file to execute if the user is on Locally. This is normally the Sysop at the keyboard. Some programs require the LOCAL parameter (as seen above) to let it know that the user is on locally. Some (I have seen one) use a separate program for local playing. The name of the program would include the drive and path information also. Line 6: This is the name of the file to execute if the user is calling in (remote user). Line 7: This is the type of DAT file you want written to the Online games directory before the BBS executes the program. The following is a list of the available options. FOREM - Write a FOREM.DAT and a DORINFO1.DEF file to the program's directory. TURBO - Write a TURBO.DAT and a DORINFO1.DEF file to the program's directory. TRANS - Writes a TRANUSER.INF file to the program's directory. This is our own data file. The layout of this file is located in the Appendices. DOORINFO - Writes a DORINFO1.DEF file to the program's directory. STAR - Writes a USER.TMP file to the program's directory. This is a STARNET BBS compatible USER.TMP file for games written for that BBS program. OTHER - Writes the user's Handle to a file called USER.INF to the program's directory. If none of the above choices are given, then the BBS will default to writing a TRANUSER.INF file to the program's directory. PROTOCOL.DAT (*) This is where the BBS gets it's information on the different Protocols, their key required to select it and the filename to execute for this Protocol. This file is created by the System Editor when you setup the Protocols. - 77 - QUESTION.DAT This is where you tell the BBS what user questions to ask the user when they apply for an account. Each line represents a question that the BBS normally would ask a new user or will ask the user if this file is not found. The text beside each YES is just for reference. If you do not want this question asked, then replace YES with NO. do NOT alter the size of this file. There must be the correct number of entries in this file. Example: YES Ask if they want an permanent account at logon? YES Ask Video Height? YES Ask Video Width? YES Ask Users Name (You can't turn this off) YES Ask Users Handle? YES Address? YES City? YES Zip Code? YES Phone Number? YES Computer type? YES State? YES Country? YES Password (You can't turn this off) YES Users Age YES Users Sex YES Ask Second (Data) Phone Number? SYSOP.LOG This is where the BBS stores the information you tell it to. You can save a message, etc. to this file for future reference. Anytime you see an option of [L]og (in Email, etc.), then when you choose this option, the BBS will ask you where to save it to. The Sysop's log is one of those choice. You can do whatever you want with this file. If it is not found, the BBS will create it. TRANS.DAT (*) This is where the BBS gets 90% of it's setup information. This file is created by the System Editor when you do a Save TRANS.DAT. It must reside in the same directory as TRANSBBS.PRG. - 78 - TYPE.DAT This is where you place the information for Program Type. Program Type was designed to tell the user what type of program the file was such as a Game, Application, BBS, Telecom, etc. You can however use it for whatever you want to use it for. Each entry must be on a separate line and a blank line must be at the bottom of the file. You can enter up to 20 Program Types. This is used when the user uploads a file and enters the description for that file. The BBS will ask the user to choose from one of the items in the list if you have this option turned on in the File Area setup in the System Editor. If this file does not exist, the BBS will allow the user to enter in any information they want. If the option is turned off, the BBS will not ask for this information. TYPE_xxx.DAT This file is like the TYPE.DAT file above except, you can have a different one for each File Area. xxx represents the File Area number. UPLOAD.LOG This is where the BBS places information about uploads. It will tell you who the uploader was, what file was uploaded, what File Area it was uploaded to and the protocol used. You can do whatever you want with this file. If the file is not found, the BBS will create it. USERS.DAT (*) This is where all the user's information is stored. It is initially created by the System Editor but is updated by the BBS. USERS.IDX This is an Index file that goes along with the USERS.DAT file. USERS.TXT This is where you enter in information for the Print User program. Please refer to that section for instructions on setting up this file. - 79 - WAITCALL.DAT This is where you can place program names that you want to be able to be ran from the WaitCall screen. The BBS will fill the empty slots (letters not used) with this programs name. You can then execute the program by simply pressing the corresponding letter. There must be a blank line between each entry. If you wish to have any parameters passed onto the program, then you must place them beside the filename with a space between the filename and the parameter. Example: Flash C:\FLASH\FLASH.PRG Gem System Editor J:\SYSEDITG.PRG Arc Shell H:\ARC\ARCSHL31.PRG Isis Mail J:\INTERBBS\ISISMAIL.PRG something WELCOME.BAT This is where you place the name of any program you want ran when someone logs onto the system. The name of the file must include the drive, path and name of the file. These file will be ran as just before the WELCOME.TXT file is displayed. If you want to pass a parameter to the program, just enter it after the name of the file, separated by a space. If you do not want this program to run when you logon locally (from the keyboard via the WaitCall screen), then you can place the word NOLOCAL after the filename or any parameter you may have. Each file you want executed must be placed on a separate line and a blank line at the end of the file. Example: J:\CALLTRAK\CALLINFO.PRG something NOLOCAL - 80 - TEXT FILES Text Files are files which the BBS uses to display information to the user. These are plain ASCII files that can be edited by the Sysop. These files allow you to customize your BBS so that the BBS can take on the look that YOU want. These files are located in your TEXT folder and in one of the MENUSx folders. The MENUSx folders represent the different types of emulations you have. 'x' represents the number that the user chooses for the type of emulation he wants. For instance, you want all ASCII text files in MENUS0, VT52 files in MENUS1, ANSI files in MENUS2, etc. When the user chooses what type of emulation he wants from the TERMINAL text file, the BBS will switch to that MENUSx folder to locate and read in the appropriate text file. If the file is not found, the BBS in most cases will switch to MENUS0 (default) to try and find that file. If found, it will display it. This allows you to only change the files you want to display in the emulation and the rest will be taken from the MENUS0 folder. In order to make these files display in different emulation styles, you will have to edit them and place the proper codes into the file. With this method, you can have just about any type of output you want. All Text Files are editable by the Sysop. Special formatting may be required and will be noted in the description of that file. Although these text files were designed to be used for specific purposes, you can use them for anything you desire. You can change them to look the way you want, make MENUS out of them, or whatever you want. Some of these text files are tied to the Built in Procedure Commands. This means that when a user chooses the command from one of the menus using the key you defined, then this text file will be displayed. The Built in Procedures that these files are tied to will be given in the description such as 'COMMAND: PARMEDIT'. This would mean that that text file was tied to the Built in Procedure PARMEDIT which is used int he Command Tables in the System Editor. Some of the text files will have one or more x's in it's name. This usually deals with a File Area number, Message Base number or a sequence of text files that will be displayed one after the other going from FILE.TXT to FILE1.TXT to FILE2.TXT, etc. until it runs out of those files. ALRDCHAT.TXT This file is displayed when the user has reached their Max. Pages per Call Limit. Example: {1} Enough already! I am either not here, in bed or I do not want to chat. Leave Feedback if it that important. - 81 - BASExxx.TXT This file is displayed anytime a user enters a Message Base. This is different from MTOPxxx.TXT in that it is displayed everytime a user enters the Message bases versus only when the user first enters the Message Base. Use it to tell the user what the topic of the Message Base is or whatever. Example: BASE1.TXT This Message Base is for General Chit Chat. If there is a specific Message Base for a topic, then please use that Message base. BBSADD.TXT This file is displayed when a user goes to add a BBS to the Other BBS Listing. Use it to place instructions to the user or whatever. BBSLIST.TXT This file is displayed when a user does a listing of the available BBS in the Other BBS listing. It is used to display the available options to the user. Example: BBS List ======== [A]dd to the List [V]iew the List [E]dit BBS List [Q]uit to main menu If this file is not found, the BBS will display a built in menu. The big difference is that the BBS will check to see if the user has the appropriate access level (255) and if not, it will not display the '[E]dit BBS List' menu option. BBSVIEW.TXT This file is displayed when the user chooses to get a Listing of the BBS's in the Other BBS section. It is used to display a list of the available options that the user can choose from. If this file is not found, the BBS will use a built in Menu of the options available. Example: Search Methods: [1] - Name [2] - Phone Number [3] - Comments [4] - Software [5] - All Select: - 82 - BDAY.TXT This file will be displayed when the BBS detects that it is the user's birthday. Example: Happy Birthday to you. Happy Birthday to you. Happy Birthday Dear {3}. Happy Birthday to you. CALLSYS.TXT COMMAND: CALLSYS This file is displayed when a user Pages the Sysop. Example: O Sysop, impart on me some of your wisdom. Let's chat sucker... CALLS.TXT COMMAND: VIEWCALL This file is used to define the way the output for the Who's Called Listing is displayed to the user. This file uses variable tags 137 - 142. It is used in conjunction with Prompt number 223 in the PROMPT.DAT file. The prompt is shown first and then the BBS will step through the list of the Last x number of Callers using this layout. 'x' represents the number of callers you tell the BBS to keep track of. This is set in the System Editor in the Settings section. If this file is not found, the BBS will default to a built in output. The actual information is stored in the CALLERS.INF file located in the DATA folder. Example: {137p8} {138p30} {139p8} {140p5} {141p8} {142p8} blank line goes here The output would look something like... Caller# Handle Date Baud On Time Off Time ------- ----------------------------- -------- ----- -------- -------- 189 Wayne Watson 01/14/93 14400 04:30 pm 04:50 pm 188 John Johnson 01/14/93 2400 02:30 pm 03:30 pm etc. The header at the top of this listing is prompt # 223 in the PROMPT.DAT file located in the TEXT\MENUSx folder(s). - 83 - CARRIER.TXT This file is one of the very first files to be displayed when a user logs on. It is displayed as soon as the BBS gets the CONNECT message. It can be used for anything you wish. It is also displayed during a local logon. CAT.TXT This file is used to control how the output for a Catalog Listing is displayed to a user. If this file is not found, the BBS default to a built in output format. It is used in conjunction with Prompt number 36 and 53 in the PROMPT.DAT file. There are two lines you must define in this file. Line one is used for the normal Catalog Listing and Line two is used for the Continuous Catalog Listing. This line will be shown when the user has Continuous Scroll turned on in the File Areas. This file uses tag numbers 303, 304, 308, 322, 334 and 335. You can add VT52, ANSI, etc. control codes to make the output look differently. Example: [{335}] {322p5} {303p12} {304p7} {308} {334} {322p5} {303p12} {304p7} {308} {334} The output for a regular Catalog Listing would look something like... Key File# Filename Bytes Date Brief Description --- ----- ------------ ------- -------- ----------------------------- [A] 12345 ARC.TTP 134980 01/14/93 Latest version of ARC. [B] 12346 LHARC.TTP 12390 01/14/93 Latest version of LHARC. etc. The output for a Catalog Listing with Continuous Scroll on would look something like... File# Filename Bytes Date Brief Description ----- ------------ ------- -------- --------------------------------- 12345 ARC.TTP 134980 01/14/93 Latest version of ARC. 12346 LHARC.TTP 12390 01/14/93 Latest version of LHARC. etc. The header for the first listing is prompt # 53. The header for the second listing is prompt # 36 in the PROMPT.DAT file in the TEXT\MENUSx folder(s). CAT_xxx.TXT This file is basically the same as CAT.TXT. The only difference is that by using the File Area number (xxx), you can have a different CAT.TXT file for each area. The BBS will search for this file first, if it is not found, it will then search for CAT.TXT and if it is not found, it will use the built in displaying of the files. Number range from 1 to 256. - 84 - CLEARSCR.DAT This file allows you to define what keycode sequence that will clear the screen for that emulation. If you had VT52 in MENUS1, then you would have something like 'ESC E' for VT52 screen clearing. You could also have this file in other MENUSx folders for different emulations that use a different clear screen code. Example: TEXT\MENUS1\CLEARSCR.DAT {ESC}E The above example assumes you have VT52 text files in MENUS1. The {ESC} is the escape character. This would clear the screen for most ST systems calling in since the ST has VT52 built in. You can have a CLEARSCR.DAT file for each type of emulation and place it in the appropriate MENUSx folders. CONNECT.TXT This file is displayed upon connection. Example: NOABORT {1} Welcome to {41} 300/1200/2400 Baud Sysop: {39} You are caller number: {30} CONNECTxx.TXT This file is basically the same as the CONNECT.TXT file except it is the next file to be displayed in sequence after the CONNECT.TXT file. You can have up to 99 CONNECTxx.TXT files. - 85 - DOSMENU.TXT This file is displayed when you enter a '?' at the Sysop Dos Shell. It will give you a detailed description of the available commands. Example: Syntax Description ==================================================================== ?, HELP This Menu UEDITOR User Editor RESERVE user Reserve BBS CHAT, C Chat Mode CHAT on/off/normal Set Chat Status CHAT STATUS View Chat Status EXEC [EX] filename Execute File BATCH filename Execute Batch File(s) GEM ON Gem Mode TIME current time View/Change Time DATE current date View/Change Date TERM Terminal Mode SEND filename Send File RECEIVE filename Receive File(s) BSEND, SENDB Send Batch Marked Files MARK filename/filelist Batch Mark File(s) VIEWMARK View Marked Files UNMARK Unmark File CLEARMARK Clear Batch List TYPE filename Display Text File TEST filename Display Text/Menu_File CHKDSK drive Disk information MKDIR [MD] foldername Make Folder RMDIR [RD] foldername Delete Folder RENAME [RN] filename1 filename2 Rename File EDIT [ED] filename Text Editor DELETE [DE], KILL, ERASE filename/list Delete File(s) COPY [CO] filename1/list1 filename2/list2 Copy File(s) MOVE [MO] filename1/list1 filename2/list2 Move File(s) VERBOSE filename View Archive TOUCH filename Update File Date & Time DIR path Directory CD, CHDIR, CWD Change Drive/Path HANG UP Hang Up User STATUS BBS Status RERUN Re-Load Transcendence Q, EXIT Exit DOS mode DOS Exit To GEM - 86 - DOWNLOAD.TXT COMMAND: DOWNLOAD This file is displayed when a user chooses the Download or Mark File option from the main File Menu. It just briefly tells the user how to use the Download/Mark File feature. Example: To download a file, just type in the name or number at the '>' prompt. Separate the name/number by a ',' to download more than one file. Press to obtain another line to enter more names/numbers or, to end entry, press at the '>' prompt. EDITUSET.TXT COMMAND: SETTINGS This file is displayed when a user uses the SETTINGS command. It displays the user's current settings. Example: {1}User Settings: []==========[] [0] Default terminal type: {101p12} [1] Default window size: {102} [A] Auto read email : {103p12} [B] End of page pause : {104} [C] Hotkey commands : {105p12} [D] Command stack prnt : {106} [E] Clear screen : {107p12} [F] Default compression: {108} [G] Continuous scroll msg: {109p12} [H] Pause between msgs : {110} [I] File area prompts : {111p12} [J] Msg base prompts : {112} [K] Word wrap in editor : {113p12} [L] Line numbers in edt: {114} [M] Scan/mark messages : {115p12} [N] Editor summary : {116} [O] Auto scan messages : {117p12} [P] Auto scan new files: {118} [Q] Emacs text editing : {119p12} [R] New files scan list: {120} [S] Default protocol : {318p12} [T] Key aborts text : {121} [U] Terminal width/height: {14}x{15} [Return] Finished [?] Show Again EMAIL.TXT COMMAND: EMAIL This file is displayed when a user uses the EMAIL command. It is used to display the commands available to the user. Example: {1} Southern Software BBS E-mail System ----------------------------------- [F] F-Mail Send [R] Read E-Mail/F-Mail [S] Send E-Mail/F-Mail [Q] Exit E-/F-Mail System - 87 - EMAILFUL.TXT This file is displayed when there are no more Email slots available and a user tries to leave Email or Feedback to someone. Example: Sorry, the Email system is full right now. The Sysop has been informed, and will correct this problem ASAP. Please try again later. EMAILHLP.TXT This file is displayed when a user enters a '?' at the 'Send Mail To:' prompt. Example: Enter the users handle to send mail to. If you are not sure of the spelling, enter part of it. The BBS will then search for any user who has what you type, in their handle. For Example: To Who (?=Help): David Br The BBS will return: Partial match found "David Brown" is this correct? Press [Return] to abort Email send EMAILSND.TXT This file is displayed when the user chooses the Send Email option in the Email section. It can be used to give instructions on using Email, etc. Example: Enter the users handle to send mail to. If you are not sure of the spelling, enter part of it. The BBS will then search for any user who has what you type, in their handle. For Example: To Who (?=Help): David Br The BBS will return: Partial match found "David Brown" is this correct? Press [Return] to abort Email send or ? for Help. ENTSYSOP.TXT This file is displayed when the Sysop goes into the Sysop Mode (Dos Shell) and chooses not to allow the user to see what is happening. Example: Please Standby. Sysop using System. - 88 - EXITCHAT.TXT This file is displayed when the Sysop quits out of Chat with a user. This is only used when the Built in Chat mode is used (CALLSYS). Example: Now leaving, The Sysop Zone... FAREAS.TXT This file is displayed when a user uses a command that causes the BBS to display a list of the available File Areas. If this file is not found, the BBS will generate a list of available File Areas. This built in list will only display the File Areas available to the user. If they do not have access to a File Area, the BBS will not show it to the user and the File Area numbers will be in numerical order. They will not even realize they are missing anything. The FAREAS.TXT file does not have this ability but, it allows you to set up the display of the available File Areas the way you want. Example: {1} Southern Software Files Areas ----------------------------- [1] General Files [4] ST Telecommunications [2] ST Utilities [5] Spectre/Mac [3] ST Applications [N]ew Files FHDRxxx.DAT This file allows the Sysop to define the way the header, for the Long description of a file, is displayed. The header provides all the information about the file being displayed such as, Filename, Filesize, Uploader, Upload Date, Type of File, number of downloads, etc. This allows the Sysop to define what information is to be provided and how it is to be presented. Numbers range from 0 to 256. If a FHDR0.DAT file is present, it will be used as a header for ALL File Areas unless a FHDRxxx.DAT file is found. For instance, if you created a FHDR1.DAT file to be used for File Area 1, then this file header will override the FHDR0.DAT file. Example: Filename : {303p12} (#{322p5}) {317p4}Status : {312} Uploaded : {308p8} at {307p8} {317p5}Uploader : {306} File Type : {305p25} Level : {311} File Size : {304p7} {317p18}Downloads : {310} time(s) Last Downloaded: {309p8} {317p17}Xfer Time : {316} at {33} Baud Computer Type : {313p25} Monitor : {314} Blocks : {324} Xmodem, {325} Y/Zmodem, {326} Fmodem {315} - 89 - FILEMENU.TXT This file is displayed when a user chooses the Sysop defined key for Help in the File Area Command Table. This provides the user with a list of Commands that are available for the File Areas. You will need to enter the name of this text file in the FILENAME field in the File Area Command Tables with the key of your choice. Example: {1} {41} BBS File Menu [A] ARC D/L Utilities [R] Read a Text File [B] Batch Download Marked Files [S] Search for File Since Date [C] Catalog Files (No Description) [T] Toggle Continuous Scroll On/Off [D] Download A File [U] Upload A File [E] Edit File Scanning List [V] View Marked Files [F] Find A File [W] Search Contents of Files [G] Goodbye (Log Off) [X] Exit File Area [K] File Maintenance [Y] Wide Listing [L] List Files (With Description) [+] Next File SIG [M] Mark File for Batch D/L [-] Previous File Sig [N] List ALL New Files [=] Goto Another File Area [Q] Exit File Area [?] This Menu (Help!) FMAIL.TXT This file is displayed when the user chooses the Send Fmail option in the Email section. It can be used to give instructions on using Fmail, etc. Example: At the Fmail Filename prompt, enter in the name of the file as you want it called. You can enter part of the name at the To: prompt and the BBS will try and find a match for you. It will present you with a list of names that it found and you can choose if this is the user you are looking for. FTOPxxx.TXT This file is displayed anytime the user enters a File Area. xxx represents the File Area number. If for instance, a user enters File Area number 1, then the BBS will look for FTOP1.TXT and display it if found. This was designed to let the user know what files are to be uploaded in this File Area, etc. Numbers range from 1 to 256. Example: FTOP1.TXT This File Area is for General files that normally are not computer specific such as text files, etc. - 90 - GOCHAT.TXT This file is displayed when the Sysop enters the Chat Mode with a user. Example: Now Entering The Sysop Zone... GR_RESET.TXT This file is used to reset the users colors, etc. so that when a user aborts output of information using Control-C, it will not leave the BBS or the users screen in a mess. When Control-C is used, the BBS will then look for this file and send out the information contained in it. Place one of these files in each of the MENUSx folders so that the user's screen can be reset based on the emulation type they have chosen. HANGUP.TXT This file is displayed when the Sysop kicks a user off the system using the F10 function key. Example: {1} System Coming Down For Sysop Maintenance. Please Call Back Later! HELP.TXT This file is displayed when the HELP key is pressed on the keyboard. It was designed to display the available functions keys and what they do. Example: Function Keys Normal Alternate [F1] Sysop Mode/Dos Mode [F1] Restricted Access Toggle [F2] Chat Mode [F2] Chat with Capture [F3] User Editor [F3] Add 10 Min. [F4] File Maintenance [F4] Add 1 Min. [F5] Change Window Size [F5] Sub. 10 Min. [F6] Local Reserve [F6] Sub. 1 Min. [F7] Reset Vt52 [F7] Disk Capture Toggle [F8] Printer Toggle [F8] Window Hide/Show [F9] Snoop Toggle [F9] Alert Mode OFF [F10] Hangup & display HANGUP.TXT [F10] Hangup & display Garbage Shift [F1] Toggle Screen Saver On/Off [F2] Select Chat Mode Status Press Any Key To Continue... - 91 - LOCK_xxx.TXT This file will be displayed when a user logs on and they have been locked out. By using the [L]ock/Unlock command in the User Editor, you can lockout a user and assign them a number. This number will correspond to the xxx part of the filename. For instance, if you did not want people with Blonde hair to log on, you could lockout a user in the User Editor and assign that user the number 1. In LOCK_1.TXT, you could put something like, "You are not allowed on this BBS because you have Blonde Hair" or something like, "The BBS is currently down for Maintenance". Everytime they call, the BBS will down to them. You can have a number from 1 - 255. If you did not want to permanently BlackList a user and just wanted to antagonize the user, then this is the way to do it. LOGOFF.TXT This file will be displayed when a user logs off the BBS. This will be either using the GOODBYE option you defined or by typing the word OFF at any prompt. Example: Have a good day {2}! Thanks for calling Southern Software BBS Ya'll come back now, hear... C L I C K ! ! ! {98-3} LOGOFFxx.TXT This file is the same as the LOGOFF.TXT file but, it is just another file in the sequence. You can have up to 99 LOGOFF text files. LOGSTAT.TXT This file is part of the LOGON sequence and was designed to show the user the STATS at logon. Example: {1} Name : {3} User No. : {17} ----------------------------------------- Todays Date : {28} Current Time: {34} ----------------------------------------- Your Minutes On Today:........ {23} ----------------------------------------- Your Time Limit Per Day:...... {21} Min Your Time Limit Per Call:..... {22} Min Last Caller was {31} - 92 - LOGSTATxx.TXT This file is basically the same as the LOGSTAT.TXT file except it is the next in sequence after the LOGSTAT.TXT file. You can have up to 99 LOGSTATxx.TXT files. MAC_HELP.TXT This file is displayed when the user request help in the Macros Editor. It just gives some information on using the macros. Example: {1} Macro Keys ---------- With Transcendence you may define macro keys. The number of keys you may define, and their length is decided by your Sysop. A macro key simply replaces a long string of text with a couple keystrokes. A good example of using this is for users who like to put their name/handle at the end of each message, instead of typing it each time you can define a macro as your name, and call that macro each time. To define a macro, go into the macro editor from the main menu. Type the number of the macro you want to change. Simply type in whatever you want. To put a "Return" character in your macro, place "@C" in it. To put an "@" symbol, put two @'s in a row (ie. "@@"). You may use Escape codes in your macros also. To call up the macros, hit ^A (Control-A). Then press a number 1 to 0. 0 would be macro key #10. If you have more than 10 macro's to use, call number 11-20 by pressing A-P on your keyboard, 'A' would be macro #11, and 'P' would be macro #20. It takes a little getting used to, but it is a big time saver after you get used to it. {47} - 93 - MAINMENU.TXT This file is displayed when the user chooses the Help key (normally defined as a '?') from the Main Menu. It shows the user the available commands and the keypress required to activate that command. The actual key for the Help command is defined by the Sysop in the Command Tables in the System Editor. You can however, name this file anything you want. Just make sure you have the same name defined in the System Editor. If no path is given, then the BBS will look for the file in the TEXT\MENUSx folder. You must have this file defined as a Text/Menus/Script file. Example: {1} Southern Software's Main Menu ----------------------------- [A] Set Terminal Type [O] Other BBS's [B] New Files Scan [P] Edit Your Parameters [C] Call for Sysop [Q] QuickScan Messages [D] Library (Help Files) [R] Recreation Room [E] Email/Fmail System [S] Edit User Settings [F] File Areas [T] Send New Messages [G] Goodbye (Log Off) [U] User Listing [H] Handles of Users [W] Who's Called [J] Jump to a Message Base [Y] Your Statistics [L] Leave Feedback [Z] Macro Editor [M] Message Bases [=] Go to a Message Base [N] System News [?] This Menu (Help!) MAREAS.TXT This file is used to display the available Message Bases that the user can choose from. If this file is not found, the BBS will use a built in display that will display the available Message Bases. The difference between MAREAS.TXT and the built in display is that the built in display will not show a user a Message Base if the user does not have access to it. Also, with the MAREAS.TXT file, you can make the display look like you want. There is a trade off here. MARKBASE.TXT COMMAND: MARKBASE This file will be displayed when the MARKBASE option is used. It was designed as a header to be displayed before the BBS shows the user what Message Bases they can choose from to turn On or Off for their QuickScans, etc. Example: {1} Select Bases For Your QuickScan * * * * * * * * * * * * * * * * - 94 - MARKFILE.TXT COMMAND: MARKFILE This file will be displayed when the MARKFILE option is used. It was designed as a header to be displayed before the BBS shows the user what File Areas they can choose from to turn On or Off for their QuickScans, etc. Example: {1} Select File SIGs For Your QuickScan * * * * * * * * * * * * * * * * * * MEDITOR.TXT This file is displayed before a user starts editing a message. It was designed to give the user a list of the available options for the Message Editor. The user can turn off this help file in their Settings which uses the SETTINGS command. If they have Message Editor Summary turned OFF, the file will not be displayed. Example: {1} {41} Message Editor Commands Precede ALL commands with a '/' [A] Abort Message [Ixx] Insert xx Blank Lines [T] Goto Top [B] Goto Bottom [Lxx] List Next xx Lines [W] Word Wrap On/Off [C] Center Text [L] List Without Line #'s [Y] Change FROM [D] Delete ALL Lines [N] List With Line #'s [#] Line #'s On/Off [Dxx] Delete Next xx Lines [P] Preview Message [Gxx] Goto Line xx [S] Save Message [SP] Save Private [SF] Save with File [?] Help [Exx] Edit Line xx [R/xxx/yyy] Replace xxx with yyy - Must be in Edit Mode - 95 - MEDITOR2.TXT This file is displayed if the user request Help in the Message Editor. This file was designed to give more information on the available commands in the Message Editor. It is more of a Extended Help type of file. The user can request help by entering /? or /HELP. The /HELP is not case sensitive. Example: {1} Message Editor Commands xx = Line number you want. /A - Used to abort the message /B - Used to take you to the bottom of the message /C - Used to center the text on the current line number /D - Used to delete ALL lines in the message. Will ask if you are sure. /Dxx - Used to delete the next xx number of lines. /Exx - Used to edit xx line number. Puts you in Edit Mode. /Gxx - Used to go to line number xx. /Ixx - Used to Insert xx number of lines before the current line number. /L - Used to List the message. /Lxx - Used to List the next xx number of lines. /N - Used to list the lines in the message with line numbers. /P - Used to preview the message. Will show what it will look like. /R/xxx/yyy - Used to replace the word xxx with the word yyy. Must be in Edit mode. Use /Exx to put you in Edit Mode. /S - Used to save the message. /SF - Used to save the message with a file attached. /SP - Used to save the message as a private message. /T - Used to go to the Top of the message. /W - Used to toggle Word Wrap On/Off. /Y - Used to change the From field. Only if you are allowed to do so. /?, /H - This help file. /# - Used to turn line numbers On/Off. {47} MHDRxxx.DAT This file allows you to design your own Message Header. If this file is found, then the BBS will display it instead of the built in Message Header. The Message Header is the part that gives all the information about the message such as From, To, Status, etc. xxx represents the Message Base number. If a MHDR0.DAT file exist, then the BBS will use this file header for ALL Message Bases unless a FHDRxxx.DAT file exist. For instance, if a MHDR1.DAT file to be used for Message Base 1 exist, then it will be used instead of MHDR0.DAT. - 96 - MSGMENU.TXT This file is displayed when the user chooses the Help key (normally defined as a '?') from the Message Menu. It shows the user the available commands and the keypress required to activate that command. The actual key for the Help command is defined by the Sysop in the Command Tables in the System Editor. You can however name this file anything you want. Just make sure you have the same name in the Command Tables. If no path is defined and only the Filename is given, then the BBS will look in the TEXT\MENUSx folder for the file. You must have this file defined as a Text/Menus/Script file. Example: {1} {41} BBS Message Menu [B] Backward Read Messages [R] Read an Individual Message [C] Check Messages To/From You [S] Search Message for Keywords [E] Enter a Message [T] View Topic of Message Base [F] Forward Read Messages [U] User List [G] Goodbye (Log-off) [V] View Marked Messages [H] Set High Message Counter [X] Exit Message Area [I] Information on Message Base [+] Next Message Base [M] Mark Message Base for QuickScan [-] Previous Message Base [N] Read All New Messages [=] Goto A Message Base [P] Post A Message [?] This Menu (Help!) [Q] Exit Message Bases MTOPxxx.TXT This file is displayed when a user enters a Message Base for the first time or, anytime their High Msg Counter is at 0. It was designed to tell the user what the topic of the Message Base is. xxx represents the Message Base number. Example: {1}This is the General Message Base. It is the place to post messages not directly covered in the other bases. Also you will find information about the BBS in this base. NEWEMAIL.TXT This file is displayed when a new user logs on the the New User Email setting in the System Editor is ON. It just tells the user that they will now be asked to enter Email to the Sysop. Example: {1} At this point you need to leave a message to the Sysop. Please tell the Sysop a little about yourself, and why you would like access. {47} - 97 - NEWUSER.TXT This file is displayed when a user logs on as a New User. It was designed to tell the New User the rules of the System, etc. Example: TEXT NOABORT {1} New User Information -------------------- This BBS supports only the Atari ST brand of computers. If you do not use or own an Atari ST computer but would still like to join the BBS, do not request or expect support for other computers. My time and resources are limited. Since this is also a support board for Transcendence BBS program, I need the available space for support also. {38} There will be NO illegal actions used on this board. This includes, phreaking, uploading commercial software, etc. Any illegal activity WILL result in the termination of your user account and you will be Black Listed. If I find resonable causes, I may also turn your name over to someone that can do something about it. I enjoy using my computer too much to have it taken away from me. The E-mail WILL be scanned on a regular basis. By joining this BBS, you accept the fact that your E-Mail will be read by me. I retain that right, especially since it is MY computer. If you have a problem with this, then hangup NOW. {47} NT_x_y.TXT If you have a command that only runs certain times of the day or certain days of the week and the user selects this option, then the BBS will display this file. x represents the Key and y represents the Page. The Main Menu is Page 1, the File Area Menu is Page 2 and the Message base Menu is page 3. For instance, say you only had Online Games on from 10:00:00 - 18:00:00 and the 'O' key defined as the key to press to access the Online Games from the Main Menu, and a user tried to access the Online Games area outside of this time frame, then the BBS will look for the file NT_O_1.TXT. In this file, you could just tell the user that the Online Games are available from 10:00:00 - 18:00:00 (10am - 6pm). This also applies to the days of the week. Example: The Online Games are only available Saturday and Sunday. - 98 - OFF.TXT COMMAND: OFF This file is displayed when a user chooses this command. You will need to set up a Key in the Command Tables to make use of this Command or make use of it from a Menu File. This was designed as a quick way to logoff but it can also be used as below. Example: MENU NOABORT Selection: 3 1 p MAIL_1 N Q p OFFNOT N DEFAULT exit Logoff Options: [=]=[=]=[=]=[=] [1] Leave feedback to Wayne Watson [Q] Abort logoff [Return] to hangup OFFxx.TXT COMMAND: OFF This file is the same as the OFF.TXT file except it is another file in the sequence. You can have up to 99 OFFxx.TXT files. - 99 - PARMEDIT.TXT COMMAND: PARMEDIT This file is displayed when the user chooses the PARMEDIT option. It was designed to allow the user to change their parameters, etc. Example: {1} Southern Software's Parm Editor ------------------------------- [A] Real Name : {3} [B] Handle/Alias : {2} [C] Street Address: {5} [D] City : {6} [E] State : {58} [F] Zip Code : {7} [G] Phone Number 1: {8} [H] Phone Number 2: {97} [I] Password : {4} [J] Computer Types: {9} [K] Country : {11} [L] Birth Date : {12} [M] Video Width : {14} [N] Video Length : {15} [O] Sex : {46} PASSWORD.TXT This file is displayed if you have the BBS setup as a Private BBS which is set in the System Editor. If this setting is on and there is a System Password defined, then the BBS will look for this file. In it you can tell the user that the BBS is reserved for your use or whatever. Example: Sorry, the BBS is locked for my use right now. Please call later tonight. The Sysop - 100 - PROMPT.DAT This file contains the majority of the PROMPTS that the BBS uses. You can define how the prompts appear to the user, the wording that is used or whatever. You can even have VT52 codes, ANSI codes, etc. in this file. The only restriction is that you can only have up to 10 lines for the prompt. Also, do NOT remove the '!' character between each prompt. The prompt begins after the '!' character. Example: ! (1) Prompt 1 The Prompt starts on the line after the ! The Prompt ends on the line before the next ! ! (2) Prompt 2 etc. If you want the cursor to stay on the same line as the prompt, then do not put a blank line at the end of the prompt. Scan through the PROMPT.DAT file for a look at how things are done and then run the BBS program and see the actual prompts being used. Just experiment with them to get the feel for how they are done. PROTOCOL.TXT This file is displayed anytime the BBS ask the user to choose a Protocol for File transfers. If this file is not found, then the BBS will use a built in display of the available Protocols. The selections in this file should match what is in the PROTOCOL.DAT file which can be edited in the System Editor. Example: {1} Southern Software's Protocols ----------------------------- [C] Xmodem Chksum [F] Fmodem Batch [G] Ymodem-G Batch (Not Yet) [K] Xmodem 1K [X] Xmodem CRC [Y] Ymodem Batch [Z] Zmodem Batch [Q] Quit (Abort Transfer) - 101 - RINGBACK.TXT COMMAND: RINGBACK This file will be displayed prior to the BBS hanging up on the user to call them back if they choose the Ringback feature and you have it enabled in the System Editor. It just explains what the BBS is about to do and gives the user instructions that they may need. Example: {1}Ringback [==========] Ringback will force the BBS to hang you up, and call you right back. This is often helpful for line noise, or those who have "Measured" service. Three attempts will be made to call you. If those are not successful, the BBS will give up on you. There will be a short pause before the BBS calls you back. During this time you should configure your modem to auto-answer incoming calls (If it isn't already). To do this with a Hayes-Compatible modem send the command "ATS0=1" to the modem. {47} SYSNEWS.TXT This file is part of the LOGON sequence. It was designed to be used for any news from the Sysop, etc. You can set it up as a Menu File or whatever. Example: MENU Selection: 7 1 t J:\TEXT\MENUS0\SYSINFO.TXT 2 t J:\UPDATES\UPDATES.TXT 3 t J:\UPDATES\UE_UPD.TXT 4 t J:\SYSEDITG.PTC\CHANGES.TXT 5 t J:\TEXT\MENUS0\VERSIONS.TXT 6 t J:\TEXT\ALTRNATE.TXT DEFAULT EXIT {1} Welcome to Southern Software [1] Latest System News [2] Update File for Transcendence BBS [3] Update File for User Editor [4] Update File for System Editor [5] Latest Version of Programs [6] Alternate Download Locations [RETURN] to Exit Above is an example of a Menu file for the System News. You can also have just a plain text file for the System news. - 102 - SYSNEWSxx.TXT This file is the same as the above SYSNEWS.TXT file except, it is just the next file in sequence to be displayed after the SYSNEWS.TXT file. You can have up to 99 SYSNEWSxx.TXT files. SYSONSYS.TXT This file is displayed to the user when the Sysop enters the Sysop Mode (Dos Shell) using the F1 function key and chooses the '<1> Send Msg' option. Example: I'm BUSY, just hold on a sec... SYSOPOUT.TXT COMMAND: CALLSYS This file is displayed when the user chooses the CALLSYS command to page the Sysop and Chat Mode is turned off. Example: I am at work, At the tone, [L]eave feedback and I will answer your mail when I get home. TERMINAL.TXT COMMAND: TERMINAL This file is displayed user chooses the TERMINAl command. It just displays the available emulation modes and what number they need to choose. The number the user chooses will cause the BBS to look in the MENUSx folder for files that are to be displayed to the user. The 'x' in MENUSx corresponds to the number the user chooses. Example: {1}Southern Software's Terminal Types ---------------------------------- [0] - 80 Column ASCII [1] - VT52 Mono [2] - VT52 Color [3] - ANSI Color If the user chose 1, then the BBS would look in the MENUS1 folder for text files that you have defined. If the BBS does not find the file it is looking for, then it will look in the MENUS0 folder for the file. The BBS will always revert back to the MENUS0 folder if a file is not found in the currently selected MENUSx folder. In the above example, you would have text files setup with VT52 mono escape codes so that the files will show up properly with someone using a mono monitor and using VT52. - 103 - USERLIST.TXT COMMAND: USERLIST This file is displayed when the user chooses the USERLIST command. It is used to display the options available. If it is not found, the BBS will use a built in display of the options available. Example: Search Methods ============== [1] - Search by Name [2] - Search by City [3] - Search by State [4] - Search by Computer [5] - Search ALL USERPARM.TXT COMMAND: USTATS This file is displayed when the user chooses the USTATS command. It is designed to give the user an overview of their statistics. You can define whatever you want displayed. The USTATS command will also only allow the user to change their Password. This is different than the USERPARM command. Example: {1}Your Current Status: -------------------- {3} (aka {2} #{17}) {5} {6}, {58} {7} {8} {97} Age : {10p20} Sex : {46} Computer : {9p20} Password : {4} Country : {11p20} Birthday : {12} First Call: {25p20} Last Call: {24} Messages Entered : {13p10} Email Messages Entered: {16} Downloads : {18p10} Uploads : {19} UL:DL Ratio : {20p10} Time Limit Per Day : {21} Time Limit Per Call: {22p10} Time Used Today : {23} Calls by you : {26p10} Access Levels : {29}/{45}/{86}/{87} Daily Call Limit : {49p10} Max. Email/Day : {82} Max. Feedback/Day : {83p10} Max. Pages/Call : {84} Download Points : {88p10} Number of "Hangups" : {89} Notice the Variable Tag usage in this file. Below is a a list of the Variable Tags. - 104 - VERIFY.TXT This file is displayed to the user if you have the Auto-Verify option turned on in the System Editor and the user is a new user. It is used to explain to the user what is about to happen and how to react or setup their system so when the BBS calls them back, they will be setup to answer and enter the information requested by the BBS. Example: {1}Auto-Verify [============] This BBS will Automatically verify users by calling them back, and verifying their password. This allows me, the Sysop, to know if you have provided me with a valid phone number. I am an understanding Sysop though, if you can not receive incoming calls for any reason then refuse the Verification process, and explain why in Email. To receive the incoming call send the command "ATS0=1" to your modem, after the BBS has terminated its connection with your modem. The BBS will make three attempts to verify you, one right after the other. {47} WAITCALL.TXT This file is displayed when the BBS is at the WaitCall screen. This is the information at the top of the screen. If this file is not found, then the BBS will use the built in display of information. WELCOME.TXT This file is displayed upon connection right after the CONNECT.TXT/CONNEXTxx.TXT files. Example: TEXT NOABORT {1} [========================================================] Welcome To a new Transcendence BBS [========================================================] WELCOMExx.TXT This file is basically the same as the WELCOME.TXT file except it is displayed in sequence after the WELCOME.TXT file. You can have up to 99 WELCOMExx.TXT files. - 105 - VARIABLE TAGS Variable Tags allow the Sysop and in some instances the user, to place what is called a Variable Tag into a Text File, Menu File, Prompt file, etc. The BBS will then replace the {x} with the Data described below. These are used in files such as the EDITUSET.TXT file, etc. They are used for general purpose text files that will display the current data based on the user viewing the data, etc. Below is a list of all the Variable Tags used by the BBS and the information they provide. Each Variable Tag must be used in conjunction with braces as shown below. You can use a 'p' in a variable tag along with a number in order to pad the tag to so many spaces. This will keep the output of the tag to a set length. Example: {2p30} would always display the User's Handle at 30 characters in length. This helps to keep the output of a file lined up in columns. General Purpose Variable Tags These tags provide information about the user, to control the BBS, etc. {1} Clears the Screen {2} User's Handle {3} User's Real name {4} User's Password {5} User's Address {6} User's City {7} User's Zip Code {8} User's Voice Phone Number {9} User's CPU {10} User's Age {11} User's Country {12} User's Birthday {13} Number of Messages Entered and number of Replies {14} User's Video Width {15} User's Video Length {16} Number of Emails sent by user {17} User's User Number {18} User's number of Downloads {19} User's number of Uploads {20} User's DL:UL Ratio {21} User's Time Limit per Day {22} User's Time Limit per Call {23} User's Time Used Today {24} User's Last Call Date {25} User's First Call Date {26} User's number of Calls {27} Today's Date (01/19/93) {28} Today's Date (Jan. 19th, 1993) {29} User's Command Table Level {30} Number of Calls to System {31} Last Caller {32} Number of Calls Today {33} Current Baud Rate of User {34} Current Time {35} User's Time Left for this Call {36} User's Connect Time - 106 - {37} Military Time {38} Prompt for MORE {39} Sysop's Name {40} BBS Version number {41} BBS Name {42} BBS Node number {43} Chat Mode Status {44} Emails to you {45} User's File Area Level {46} User's Sex (M/F) {47} Press Return Prompt {48} Press Space prompt {49} User's Daily Call Limit {50} Not Used {51} User's Downloads this Call {52} User's Uploads this Call {53} User's Downloads per Day Limit {54} User's Uploads per Day Limit {55} User's Downloads Today {56} User's Uploads Today {57} User's number of Calls Today {58} User's State {59} Number of User slots allocated {60} Number of User slots in use {61} Number of New Users {62} Number of Surveys taken (NOT USED) {63} User's number of Fmails sent {64} User's number of Fmessages sent {65} User's number of Games Played {66} User's number of Feedback Messages sent {77} Number of Messages entered on System {78} Number of Emails entered on System {79} Number of uploads to System {80} Number of Downloads from System {81} User's Alert Status (Alert! or Normal) {82} User's Max Email per Day limit {83} User's Max Messages per Day Limit {84} User's Max Feedback per Day Limit {85} User's Max Pages per day {86} User's Online Game Level {87} User's Menu Processor Level {88} User's Download points {89} User's number of Illegal Hangups {90} User's last date of completing New Files Listing {91} General Purpose BBS tag {92} Event's ON time. Time system coming down for Event Scheduling. {93} Name found during a partial name search in Email {94} General Purpose BBS Tag. File Not Found. {95} Number of Email entries TO user {96} General Purpose BBS tag {97} User's DATA Phone Number {98} Number of seconds to pause output. (98-x) x = seconds {99} User's Current Emulation in NUMBER format. - 107 - {100} User's Current Emulation in TEXT format (VT52 Color) {101} User's Default Terminal (Emulation) Type {102} User's Default Window size (Sysop Only) in Text format {103} User's Auto-Email setting {104} User's Page Pause setting {105} User's Hotkey setting {106} User's Command Stack Printing setting {107} User's Clear Screen setting {108} User's Default Archive Type setting {109} User's Continuous Message Scroll setting {110} User's Pause Time between Messages setting {111} User's File Area Prompt setting (long or Short) {112} User's Message Base Prompt setting (long or short) {113} User's Word Wrap in Editor setting {114} User's Line Numbers in Editor setting {115} User's Scan Mark Message Base setting {116} User's Editor Summary setting {117} User's Auto Quickscan New Messages setting {118} User's Auto Quickscan New Files setting {119} User's Emacs Editing setting {120} User's New Files Scan setting (Catalog or Long listing) {121} User's Key Aborts Text setting {122} Banners Prompt (Displays Random Banner) {123} Banners Prompt (Displays Currently Loaded Banner) {124} Destructive Backspace. (124-x) x = number of backspaces to use {125} Non-Destructive Backspace. (125-x) x = # of backspaces to use {126} User's Current Information location in protected Memory {127-136} Not Currently used The next few Tags were designed to be used in the Who's Called listing which uses the CALLS.TXT file for output of the last 'x' number of callers. The number of callers to display is set up in the System Editor. {137} Caller number {138} Handle {139} Call Date {140} Baud rate {141} Connect Time {142} Logoff Time Tags {1000} - {1100} are Sysop definable Tags. You can have up to 100 tags defined in DEF_TAGS.DAT which goes in the DATA folder. Refer to the description of this file in the DATA Files section. - 108 - Message Base Variable Tags These tags provide information about the Current Message Base and currently selected Message. {200} Message Base Number {201} Message Number {202} Lines in Current Message {203} Message Base name {204} From (handle) {205} To (handle) {206} Date Message was posted {207} Time Message was posted {208} Subject of Message {209} Number of replies to Message {210} Message's Status in Text format (Normal, Extended, etc.) {211} Number of New Messages to user in selected Message Base {212} User's highest Message Read in selected Message Base {213} Max number of Messages that can be entered on selected Msg Base {214} Max number of Lines that can be entered on selected Msg Base {215} User's highest Message read in selected Message Base {216} Message Number this Message is a reply to {217} Date Message was read by TO user {218} Time message was read by TO user File Area Variable tags These tags provide information about the File Area and currently selected File. {300} File Area Number {301} File Area Name {302} Number of Files Marked for Batch DL {303} Filename of selected File {304} Filesize of selected File {305} Program Type of selected File {306} Uploader of selected File {307} Upload Time of selected File {308} Upload Date of selected File {309} Last Downloaded Date of selected File {310} Number of Downloads of selected File {311} File Level of selected File {312} File Status of selected File {313} CPU Type of selected File {314} Monitor Type of selected File {315} File Description of selected File {316} Approx. Time to Download at {33} Baud Rate of selected File {317} Used for a Blank Space {318} User's Default Protocol {319} User's currently selected Protocol {320} Number of Descriptions/Files in File Area {321} Approx. Time to Download Marked Files {322} File Number of selected File {323} Not Used {324} Xmodem Blocks of selected File {325} Y/Zmodem Blocks of selected File {326} Fmodem Blocks of selected File {327} CPS Rating of downloaded File(s) - 109 - {328} Old Filename. Used during File Renames {329} New Filename. " " {330} Max number of allowed Uploads {331} Max Upload Size. Most available Space on Drive. {332} File Type of selected File {333} Used for Questions when Editing File or entering Description {334} Brief Description of selected File {335} Catalog Letter Choice - 110 -