ftp.wwiv.com

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

/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / SBBS_112.ZIP / SBBS_112.DOC < prev next >

Wrap

Text File | 1991-09-21 | 363KB | 8,643 lines

▄▄▄▄ │ ▄ ▀ │ SuperBBS Bulletin Board Software. ▀▀▀▄ │ ▀▄▄▄▀ │ Release 1.12, date: Sep 25, 1991 │ ▄ ▄ │ Copyright (C) 1990/1991 █ █ │ █ █ │ █▄▄▄▀ │ │ SuperBBS program and utilities are copyrighted by: ▄▄▄▄ │ ▄ █ │ - Risto Virkkala █▀▀▀ │ - Aki Antman █ │ │ Some external utilities based upon code written by: ▄▄▄▄ │ ▄ │ - Jouni Malinen █▀▀ │ █▄▄▄ │ Documentation is copyrighted by: │ ▄▄▄▄ │ - Frank Hemmelder ▄ █ │ █▀█▀ │ █ ▀▄ │ │ ▄▄▄▄ │ Documentation release V1.12FH01. ▄ █ │ █▀▀▀▄ │ █▄▄▄▀ │ │ ▄▄▄▄ │ SuperBBS, the specific external utilities and this ▄ █ │ documentation are protected under the copyright laws █▀▀▀▄ │ of Finland and other countries. You are not authorized █▄▄▄▀ │ to copy, edit or modify these files without written │ permission of the copyright holders. ▄▄▄▄ │ ▄ ▀ │ This documentation is for release 1.12 of SuperBBS. ▀▀▀▄ │ Woerden, Holland, Sep 17, 1991. ▀▄▄▄▀ │ Chapter 1. SuperBBS general information ============================================================== 1.1 General information -------------------------------------------------------------- SuperBBS has become a major BBS software package with a lot of features not found in other bulletin board systems. This documentation is meant to be for release 1.12 of the SuperBBS program. The documentation is completely updated for this 1.12 release, but I don't take any responsibility for errors in this documentation. This manual has grown to the size of a small book, with over a hundred pages with information. I hope it is of any use for you, experienced or non-experienced user. This manual is written in plain ASCII, 58 lines per page and only a page break is inserted. Except for the title page, no extended characters are used. SuperBBS is a QuickBBS (TM) look alike software program, but with many different options. It uses the Hudson type message base, meaning that you have only 5 files, which contains your complete messagebase. Menu and textfiles options are very flexible and a Sysop can build his BBS system as complex as he/she wants. Many doors (= external programs like utilities and games) are available for use in SuperBBS. SuperBBS is distributed as Shareware. This means you can test the software for 30 days, before you either have to register or to stop using the program. Not registering the program but using the program after 30 days could mean that a next version of SuperBBS will not be distributed as Shareware. Please support Shareware and register your software after the trail period. SuperBBS, it's specific external utilities and the documenta- tion are protected under the copyright laws of Finland and other countries. You are not allowed to modify, edit, change, loan etc. these files without written permission of the copyright holders. Any violation of this copyright will be reported to the authorities. This includes patching an un- registered version of SuperBBS to make it appear registered. An international Fidonet echomail link called SUPERBBS, has been setup and is available to most countries. If you have problems, questions or remarks about SuperBBS and it's util- ities, please search for this area on a BBS near you. Most SuperBBS sites have this echo available. There is also a SuperBBS SDS area available. Available to all registered SuperBBS sysops is the network SuperNet. This is an international fido like network for SuperBBS sysops all over the world. It has it's own echomail areas available for reporting bugs, finding hints and other useful information. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 001 SuperBBS will be distributed accordingly: - Alpha versions Not available. - Beta versions Available to all BETA testers. - Gamma versions Available to all registered Sysops. - Normal versions Available to everybody, including non-registered users. Updated documentation will only be available with the official releases. Beta and Gamma releases will have a special what's new file included. 1.2 SuperBBS credits -------------------------------------------------------------- Here are the credits for SuperBBS: Programming and design: Aki Antman and Risto Virkkala Documentation: Frank Hemmelder Protocol Engine (PE): Copyright Joaquim H. Homrighausen, ALL RIGHTS RESERVED. 1.3 SuperBBS addresses -------------------------------------------------------------- How to reach the SuperBBS programmers: BBS name...........: SuperBBS HQ Telephone number...: +358.0.341.1398 Modem speed........: HST / V.32 DS Online hours.......: 24 Hrs Fidonet number.....: 2:220/620 SuperNet number....: 42:1200/101 Sysop..............: Aki Antman or by mail: Address............: Aki Antman (SuperBBS H.Q.) Porslahdentie 23 G 40 SF-00980 Helsinki Finland, Europe -------------------------------------------------------------- SuperBBS v1.12 documentation Page 002 How to reach the SuperBBS documentation writer: BBS name...........: Nederlands Net Nieuws (Super)BBS Telephone number...: +31.3480.24801 Modem speed........: V.32bis / V.42Bis / MNP5 Online hours.......: 24 Hrs Fidonet number.....: 2:500/239 SuperNet number....: 42:1101/101 Sysop..............: Frank Hemmelder or by mail: Address............: Frank Hemmelder (Nederlands Net Nieuws (Super)BBS) Lekoord 43 3448 VS Woerden Holland, Europe 1.4 How to contact us -------------------------------------------------------------- If you need to come in contact with us, there are several ways available. Here they are: - Send a letter to the address of the SuperBBS authors. Please include payment to return an answer. - Send a netmail message to the SuperBBS HQ BBS. Please include a Fidonet address to where the answer should be send. - Write a message in the international SuperBBS echomail area available in most countries. Your answer will also be posted here. Depending on the location you posted your message, this could take some time. - Write a message in the SuperNet echomail areas, available on most registered SuperBBS sites. FidoNet is a worldwide network, and contains over 8,000 sys- tems around the world, so it is easy to post a message from any country through Fidonet. 1.5 Legal stuff -------------------------------------------------------------- Disclaimer: The authors of SuperBBS and the utilities are NEVER respon- sible for any damage occurring through the use of SuperBBS and/or utilities. We only guarantee that SuperBBS will take up space on your harddisk. It has been tested on several systems and it works there, but this doesn't mean it won't destroy your HDU or kill your cat or dog. Use at your own risk! -------------------------------------------------------------- SuperBBS v1.12 documentation Page 003 However, if you do find an undocumented feature (= bug) or are having problems with running SuperBBS on your system, we would like to hear from you. Please contact us, so we might be able to fix the problem. SuperBBS may not be used in any UNLAWFUL manner or illegal activity. If this will happen, we will always inform the local authorities. You are not allowed to modify ANY of the executable files of SuperBBS or to change this documentation. The authors don't guarantee any future releases of SuperBBS. All files belonging to the SuperBBS package are copyrighted 1990-1991 by Aki Antman and Risto Virkkala. Documentation is copyrighted 1990-1991 by Frank Hemmelder. You are not allowed to modify, patch, disassemble (or anything like that) these files without the written permission from the copyright holders. You are not allowed to ship the SuperBBS programs, or part of the programs, in other software/hardware packages without written permission from the copyright holders. Sysops of bulletin boards are allowed to post the SuperBBS software package for download to their users in an unmodified version and as long as no charge is asked for downloading the software. It is not allowed to add BBS commercials to the software archive. The use of a ZIP or ARJ header is however allowed. Sysops should make it possible for all their users to download the SuperBBS package if requested by the user. 1.6 How to register -------------------------------------------------------------- SuperBBS is released under the ShareWare concept, so you can try it for 30 days before you have to register this product or stop using it. If you are using this software after the 30 days trail limit, you MUST register. This software is not cripple in any way. You can test the whole package. Please support the shareware concept. Through this concept it is possible to test the software before paying for it. If you decide the software is 'just what you wanted', you will need to register. If you don't register, you will violate the Shareware concept. This could mean that the next version will be a commercial one, so you won't be able to try it before buying. > Register ShareWare - Guarantee the future of SW programs. < -------------------------------------------------------------- SuperBBS v1.12 documentation Page 004 Registration of SuperBBS entitles you to use the software after a period of 30 days. It will also give you access to the SBBS Gamma relases, which are only available to registered users. Registration entitles you to use any SuperBBS release up to version 1.99. (Currently v1.12) This will take a long time and many new releases and improvements. 1.6a Registration in FINLAND only -------------------------------------------------------------- Send FIM 150,- to the account: '710125 - 313639 STS', _PAY- ABLE_ to Risto Virkkala and send in the registration form with the following information: - The Sysop name to register SuperBBS to - The BBS name to register SuperBBS to Please note that upper and lower case are different! - Your real name - Your address - Your voice and data phone numbers - Your FidoNet address (if available) When we received your payment, your registration code will be posted to you. This can take some time, so please be patient. 1.6b Registration abroad -------------------------------------------------------------- Send US $50 cheque or money order to the SuperBBS HeadQuarters address posted. Make cheques payable to: Risto Virkkala. Make sure your shipment arrives in good order. Creditcards can't be accepted at this moment. Please include the following information. Note that upper and lower case are different with the registration names! - The Sysop name to register SuperBBS to - The BBS name to register SuperBBS to - Your real name - Your full address including Country - Your full (international) voice and data phone numbers - Your Fidonet address (if available) If you are part of Fidonet, please include your BBS opening hours, so we can crash your registration key to your board. This will give a faster turn around time then by mail. You will receive your registration key after we have received your money. Please do allow some time for processing and handling. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 005 Registrations are also possible at some of our Support sites. Please check the file HOWTOREG.TXT included in the main BBS archive for more information. 1.6c Site registrations -------------------------------------------------------------- Site registrations are also available: 5-9 boards..... US $45 10-more boards..... US $40 Please authorize one of you to register all boards on the site. This person has to send us the information and money for the registration and we will send him/her the registration codes for all boards. Do not send the money separately! Send money and information required to the SuperBBS HeadQuarters. Site licenses are not available at the Support sites. 1.7 Differences registered/evaluation -------------------------------------------------------------- There are some differences between the registered version of SuperBBS and the evaluation copy. The evaluation copy is however not crippled and can be used to evaluate the program in all available aspects. The only differences between evalu- ation and registered copies are: When somebody is login in to your system, a message will be displayed to him/her: Registered version: "SuperBBS v1.12, registered to: <Your name>" Unregistered version: "SuperBBS v1.12, unregistered evaluation copy." This message will also be displayed if you choose the display version number menu item. The tearline in the echomail areas originating from your board will look like: Registered version: "--- SuperBBS v1.12 (Reg)" Unregistered version: "--- SuperBBS v1.12 (Eval)" -------------------------------------------------------------- SuperBBS v1.12 documentation Page 006 1.8 Distribution files -------------------------------------------------------------- SuperBBS is distributed in an archive named 'SBBS_nnn.xxx', where nnn is the version number and xxx the archive type. Please do not modify this file in any way. Do not add your own adds to the archive. (Some archivers do however allow you to add a archive header.) The SuperBBS archive file should have the following files: BBS.EXE Main executable file OVRBBS.OVR Overlay file (only in overlay version) CONFIG.EXE Configuration program file LCONFIG.EXE Language/String configuration file YELLCFG.EXE Yellsound editor program file EXTPE.EXE Protocol driver PROTO.$$$ Example for external protocols USERFIX.EXE User database fixer USERPACK.EXE User database packer USERSORT.EXE User database sorter SBBSUSER.EXE User database editor SBBSUSER.HLP SBBSUSER.EXE help file SBBSUTIL.EXE SuperBBS utilities SBBSMENU.EXE SuperBBS menu editor STOP.EXE Top xx list generator Also included is an archive with startup files, which makes it possible for you to start a bulletin board in a short time. Documentation concerning registration, update information, technical descriptions and menu types is also included. This documentation is also supplied as a file 'SDOC-112.ZIP'. This also include the registration information, technical information and menu types list. The documentation will be named SBBS_nnn.DOC, where nnn stands for the version number of SuperBBS which it applies to. If you received more or less files, you have a modified archive. You should not distribute this file any further and get a complete version from one of the distribution nodes. You may distributed the unregistered version of SuperBBS freely, as long as no fee is asked or any profit is made. Please make sure all users of your bulletin board are able to download the SuperBBS archive. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 007 Chapter 2. Installation ============================================================== 2.1 General information -------------------------------------------------------------- SuperBBS is a very flexible program. Please read this documen- tation carefully. Although the program is complex, it is not hard to setup a bulletin board system with it. Have a look at the samples if you are new to running a bulletin board. This will help you to get a BBS up and running in a very short time. If you do however run into problems, consult this manual again and if you still have problems, contact one of the support boards or the authors. The SuperBBS echomail area is also available to ask questions and it often will give you hints from other (more experienced) SuperBBS users. 2.2 Software requirements -------------------------------------------------------------- Besides the SuperBBS files, you will need some external files before you can run SuperBBS. These files can differ from system to system, depending on the way you have set it up. You will at least need these files, or compatible: MS-Dos Sounds logical, without this your system won't even run (or not with an operating system SuperBBS will run in). You'll need version 2.0 or higher. SuperBBS has been tested with Ms-Dos up to version 5.00, but version 3.3 or 4.0x or 5.00 is recommended. X00.SYS Fossil communications driver, a good re- placement is BNU. SuperBBS will not run without this file! (Except in Local mode.) QUICKED.EXE The full-screen editor. (This file is optional.) THEDRAW.EXE Or any other ANSI/ASCII text editor. This program will help you design your ANSI and ASCII support files. (This file is optional.) A more complete list of external files for SuperBBS is included in the back of this documentation. Most QuickBBS files work with SuperBBS. Please keep in mind that SuperBBS is much bigger than QuickBBS and there could be programs which will work perfect on a QuickBBS system, but not, or not complete, on a SuperBBS system. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 008 2.3 Hardware requirements -------------------------------------------------------------- Some hardware is needed to run SuperBBS. SuperBBS uses about 190 Kbyte base memory and can use EMS memory for the overlay file. Other requirements are: Harddisk A harddisk with at least 2 MB of free diskspace is needed to setup SuperBBS. You'll probably need more if you set up a lot of utilities to run under SuperBBS and have many mail areas. A system with 70 mail areas (6000 messages), 30 file areas and 10 online games uses around 20 MB of disk space for the systemfiles and support programs. Hayes Modem A Hayes compatible modem, either internal or external, is needed. Speeds up to 38400 Bps are supported. When running a multi-node system with Desqview (TM) or Windows (TM), a 80386DX processor is recommended. Running single line is possible on a slow XT, although a 80286-12 or higher is preferred. 2.4 Unpacking the software -------------------------------------------------------------- Move your SuperBBS archive to the main directory you want your BBS files in. (In our example C:\SBBS) Unpack the archive. You can move the documentation files to another directory if you want. Make a directory for your menu files, your textfiles, the TEMPDIR and a working directory. Also create a directory for your message files if you don't want them in your main BBS directory. You would get something like this (for single line operations only): C:\SBBS C:\SBBS\TEXT C:\SBBS\MENU C:\SBBS\MAIL C:\SBBS\TEMP C:\SBBS\WORK Now you need to start the configuration program CONFIG.EXE. Please refer to the part of this documentation concerning the CONFIG.EXE program. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 009 The directory setup for the multi-node operations is a bit more difficult. You will have to make a directory for every node you plan to run, even if it's only a local node. Your directory setup could look like this: C:\SBBS C:\SBBS\LINE1 C:\SBBS\LINE2 C:\SBBS\LINE3 C:\SBBS\MAIL C:\SBBS\LINE1\TEMP C:\SBBS\LINE2\TEMP C:\SBBS\LINE3\TEMP C:\SBBS\LINE1\WORK C:\SBBS\LINE2\WORK C:\SBBS\LINE3\WORK E:\ You will have to setup a TEMP directory and a WORK directory for every line in use. The E:\ drive is a RAM disk and is the common directory for all nodes. You can also use a normal disk if no RAM drive is available. 2.5 Configuring SuperBBS -------------------------------------------------------------- CONFIG.EXE is the main installation program for SuperBBS. You need to run this program to set all settings correct for your system. You can run the configuration program as often as you like, it will save the current configuration when you exit the program. When you start CONFIG.EXE, you will be presented with the following options: 0. System paths 1. Modem 2. Netmail 3. New user parameters 4. General (Page 1) 5. General (Page 2) 6. General (Page 3) 7. Restrictions 8. Colour config (Page 1) 9. Colour config (Page 2) A. Alt Fkeys S. String configuration M. Message base editor E. Event editor F. Filearea editor L. Limits editor P. Protocol editor -------------------------------------------------------------- SuperBBS v1.12 documentation Page 010 You can choose any option from here. If you press <ESCAPE>, you will be brought back to DOS and the configuration will be saved. This file is called CONFIG.BBS and should never be deleted, unless you want to start all over again. This file contains all information about your systems settings. All available configuration options will be explained below. The following notation standard will be used: Type.........: Name of the current option Description..: Explanation of the option and it's function in the BBS program. Options......: The available options. 2.5a Paths & Description -------------------------------------------------------------- This part is important. Making mistakes here could cause SuperBBS not to run. Make sure all paths are correct. A back- lash at the end of a directory path is optional. Type.........: Text path Description..: Drive and directory where your supporting ASCII and ANSI textfiles will be stored. In the LCONFIG.EXE program are the path statements also included. If SuperBBS can't find the wanted file in the directory stated in the language file, it will look in the directory specified here. Options......: Drive:\Pathname Type.........: Menu path Description..: Drive and directory where your menu files are stored. In the language file you also have to specify the directory for the menu files. If SuperBBS can't find the wanted menu file in the directory stated in the language file, it will look in the directory specified here. Options......: Drive:\Pathname Type.........: Net path Description..: Drive and directory where your netmail is stored. Some mailer systems can handle *.MSG netmail messages and they need this directory. If you use D'Bridge (TM) and SuperBBS with the netmail area setup as a QuickBBS (TM) type mail area, you have to point this directory to an existing directory, although the option is not used with this configuration. Options......: Drive:\Pathname -------------------------------------------------------------- SuperBBS v1.12 documentation Page 011 Type.........: Message base path Description..: Drive and directory where your message base files (MSG*.BBS) are stored. This can be the main SuperBBS directory, or another directory. Point this to the same directory for every line you run in a multinode system. Please note that some echomail processors require the message base files in the main BBS directory. All the MSG*.BBS files will be created the first time you run SuperBBS. Options......: Drive:\Pathname Type.........: Temporary path Description..: Drive and directory where SuperBBS will place temporary files, created when using the archive extract, view and repack option. A multi-node system will need a directory for every node. Options......: Drive:\Pathname Type.........: System path Description..: Drive and directory where your main BBS files will be placed. This is the directory you run the configuration program from. Here all system files will be placed. Options......: Drive:\Pathname Type.........: Work path Description..: Drive and directory where SuperBBS will place files it has to work with. Files uploaded to your BBS can be checked for viruses in this directory. Create a directory for every node you are running. Options......: Drive:\Pathname Type.........: External editor Description..: Drive, directory and filename of the external editor you want to use in the BBS. The most used editor is Quicked. Leave this page blank if you don't have a full-screen editor. Super- BBS now writes DORINFO1.DEF and EXITINFO.BBS before shelling to the editor. This allows you to use the *S command, to tell SuperBBS to shell to EMS/DISK before calling the editor. Option.......: Drive:\Pathname\Filename.ext The multiline options are available for running a multiline system. SuperBBS is designed to run multiline. You have to fill in the following options, even if you run a single line system. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 012 Type.........: Lines in system Description..: Number of lines you are running. If you run a single line system, enter 1. Otherwise enter the number of lines, including local lines. Make sure you set this to the same amount for every line. Options......: Number of lines Type.........: Common path Description..: Drive and directory which will be used by all lines available as a common directory. A RAM disk of 30 to 50 Kbytes is recommended. A nor- mal disc can also be used if a RAM disc is not available. Options......: Drive:\Pathname 2.5b Modem -------------------------------------------------------------- These options allow you to setup the way you modem will be handled by SuperBBS. This is optional if you run a mailer in front of the SuperBBS program. The mailer will take care of answering the phone, instead of the SuperBBS program. Please use your modem manual to check the settings. Type.........: Port Description..: Communication port the modem is connected to. (This should be the port your modem is setup at, when you have an internal modem.) Options......: 1, 2, 3 or 4 Type.........: Initializing baudrate Description..: The fastest baudrate your modem supports. If you have a 2400 Bps modem, set this to 2400. Options......: 300 to 38400 Type.........: Initializing tries Description..: Number of times SuperBBS will try to initialize the modem. When the modem will not initialize, SuperBBS will give you a warning message and return to MS-Dos or the batchfile. Options......: Number Type.........: Seconds to wait for carrier Description..: Time SuperBBS waits for a carrier signal, before resetting. Options......: Seconds -------------------------------------------------------------- SuperBBS v1.12 documentation Page 013 Type.........: Initializing string Description..: String send to the modem to reset the modem and prepare it to receive callers. Check your modem manual for the string used to setup your modem. The pipe symbol | can be used for a carriage return. (Some modems take a ^M as a CR.) Options......: Modem init string Type.........: Initializing response Description..: Answer the modem sends to the program, after the initialization string has been send to the modem. This response tells SuperBBS the modem is ready to receive calls. Options......: Modem response string Type.........: Offhook string Description..: String send to the modem when you want to place the modem in 'offhook' mode. This means the callers will receive a busy signal. Please note that in some countries it is illegal to switch a modem offhook. Options......: Modem offhook string Type.........: Offhook response Description..: Answer the modem sends to the program, after the offhook string has been send to the modem. Options......: Modem offhook response string Type.........: xxxx Baud Connect (xxxx = 300 to 38400) Description..: Response from the modem after it has detected a caller and established a connection. This tells SuperBBS at what baudrate the user is calling. Check your modem manual for more information. Users of modems with MNP or V.42bis errorcor- rection protocols should use the normal connect strings for the reliable connections. Options......: Modem response 2.5c Netmail -------------------------------------------------------------- This part is only of interest to you if you are part of Fidonet or another network. Systems in a network exchange netmail and echomail and are using a network address. In the netmail part you will specify your address and your AKA's. AKA's are fake addresses used by some BBS systems which have a node address in more than one (Fidonet like) network or zone. You can obtain a network address at a network administrator. Ask a local sysop who is connected to a network how to contact the administrator. Do not use a number of your own choice. If you are no part of a network, leave the fields as they are. An example: 2:220/620. This is a BBS system in Europe (Zone 2). Net 220 is in Finland and number 620 is Aki's system. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 014 Type.........: Main address Description..: The number of your main address. This number consist of four parts: zone, net, node and pointnumber, although the pointnumber is left out for most BBS systems. Options......: Zone, net, node and pointnumber Type.........: AKA Address #1 to #5 Description..: See main address. If you don't use more than one address, leave this as it is. Options......: Zone, net, node and pointnumber or 0. Type.........: Netmail board Description..: Message base area (between 1 and 200) which will be used to store netmail messages. You also have to setup this area in the message base configuration part of the program as being a netmail area. Set this to an unused area if you are not using netmail. Options......: Message base number (between 1 and 200) 2.5d New user parameters -------------------------------------------------------------- A caller who has never been on your system has to be assigned a special userlevel. This could be a normal level, which you are using for all users or, like most BBS systems do, a lower level, so you, the Sysop, can check his/her information. You will have to specify a userlevel and also the flagsetting. SuperBBS uses a double security system. All users, including the Sysop(s) have a security level. Besides that security level there are also 32 flags available. These flags can be toggled on or off. (X = On / - = Off) With these flags you could restrict people with a same userlevel from using the same options. Here is an example: User 1: User 2: Userlevel: 25 Userlevel: 100 Flag A: X------- Flag A: -------- Flag B: -------- Flag B: -------- Flag C: --XX---- Flag C: -------- Flag D: -------- Flag D: --XX---- Menu option A: Menu option B: Level needed: 25 Level needed: 25 Flag A: -------- Flag A: -------- Flag B: -------- Flag B: -------- Flag C: -------- Flag C: -------- Flag D: -------- Flag D: --XX---- -------------------------------------------------------------- SuperBBS v1.12 documentation Page 015 Menu option C: Menu option D: Level needed: 10 Level needed: 100 Flag A: -------- Flag A: -------- Flag B: -------- Flag B: -------- Flag C: --XX---- Flag C: --XX---- Flag D: -------- Flag D: -------- User 1 would be able to use menu options A and C. The user has no access to menu option B or D, because in option B his flagsetting is not correct and in option D his userlevel is not high enough, although the flagsetting is correct. User 2 has access to menu option A and B. The user has no access to menu C because of the flagsetting, although his level is high enough, and the access to option D is denied because of the wrong flagsetting. You see how powerful this safety system can be. Use it with care, specially when you are setting up a BBS for the first time. Check your menu's with all available options, so you won't run in to a nasty surprise, like a user getting to a special Sysop menu. (SuperBBS also has the ability to protect menus with passwords. More of this in the menu commands.) Type.........: New user security level Description..: Level assigned to a new user when he/she enters the BBS for the first time. Options......: Userlevel Type.........: New user flags (A to D) Description..: Flagsetting assigned to a new user when enter- ing the BBS system for the first time. Options......: Flagsetting (X = On / - = Off) 2.5e General (Page 1) -------------------------------------------------------------- The general options in SuperBBS contain information about how SuperBBS reacts to certain things, like inactivity time outs, viruschecks on files, logons with wrong passwords and a whole range of other options. Type.........: Quote string Description..: String which will be displayed when quoting a message. This string will be placed in front of the messagelines you are quoting. The standard quote string in SuperBBS will give you the two first characters from first and lastname of the writer of the message your quoting. Options......: Quote string (Example: >) -------------------------------------------------------------- SuperBBS v1.12 documentation Page 016 Type.........: Upload time credit factor Description..: This option allows you to control the way SuperBBS reacts to an upload. You can give the user back the time spend on the upload or even double or triple it. Or you can do nothing with it. Options......: 0 = Not activated 1 = Returns time spend on upload 2 = Returns double time spend on upload 3 = Returns triple time spend on upload Type.........: Inactivity time (Seconds) Description..: Time in seconds before SuperBBS will disconnect a user if no key is pressed in the specified time period. This option prevents users from keeping the system busy, while they are doing something else. SuperBBS will display a warning 20 seconds before disconnecting. Options......: Time in seconds Type.........: Maximum logon times (Minutes) Description..: Time limit given to new users to logon to your system. Depending on the size of your question- naire, you should set this to a safe amount, otherwise your user will be logged off when in the middle of answering the questions. Options......: Time in minutes Type.........: Menu border colour (0-7) Description..: Colour of all the menu borders hardcoded into SuperBBS. Available colours are: 0. Black 1. Blue 2. Green 3. Cyan 4. Red 5. Purple 6. Brown 7. Grey The colour blue (1) will be displayed as an underlining on monochrome Hercules monitors. This could cause you menus to look weird, so don't use blue if you don't need it. Options......: Colour number -------------------------------------------------------------- SuperBBS v1.12 documentation Page 017 Type.........: Entry files colour (0-7) Description..: Colour of the background when SuperBBS asks the user for input. (For available colours see the menu border option.) Please use this option with care. On VGA monitors some colour combina- tions are not as visible as they could be. (For example yellow text on a green background.) Options......: Colour number Type.........: Maximum password attempts Description..: Maximum number of times the user can try to get the right password to logon to the BBS, before being forced off-line. If enabled, SuperBBS will ask the user if he/she wants to leave a message to the Sysop. Don't set this number to high. Options......: Number of attempts Please note that SuperBBS will not ask for a password if there is no password supplied in the userfile. This can only be achieved through the use of the Sbbsuser.exe program. When an user logs on to your system, he/she has to provide a password of at least 4 characters. You could use this option to provide 'guest' access to your system. Use this option with care! Type.........: Maximum pages per call Description..: Maximum number of times the user can yell for the Sysop per call. If the user tries another time, a message will be displayed. Options......: Number of pages Type.........: Page bell length (Seconds) Description..: Number of seconds the page melody will be played when the user tries to page the Sysop. This will only be heard at the Sysop machine. If you don't use Yellcfg.exe, this will be a 'fiuus' siren like sound. Options......: Time in seconds Type.........: Sysop security level Description..: Security level used by the System Operator of the BBS, mostly you! Options......: Security level Type.........: Registration code A Description..: The registration code as supplied by the authors of the SuperBBS program. This code will unlock all features in SuperBBS only available to registered users. Leave this the way it is if you run an evaluation copy. Options......: Registration code -------------------------------------------------------------- SuperBBS v1.12 documentation Page 018 Type.........: Registration code B Description..: Registration code for BETA testers of the SuperBBS program. (Currently there are BETA testers enough. Only when you run a special configuration, like a network, you could apply for a BETA tester code.) This code only works if code A is available also. Options......: Registration code Type.........: Sysop name Description..: The name of the person who registered the SuperBBS program. This must be exactly the same as on your registration, otherwise the system will not display the 'registered' message. Normally this is the Sysop's name. Any message written to 'Sysop' will be addressed to this name. Options......: Name Type.........: System name Description..: The name of your system as set on the registra- tion form. This has to be an exact match, or SuperBBS will not display the 'registered' message. Options......: Name Type.........: Redirect device Description..: Device which will be used to redirect communi- cation when using, for example, the Tempdir option. The 'Gateway' driver, which is to be found on most BBS's, is perfect for this. If you don't have a gateway driver, use COMn. (n = your COM port number) The redirection will make sure that everything displayed on your local screen is also visible on the remote screen and that the remote keyboard will work as an input device. The Gateway driver will allow you the use of both the local and remote monitor and keyboard. Options......: COMn or Gateway driver Type.........: First menu in system Description..: Normally you start your system with the TOP.MNU menu. If you want your system to start with an other menu, instead of the TOP.MNU menu, you can enter the name here. SuperBBS will then start at the given menu. If left empty, Super- BBS will start at the TOP.MNU menu. Please note that the load menu option in the SBBSUSER.EXE program overrides this option. Options......: Menu name -------------------------------------------------------------- SuperBBS v1.12 documentation Page 019 Type.........: Comment answer board Description..: Message area number where all the replies on the logoff comments are stored. If you set this to 0, no replies are possible. Normally you would use your local 'general' message area for this. Options......: 0 = Not in use n = Message area number Type.........: Entry colour (0-15) Description..: Type of colour used to display the users answers in the entry fields. The entry fields will have the background colour supplied at the entry field colour option above. Do not use 0, as this would be black and the user could not read his/her answer. Available colours: 0. Black 1. Blue 2. Green 3. Cyan 4. Red 5. Purple 6. Brown 7. Grey 8. Dark grey 9. Light blue 10. Light green 11. Light cyan 12. Light red 13. Light purple 14. Yellow 15. White Remember that blue gives an underlining on monochrome Hercules monitors. Options......: Colour number Type.........: Files before checking ratio Description..: Number of files a user can download, before SuperBBS will check the file ratio in Kbytes and files. Options......: Number of files Type.........: Minimum upload space (KBytes) Description..: Minimum diskspace which has to be free before SuperBBS will let the user do an upload. If the space is not free, user's can't upload. Options......: Number of KBytes -------------------------------------------------------------- SuperBBS v1.12 documentation Page 020 Type.........: Password failure board Description..: Number of the message area where the user can leave a message if he/she forgot his/her pass- word and sends a message to the Sysop. If you set this to 0, no messages will be allowed. The user will be logged off after writing the optional message. Mostly the Sysop area is used for this type of messages. Options......: 0 = not enabled n = message area number Type.........: Maximum time in bank Description..: Maximum amount of time in minutes a user can store in the build in time bank. Options......: Number of minutes Type.........: Maximum file description lines Description..: Number of lines available when giving a file description before or after doing an upload. These files will be displayed in the Files.bbs file with a '>' in front of them when looking at the file with an ASCII editor. SuperBBS will display them at the right place, when a user views the Files.bbs list. SuperBBS now wraps the line around if the line is longer than 45 characters. It will display the wrapped text at the right location in the FILES.BBS list. Options......: Number of lines (1 to 5) Type.........: Message after page board Description..: Message area number where the messages from user's who tried to page you are stored. If a user tries to page you and you don't react, SuperBBS will ask the user if he/she would like to leave a message. Options......: 0 = not enabled n = message area number -------------------------------------------------------------- SuperBBS v1.12 documentation Page 021 2.5f General (Page 2) -------------------------------------------------------------- These options can all be toggled on or off, except for the ANSI question, which has an extra option. Press 'Y' if you want to enable an option, 'N' if you want to disable the option and 'D' at the ANSI question. Type.........: Output ^E character Description..: The ^E or ENQ character is used by some com- munications programs to determine the begin of a session. For example Telix's Salt language can react to it. Options......: Yes/No Type.........: Use direct screen writes Description..: Allows SuperBBS to write directly (=fast) to the screen, instead of using the BIOS routines. Some CGA monitors with 'snow' need this option off. Also some multitaskers prefer BIOS screen writes. Options......: Yes/No Type.........: Snow checking Description..: Allows you to check for 'snow' on your monitor. This normally only the case with old CGA moni- tors. Options......: Yes/No Type.........: Exit on Net/Echomail Description..: This option tells SuperBBS to exit with a special errorlevel if the user entered net and/or echomail messages. This allows you to run the mail processor to pack the mail. SuperBBS will exit with the following error- levels: 5 - Both net and echomail entered 4 - Only echomail entered 3 - Only netmail entered This allows you to adjust your batchfile in the correct way. Options......: Yes/No Type.........: Ask voice phone number Description..: Option to allow SuperBBS to ask the user for there voice phonenumber. The entry field has no fixed format, so both European and American phone formats can be used. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.12 documentation Page 022 Type.........: Ask data phone number Description..: Same as voice phonenumber, except SuperBBS will ask for the DATA/Business phonenumber. Options......: Yes/No Type.........: Show security in list Description..: Option to display the security levels when a user views the username list. Options......: Yes/No Type.........: Show password to Sysop Description..: If enabled, this option will show the password from the user login on to your system at the bottom of the local screen to the Sysop. This will only be visible at the Sysop side. Options......: Yes/No Type.........: Allow @ controlcharacters Description..: The special @ control characters are replaced i a message with a certain value, depending on the character used. It is possible for users who know these codes to generate messages like: Hey dude, what's ....... for a password. The ..... is then replaced by the current user's password. Although the writer of the message couldn't see the next user's password, the user still might think so. The message writer used a control character to display the current user's password. So use this option with care, not every user is as honest as you. Options......: Yes/No Type.........: Use 7bit characters Description..: SuperBBS allows the use of 7 bit characters and can convert these. If you switch this function off, no 7 bit characters can be used. Options......: Yes/No Type.........: Run system in mono mode Description..: If you're using a monochrome monitor on your system, you could set this option to 'Yes'. This only affects your side of the system, users will see all available colours when run- ning ANSI graphics. Options......: Yes/No Type.........: Clean temp dir Description..: This option enables SuperBBS to clean the tem- porary directory after the user logged off. This will prevent files being left in the tem- porary directory. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.12 documentation Page 023 Type.........: Ask ANSI at logon Description..: If you have ANSI menu's and screens available, SuperBBS can ask at logon to display the ANSI version of the logon sequence, instead of the ASCII sequence. Also available at id option is the detection of ANSI. SuperBBS will know if the user is using ANSI or not. If not, SuperBBS will display the ASCII logon, otherwise the ANSI logon is displayed. With this option it is possible to have ANSI off and still use the full-screen editor. (Which normally only works if the user has ANSI enabled.) If the user has the FS editor switched on, ANSI switched off and he/she wants to write a message, SuperBBS will use the FS editor if it detected the user has ANSI available. This will only work if you have switched this option to 'Detect'. Options......: Yes/No/Detect Type.........: Allow one word names Description..: If this option is enabled, users will only have to give one name to logon to the system. It will allow more than one name, but SuperBBS will only scan for the first part of the name. If not enabled, the user will be asked his first and last name. Names with more than 2 parts, should be separated by a period. For example: John.mike Mac.arthur. Options......: Yes/No Type.........: Sysop fast logon Description..: This option allows you, the Sysop, to logon to the BBS quickly by only giving a password. SuperBBS will presume the Sysop is the user on- line. Don't use this option if you have more than one person login on to your system locally. Options......: Yes/No Type.........: Exclude Sysop from list Description..: If you don't want your (Sysop)name to be dis- played in the lists SuperBBS generates, like last 15 callers and userlist, switch this off. Options......: Yes/No Type.........: Check for personal mail Description..: If this option is enabled, SuperBBS will scan the message base for any unread messages addressed to the user (or it's alias) and dis- play them. The user has the option to read them or to skip them. If disabled, no messages will be scanned. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.12 documentation Page 024 Type.........: Check new files description..: When enabled, SuperBBS will scan the filebase and search for any new file and display these to the user just after the mailscan at logon. Options......: Yes/No Type.........: Ask aliases Description..: SuperBBS supports a full alias system and will ask a new caller if he/she wants to use an alias or not. If you use this option, you still can deny the use of an alias in echomail areas. If you disable this option, no aliases are allowed. Even with aliases enabled, users still have to use their real name to logon to the BBS. Options......: Yes/No Type.........: Swap SuperBBS at dos shell Description..: SuperBBS has the option to swap itself to EMS memory or disk when you jump to Dos. (Alt-J). This will leave only 4 KByte of SuperBBS in the memory resident, allowing to run some other program while shelled to dos. Options......: Yes/No Type.........: Don't ask birthday Description..: SuperBBS will ask new users for their birthday when entering the system, unless this option is disabled. American users should note the way the date has to be brought in: DD.MM.YY. Here a 'No' means that SuperBBS will ask for the birthday! Option.......: Yes/No 2.5g General (Page 3) -------------------------------------------------------------- Information concerning the virusscan and Crtl-X options in pictures are on this page of the configuration program. Type.........: Use fast mailcheck Description..: SuperBBS normally scans the whole messagebase for messages unread by the user. With this option enabled, it will start at the last read pointer, making it faster, but less accurate. Some echomail processors do weird things with the lastread pointers, causing messages to be missed in the mail scan. This is not a SuperBBS problem, but a problem with the echomail pro- cessors. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.12 documentation Page 025 Type.........: Virus check enabled Description..: When a user has done an upload, SuperBBS has the ability to scan the file for known viruses. It does this with the aid of McAfee's program SCAN. The viruscheck will be performed right after the user has done the upload. SuperBBS will perform this check in the directory spec- ified at the work path part of the Config.exe program. You will need the following programs (all trademarks of their respective companies) when using this option: - PKZIP.EXE - PKUNZIP.EXE - PKARC.EXE - PKXARC.EXE - LHA.EXE - PAK.EXE - ARJ.EXE - SCAN.EXE These files have to be in a directory which is available through the path statement. Files containing a virus will be deleted and the user will get a warning message. Options......: Yes/No Type.........: Enable WatchCD at extract/pack Description..: SuperBBS can watch the carrier while files are extracted and repacked during a virusscan. If a user disconnect during the archive operations, SuperBBS will continue and then, when finished, will bring the system back to it's starting position, ready to accept callers. Options......: Yes/No Type.........: Enable Crtl-X at pictures Description..: SuperBBS allows you to run external programs from a textfiles. You will have to set the commandline in the file as follows: <Ctrl-X>Myprog.exe *F *L| When a user displays the textfile, SuperBBS will notice the Ctrl-X and executes the program behind it. The pipe symbol means ENTER. If you don't use Ctrl-X codes, leave this option dis- abled. Options......: Yes/No -------------------------------------------------------------- SuperBBS v1.12 documentation Page 026 Type.........: Enable alias search at logon Description..: It is now possible to logon with your alias name if the Sysop enables this option. You will still be asked for a password. Options......: Yes/No Type.........: Convert 8bit to 7bit in echo areas Description..: Using 8bit characters is not allowed in echo- mail. SuperBBS can translate these characters into 7bit characters. Options......: Yes/No Type.........: Swap SBBS when packing/extracting Description..: Swap part of SuperBBS to EMS or disk when pack- ing or extracting files. Options......: Yes/No 2.5h Restrictions -------------------------------------------------------------- Here you specify the Bps rates needed to logon to the system, time of the day downloading and paging the Sysop is permitted and 300 Bps usage. Type.........: Min. Bps rate to logon Description..: This will prevent users with a Bps rate lower than the one specified to gain access to your system. Options......: Bps rate Type.........: Min. Bps rate for ANSI Description..: Minimum Bps rate a user must have, before he/she can use the ANSI menus and textfiles. Options......: Bps rate Type.........: Min. Bps rate for files Description..: Minimum Bps rate a user must have before he/she can transfer files. Options......: Bps rate Type.........: Min. Bps rate for Full Screen chat Description..: Minimum Bps rate of a user to be able to use the full screen chat. Options......: Bps rate Type.........: 300 Baud usage time Description..: SuperBBS allows you to keep 300 Bps users from your system at certain hours. A message will be displayed if the user is too slow for the BBS. Options......: Start and end time -------------------------------------------------------------- SuperBBS v1.12 documentation Page 027 Type.........: Downloading time Description..: Time period in which file transfers are allowed. A message will be displayed if a user tries to do a file transfer outside these hours. Options......: Start and end time Type.........: Sysop paging time Description..: Time period in which it is possible to page the Sysop. If a user pages outside these hours, a message will be displayed. Options......: Start and end time 2.5i Colour config -------------------------------------------------------------- This part of the configuration allows you to change the col- ours used within SuperBBS. (There are two pages available.) Your users will be able to change them personally, but this option allows you to set the 'Standard' colours. You will be presented with a view of the current colours. Press the number corresponding with the number you want to change and use the cursor control keys to change the colour. The following keys are active in these menus: [ESC] Exits and saves the current colour settings. [D] Sets colours to default values. [0-9] Available options keys. [Cursor] Change colour. The user can set the colours to his/her own liking with the available menu option. These settings are however your 'standard' settings for all users. 2.5j Alt Fkeys -------------------------------------------------------------- From within the SuperBBS program, you have access to 10 programmable keys, Alt-F1 to Alt-F10, for your own programs. These keys are only available to the local system, a remote user can not access the Alt FKeys. An example: Alt-F1: C:\SUPERBBS\SBBSUSER.EXE *S The *S tells SuperBBS to swap itself out to EMS or disk, before executing the requested program. All ten keys are available for your own use. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 028 2.5k String configuration -------------------------------------------------------------- This part of the configuration program allows you to define some of the strings used in the SuperBBS program. These strings will be shown to your users if needed. Please note that these strings are used for all languages and every user. Make sure everybody can understand them. More strings of SuperBBS can be configured through the use of the Lconfig program described later. The Lconfig program will allow you to run a multi lingual system. Type.........: Loading prompt Description..: Shown to your users at a type 7 or 15 exit from SuperBBS, when executing an external program. (See the menu part of the docs for more infor- mation about those menu options.) Options......: String Type.........: Selection menu prompt Description..: Shown to your users after displaying the index file from a selection menu. This prompt should include the following options: [ENTER] To return from the selection menu to the main BBS. [1...9] Options available. This depends on the amount of options avail- able in the selection menu. Cur- rently 9 is the maximum. The L for list is not needed, because SuperBBS will automatically display the index file after a user has viewed an available selection. For more information about the selection menu, check out the menu part of the documentation. Options......: String Type.........: Origin line Description..: This string will be added to every echomail message send from your system. The maximum length for this string is 80 characters, in- cluding your address defined in the netmail part of the config program and '* Origin: ' which is put in front of your origin line by SuperBBS. You are not allowed to use extended ASCII or ANSI codes in this line. It is useful to include your phone number so people know how to find you when reading messages originating from your board. Options......: String -------------------------------------------------------------- SuperBBS v1.12 documentation Page 029 2.5l Message base editor -------------------------------------------------------------- SuperBBS allows you to setup 200 different message areas. All these areas have their own security levels and flagsettings. SuperBBS even allows you to have different origin lines for every message area. (See ECHOORIG.CTL in the control file part of this documentation.) You can move around the fields through the use of the arrow keys. The [PgUp] and [PgDn] keys will skip you to the previous or next message area. [ESC] will save the settings. Type.........: Message board name Description..: Name assigned to the current message area. leave this blank if you want to skip this area. This name will appear in the change message area menu build into SuperBBS. It can also be displayed in your menus or textfiles when using menu templating. (See for more information about menus, the menu part of this documenta- tion.) Options......: Name Type.........: Type of messages Description..: SuperBBS has three different type of messages. Which to use depends on the way you want to use the message area. The available types are: 1. Standard. This type is used for local areas on your bulletin board system. 2. Netmail. This type is used for your netmail area(s). You should have defined the area number in the netmail part of the con- figuration program. User's will be asked to enter an address (fidonet style) where to send the message. 3. Echomail. This type is used for echomail messages. These are mostly public and an origin line will be appended to every message written in this type of area. Most echomail areas don't allow the use of aliases. Normally you would have 1 netmail area, a couple of local areas and some echomail areas. Options......: 1,2 or 3 -------------------------------------------------------------- SuperBBS v1.12 documentation Page 030 Type.........: Status of messages Description..: There are four different type of messages in SuperBBS available, depending on the type of message area you choose in the above option. The types are: 0. Both public & private This type of messages is normally used in your local message areas. The user will be asked if the message is private or not. private messages can only be read by the writer, the addressee and people having Sysop access level. 1. Private messages only This type is mostly used in your netmail area and the local Sysop area. All the messages will be private and can only be read by the writer, addressee and people having Sysop level. Note that private mes- sages send to other systems can be read by the Sysops where the message is passing through. 2. Public messages only This type of messages is mostly used in echomail areas, since the message can be, and need to be, read by everyone. No pri- vate messages are allowed in (Fidonet) echomail. 3. Read only messages This type of messages can be read by everyone having access, but no messages can be written and no replies are possible with this type of messages. People having Sysop level can read all private and public mail, even if this mail is not addressed to them or originating from them. Please tell your users this is the case, so they know. Options......: 0,1,2 or 3 Type.........: AKA to use (0 = primary) Description..: SuperBBS allows you to have different addresses for every mail area you have defined. (Mostly only useful on Echomail areas.) The 0 stands for the primary address, see netmail part of configuration, while 1 to 5 stands for the AKA's. This allows you to have an area for one fidonet and one for another. Options......: 0,1,2,3,4 or 5 -------------------------------------------------------------- SuperBBS v1.12 documentation Page 031 Type.........: Read security level Description..: Security level of the user needed to read mess- ages in this area. If the user doesn't have the correct level, he/she will be displayed a mess- age, stating that access has to be granted. Options......: Security level Type.........: Read flags A to D Description..: These are the flagsettings you can use to give somebody permission to read a message in this area. Options......: Flagsettings (X = On/- = Off) Type.........: Write security level Description..: Security level of the user needed to write messages in this area. If the user doesn't have the correct level, he/she will be displayed a message, stating that access has to be granted. Options......: Security level Type.........: Write flags A to D Description..: These are the flagsettings you can use to give somebody permission to write a message in this area. Options......: Flagsettings (X = On/- = Off) Type.........: Sysop security level Description..: Security level of the user needed to have the extra Sysop options available in this area. User's who have this access will be able to read, delete, edit, copy and change attributes of all messages, private or public, in this area. Options......: Security level Type.........: Sysop flags A to D Description..: These are the flagsettings you can use to give somebody permission to sysop level in this area. Options......: Flagsettings (X = On/- = Off) Type.........: Are aliases allowed Description..: This option allows you to give users the option to use their alias in the 'From' field of the message. Please note that most echomail areas don't allow the use of an alias. Options......: No alias/Ask alias/Force alias -------------------------------------------------------------- SuperBBS v1.12 documentation Page 032 Type.........: Use in combined mode Description..: Will the message area be available from the combined board. This special message area, number 0, displays all available messages to the user in numerical order and not separated by area. (See the menu part of the docs for a more detailed description.) Options......: Yes/No Type.........: Default combined board Description..: If you want this message area to be in the combined board by default, switch this option on. Note that the user can still deselect the area. Options......: Yes/No All these options have to be set for every message area you want to use. You can change the settings at any time. If you want to delete a message area, just delete the area name. SuperBBS will not show the area as long as the area name is blank. 2.5m Event editor -------------------------------------------------------------- SuperBBS allows you to setup 30 events, which will be executed at the set time and weekday(s). this allows you to run main- tenance, clean up actions and other activities at quiet moments. You have to setup SuperBBS with a batchfile and errorlevels if you want to use this option. Otherwise SuperBBS will exit at the given time and weekday, but will never return. Moving around the fields with the cursor keys. [PgUp] and [PgDn] will switch between the events. Type.........: Status (O = Off/1 = On) Description..: Controls wether the event is active or not. The 1 means active, the 0 means inactive. Options......: 0 or 1 Type.........: Runtime Description..: Time the event has to be executed in 24 hours format. Options......: Time -------------------------------------------------------------- SuperBBS v1.12 documentation Page 033 Type.........: Errorlevel Description..: Errorlevel SuperBBS exits with at the time of the event. This allows you to start an external program from your batchfile. Do not use error- levels between 0 and 10, because these have special meanings for SuperBBS. Consult your DOS manual if you are unfamiliar with the use of errorlevels. Errorlevels may range from 0 to 255. Options......: Errorlevel Type.........: Forced Description..: If an event is scheduled, but a user is on-line at the given time, the event will be overdue and not be executed. When you force an event to be executed, SuperBBS will reduce the time of the caller online, so he/she is logged of just before the event starts. A warning message will be displayed to the user, telling him/her the time is adjusted. SuperBBS will not allow callers online within five minutes before the event. Options......: Yes/No Type.........: Days to run the event Description..: This tells SuperBBS on what day(s) the event has to be executed. (Sunday to Saturday). mark the days you want to run the event with 'X'. Options......: X 2.5n Filearea editor -------------------------------------------------------------- SuperBBS uses a file called FLSEARCH.BBS to store it's file areas in. This file is edited through the file area editor. Please note that this file is not plain ASCII, like the QuickBBS file FLSEARCH.CTL. When you start the file area editor, the program will look for the FLSEARCH.CTL file. If this file is found, SuperBBS will ask you if you want to convert this file to the FLSEARCH.BBS file. (All information not given in the .CTL file is replaced by 0's or all Bps rates.) You don't need a FLSEARCH.CTL file to start the editor! But if you are converting from QuickBBS, it makes life easier. When you are in the editor's main screen, you'll see one open window. Here you choose the file area to edit and insert and delete file areas. The following keys are active: [RETURN] Edit the area marked by the inverse bar. [INSERT] Add a new area to the file area list. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 034 [DELETE] Remove an area from the file area list. [CURSOR] Move around the file area list. [F1] Converts FLSEARCH.CTL to FLSEARCH.BBS. [ESC] Return to main configuration menu. When you choose a file area, a second window will open, dis- playing the options available per file area. You can move around with the cursor keys and pressing [ESC] will return you to the main window. Type.........: Name Description..: The name you want to give to the area and which will be displayed at a newfiles scan and if you do an area change through the build in menu command. Options......: Area name Type.........: Directory Description..: The dos directory path to your directory. This is the place where the files are, so people can download them. The backlash at the end of the pathname is optional. Options......: Drive:\Pathname Type.........: List name Description..: Drive, directory AND filename of the FILES.BBS file for this file area. This option is only needed if you use a CD-Rom drive and want your FILES.BBS in another directory, because a CD- Rom is read only. If you leave this space blank, SuperBBS will look for the FILES.BBS list in the directory given in the directory option above. Options......: Drive:\Pathname\Filename.ext Type.........: Security Description..: The security level needed to access files in this area. Options......: Userlevel Type.........: Age Description..: The lowest age needed to access this file area. this option only works if you have the birthday option in config.exe enabled. Options......: Age -------------------------------------------------------------- SuperBBS v1.12 documentation Page 035 Type.........: Flags A to D Description..: Flagsetting needed to gain access to the file area and available files. (X = On/- = Off) Options......: X Type.........: Template Description..: SuperBBS allows the use of menu templating. This means you can have one menu for all avail- able file areas. (See the part of the documen- tation on menus.) If you don't want the file area to be part of the menu templating, disable this option. Options......: Yes/No Type.........: Downloads Description..: Option to disable downloads from the area. If set to 'No', no downloads are possible from this area. Options......: Yes/No Type.........: Uploads Description..: Option to disable uploads to the area. if set to 'No', no uploads are possible to this area. Options......: Yes/No Type.........: Virus check Description..: SuperBBS can scan uploaded files for viruses. if you don't want files to be checked in the file area, disable this option. Options......: Yes/No Type.........: Dupe check Description..: SuperBBS will check all file areas for dupes when a user wants to upload a file. This could take a long time when you have a CD-Rom player attached to your system. This option allows you to disable this dupe check for the area. Options......: Yes/No Pressing [ESC] will save the information. You can always change the information. Pressing [ESC] from the main window will put you back in the main configuration menu. 2.5o Limits -------------------------------------------------------------- The LIMITS.BBS file contains all information about security levels and flagsettings for all users.This file is the control centre for the time allowed online, download limits, ratio checks and call allowed per day. This file is not an ASCII file and can only be edited through the configuration program. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 036 Security levels can range from 0 to 32000, where 0 is the lowest available level and 32000 the highest. Take a little time to think about how many levels you will need and if you need any flagsettings.The flagsettings are an easy way to give somebody access to an area, while others with the same or higher level don't have access to. Remember that even the Sysop has no access if his/her flagsettings aren't right. If you enter the Limits editor, you'll be presented with a small window. Here you can add, delete and change the user- levels. The following keys are active: [ENTER] Choose the marked level for editing. [INSERT] Add a new user level. [DELETE] Remove a userlevel. [F1] Converts LIMITS.CTL to LIMITS.BBS. [ESC] Return to main configuration menu. [CURSOR] Move around the available levels. SuperBBS will search for a LIMITS.CTL file at startup of the editor and will ask you if you want to convert this file into the LIMITS.BBS file. All information not provided in the .CTL file will be filled with 0's, meaning no limit. You don't need a LIMITS.CTL file to start the editor. When choosing a level, you will be presented with a second window, where you can edit the options. SuperBBS will sort the userlevels from small to big in the main window, so don't worry if you want to insert a level somewhere. Type.........: Security level Description..: Current security level. this can not be edited in the edit window. Only in the main window can you add or delete security levels. Options......: None Type.........: Download limits per Bps rate Description..: Number of KBytes a user can download per day. The values depend on the speed. If a user exceeds this limits, he/she will see a warning. Options......: Amount in KBytes Type.........: Time limit Description..: Maximum time allowed per day. The user will see a message if his/her time is used up for the day. He/she has to wait till the next day, before he/she is granted access again. Option.......: Time in minutes -------------------------------------------------------------- SuperBBS v1.12 documentation Page 037 Type.........: Call allowed per day Description..: Besides the time limit, you can also setup a limit of calls per day. If a user calls more than the set amount, he/she will see a message and will be disconnected. Option.......: Number of calls Type.........: Download/Upload ratio in KBytes Description..: The users download/upload ratio in KBytes. This means that if a caller downloaded xx KBytes, he/she has to upload yy KBytes before another download can be performed. Options......: KBytes Type.........: Download/Upload ratio in files Description..: The users download/upload ratio in files. this means that a user who downloaded xx files has to upload a file, before he/she can download again. If you set this to 5, every user has to upload 1 file to download 5. Options......: Number of files Type.........: Description Description..: Description for the current user level. This can be used in your textfiles through the use of a control code. Options......: Name Pressing [ESC] will bring you back to the main Limits window and save the changes. Pressing [ESC] again will bring you back to the main configuration window. 2.5p Protocol editor -------------------------------------------------------------- SuperBBS supports external protocols for downloading and uploading. It is one of the first bulletin board programs to directly support Bimodem as an external protocol. There are 10 definable protocol options available. When you choose the protocol editor, you are presented with a submenu. Here you can choose between Internal and External protocols. The internal protocols can be toggled on or off, making it possible to use another Zmodem (or other internal protocol replacement) protocol. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 038 The external protocols part of the configuration is somewhat more complicated. There are several options available here: Command......: Activated Description..: Indicates if the protocol is active or not. If active it will be shown in the up/download list with menu types 32 and 33. They will also be displayed with menu type 48. Options......: Yes/No Command......: Name Description..: The name of the protocol as it will be dis- played in the up/download lists with menu types 32, 33 and 48. Options......: Protocol name Command......: Key Description..: The character which identifies the protocol in the up/download lists with menu types 32, 33 and 48. Options......: Character Command......: Batch Description..: Defines if the protocol is a batch protocol or not. This means if the protocol can download more than one file at a time. (Zmodem can for example, but Xmodem cannot.) Options......: Yes/No Command......: Protocol type Description..: Defines the type of protocol you are using. There are two options. Option one is Bimodem, which you need to use if you install bimodem. The second option is other, which you need to use for all other protocols not using the Bi- modem interface. Options......: Bimodem/Other Command......: Log style Description..: protocols have different ways of writing a logfile. To support all these logfiles, Super- BBS has the option to support three types of logfiles. These are DSZ, used by many programs, Icom, used by Bimodem, and other. Options......: DSZ/Icom/Other -------------------------------------------------------------- SuperBBS v1.12 documentation Page 039 Command......: Download command Description..: This is the most difficult one of the external protocol installation (with the upload com- mand). Here you specify how the protocol has to be called by SuperBBS. You will have to specify the protocol name and all options needed to run the protocol. See the examples later in this chapter. There are two control codes available to be used in this line: %1 = Filenames %2 = Download limits in bytes If you need to give up the filenames, you can use the %1. If the protocol also accepts the downloadlimit than you can use the %2 in the command line of the protocol. Use the complete pathname for calling the protocol. Options......: Protocol commandline Command......: Upload command Description..: Same as download command, but now for the up- load. Here are also two control codes avail- able. Please note the difference: %1 = Filename or path %2 = Download limits in bytes Use the complete pathname for calling the pro- tocol. Options......: Protocol commandline Command......: Log file name Description..: Name and path of the logfile the protocol cre- ates. Please supply a valid path. Options......: Path\Filename Command......: Control file name Description..: Name and path of the control file SuperBBS creates. This list contains the files to up- /download and should be supplied on the up- /download commandline. Options......: Path\Filename Command......: Efficiency Description..: Efficiency of the protocol in percentage. This is normally somewhere between 95 and 98 per- cent. SuperBBS uses this to calculate the amount of time needed to download the file. Options......: Percentage -------------------------------------------------------------- SuperBBS v1.12 documentation Page 040 Command......: Download control string Description..: Format of each file entry in the control file specified above for downloads. One control code is available: %1 = Filename Normally this only contains %1. Please note that this option is not used if you selected the Bimodem protocol type. Options......: %1 Command......: Upload control string Description..: Format of each file entry in the control file specified above for uploads. One control char- acter is available: %1 = Filename Please note this option is not used when you selected a Bimodem protocol type. Options......: %1 Command......: Download logfile keyword Description..: Keyword which will be used in the logfile to note the download. Please note this option is only used if the logstyle type is set to Other. This option is not used when you selected the Bimodem protocol type. Options......: String Command......: Upload logfile keyword Description..: Same as for the download, except now for up- loads. The same exception rules apply. Options......: String Command......: File name word number Description..: Please note this option is only used when you select a logfile type as other. This option is not used in the Bimodem protocol type. Options......: Number With these options it is possible to setup 10 external proto- cols. The internal protocols can all be toggled on or off. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 041 Here is an example of a Bimodem v1.24 installation. Please note that not all options need to be set on the commandstring line with this protocol. Most settings can be configured in the Bimodem configuration file. Activated...........: Yes Name................: Bimodem Key.................: B Batch...............: Yes Protocol type.......: Bimodem Log style...........: Icom Download command....: c:\prot\bimodem.com /S%2 /T*T /D @c:\files.txt /F Upload command......: c:\prot\bimodem.com /S%2 /T*T /F Log file name.......: c:\bbs\icom.log Control file name...: c:\files.txt Effic...............: 96 Other options are left empty, because they are not used. Here's an example of an Puma setup: Activated...........: Yes Name................: Puma Key.................: P Batch...............: Yes Protocol type.......: Other Log style...........: DSZ Download command....: c:\prot\puma.exe S @c:\files.txt Upload command......: c:\prot\puma.exe R %1 Log file name.......: c:\bbs\dsz.log Control file name...: c:\files.txt Effic...............: 98 Download cntrl str..: %1 Upload cntrl str....: %1 Download log keyw...: Upload log keyw.....: File name word nr...: 0 This should help you get on your way. Refer to the SuperBBS echomail areas if you have trouble setting up a protocol. These areas can be found on most registered SuperBBS systems. The Bimodem protocol is only available with the normal download menu option. Other external protocols are available also at the download of the BBSList and Hot-key download command. You don't want your user's to start an upload while downloading the BBSList file, do you? -------------------------------------------------------------- SuperBBS v1.12 documentation Page 042 2.6 Environment variable -------------------------------------------------------------- As of version 1.10, SuperBBS needs an environment variable SBBS. This variable needs to be set before starting SuperBBS. Your AUTOEXEC.BAT or SuperBBS batchfile is a good place for it. Setting the variable works like this: SET SBBS=Drive:\Pathname The drive and directory should point to your main SuperBBS directory, where the BBS.EXE file is stored. If you don't know how to make an AUTOEXEC.BAT file, consult your DOS manual. If you get an error like: 'Out of environment space', you will have to enlarge the environment size in your CONFIG.SYS file. See your DOS manual for more information. Setting this variable is needed for single and multi line. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 043 Chapter 3. Language support ============================================================== 3.1 General information -------------------------------------------------------------- SuperBBS supports the use of many different language files, so you can setup menus and supporting textfiles in your own language or several different ones. The language support is done through the use of the .LNG files. These files are edited with the LCONFIG.EXE program. You can setup different menu and textfiles directories for every language file in use. This way you are able to have all files and menus in the languages you choose to use. Let's have a look at an example: English: Menu path: c:\sbbs\menu-uk Text path: c:\sbbs\text-uk Dutch: Menu path: c:\sbbs\menu-nl Text path: c:\sbbs\text-nl If a user chooses the dutch language file, SuperBBS will look in the directory specified in the dutch .LNG file, i.e. c:\sbbs\text-nl and c:\sbbs\menu-nl for the text and menu files. All systemfiles are in the directory defined in the main configuration program, described in chapter 2. Even if you are using 1 language file, you still have to tell SuperBBS where to look for it's files. The description is shown to users who login for the first time, or want to change their language used. If SuperBBS can't find the specified file in the directory given in the .LNG files, it will look in the directory spec- ified with the SBBS variable. This way you don't need separate language files for every line you run. 3.2 Lconfig.exe -------------------------------------------------------------- You can start the language configuration program in two ways. The normal way is to start the program without any parameters, but you can also enter the filename of the file you want to edit as a parameter. For example: LCONFIG.EXE <Xmit> or LCONGIF.EXE ENGLISH.LNG <Xmit> The second option will load the language file ENGLISH.LNG at startup. The first option will ask you for the file you want to edit. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 044 When you start the LCONFIG program, you will be presented with the following menu: 0. Path & description A. Other strings (Page 3) 1. Logon strings (Page 1) B. Status strings 2. Logon strings (Page 2) C. Month strings 3. MsgBase strings (Page 1) D. Weekday names 4. MsgBase strings (Page 2) 5. Msg reading command keys 6. FileBase strings (Page 1) 7. FileBase strings (Page 2) 8. Other strings (Page 1) 9. Other strings (Page 2) Description : Menu path : Text path : Date format : Input date format : Time format : <ESC> to exit Moving around the configuration program is done through the cursor keys. Pressing [ESC] will save the changes and exits the program or, when editing a page, return you to the main configuration menu. Take note of the fact if their is a question mark behind the question or not. Some questions will have a (Y/n)? or (N/y)? option automatically put behind it. 3.2a Path & description -------------------------------------------------------------- Here you specify where the language menu and textfiles are stored. Also it is now possible to change the way SuperBBS uses the date and time. You can adjust the time and date the way they are used in your own country or even different for each language you use. Type.........: Description Description..: Name given to the language file. Displayed to new users at logon and users who want to change their language. Example......: English -------------------------------------------------------------- SuperBBS v1.12 documentation Page 045 Type.........: Menu path Description..: Directory where SuperBBS will look for the menu files belonging to this language file. You can have more than one language file pointing to the same menu directory. The backlash at the end is optional. Example......: c:\superbbs\menu-uk Type.........: Text path Description..: Directory where SuperBBS will look for the text files belonging to this language file. You can have more than one language file pointing to the same directory. The backlash is optional. Example......: c:\superbbs\text-uk Type.........: Date format Description..: Specifies the way SuperBBS uses the date in it's fields. Here are some examples: dd-mmm-yy becomes : 31-Jan-91 mm-dd-yy 01-31-91 dd-MM-yy 31-1-91 If the settings are in capitals, the 0 will be replaced with a space. Example......: dd-mm-yy Type.........: Input date format Description..: Specifies the way SuperBBS uses the date in it's input fields. Please note the difference with the previous option. This one is only for input fields. You can't use the dd-mmm-yy for- mat in this field. Note that when you change this field, you should also change the string asking for the birthday and any other date, like new files check. Example......: mm-dd-yy Type.........: Time format Description..: Specifies the way SuperBBS uses it time format. Here's an example: hh:mm te becomes: 03:03 pm hh:mm 15:03 If characters are in capitals, the 0 will be replaced by a space. Example......: hh:mm -------------------------------------------------------------- SuperBBS v1.12 documentation Page 046 3.2b Logon strings (Page 1) -------------------------------------------------------------- These are strings shown to the user when entering the system. Type.........: ANSI logon question Description..: Asked at the moment SuperBBS detects a carrier. Only works when the option in the main con- figuration program is activated. Example......: Display ANSI login Type.........: Name question Description..: Shown to user when SuperBBS asks for the users name at logon. Example......: Enter your first and last name : Type.........: Name entered string Description..: Shown to the user if his/her name was not found in the userlist and SuperBBS asks if the name is correct. Example......: Name entered : Type.........: Correct question Description..: Shown when SuperBBS asks if the name is cor- rectly written. Example......: Is this correct Type.........: Alias question Description..: Shown when SuperBBS asks for an alias. Example......: Choose your alias to use : Type.........: Use alias question Description..: Shown to the user when he/she pressed [Enter] at the alias question. Example......: Do you want to use an alias Type.........: City question Description..: Shown to the new user when SuperBBS asks for the city and state the user is from. Example......: Where are you calling from (City & State) ? Type.........: ANSI question Description..: Shown to the new user when SuperBBS asks the user if he/she wants ANSI graphics. Example......: Would you like ANSI colour graphics Type.........: Mailcheck question Description..: Shown to the new user when SuperBBS asks if the user wants a mail check at every logon. Example......: Would you like a mailcheck at every logon -------------------------------------------------------------- SuperBBS v1.12 documentation Page 047 Type.........: Newfiles question Description..: Shown to new users when SuperBBS asks if the user wants a new files check at every logon. Example......: Would you like a new files check at every logon Type.........: Editor question Description..: Shown to the new user when SuperBBS asks if the user wants to use the fullscreen editor. This question is only asked if the user answered 'YES' to the ANSI question. Example......: Do you like to use the full-screen editor Type.........: Screen length question Description..: Shown to the new user when SuperBBS asks the user what screenlength he/she want. this defaults to 24 lines per page. Example......: How many lines per screen page (12 - 60) ? Type.........: Birthday question Description..: Shown to the new user when SuperBBS asks for the users birthday. Example......: Your birthday (DD.MM.YY) ? Type.........: More question Description..: Shown to the new user when SuperBBS asks the user if he/she wants the 'More (Y/n)?' prompt or not. Example......: Would you like to pause after each page Type.........: Screen clears question Description..: Shown to the new user when SuperBBS asks the user if he/she wants the screen to be cleared if the CLS code is send. Example......: Do you want the screen to be cleared Type.........: Home phone number Description..: Shown to the new user when SuperBBS asks the user for his/her voice telephone number. Example......: Please enter your VOICE phone number : Type.........: Data phone number Description..: Shown to the new user when SuperBBS asks the user for his/her data telephone number. Example......: Please enter your DATA phone number : -------------------------------------------------------------- SuperBBS v1.12 documentation Page 048 3.2c Logon strings (Page 2) -------------------------------------------------------------- Type.........: New password question Description..: Shown to the user when SuperBBS asks the user for the password the user wants to use on the BBS. Example......: Enter the password to use : Type.........: Password check question Description..: Shown to the user when SuperBBS asks the user for the password to be re-entered. Example......: Re-enter your password : Type.........: All OK question Description..: Shown to the user when SuperBBS asks the user if he/she entered all questions correctly. Example......: Did you enter all information correctly Type.........: Password question Description..: Shown to the user when he/she has to enter the password to gain access to the BBS. Example......: Password : Type.........: Mail check message 1 Description..: Shown to the user when SuperBBS is scanning for mail for the user. Example......: Checking for new mail addressed to you.... Type.........: Mail check message 2 Description..: Show to the user when no messages are found for the user. Example......: Sorry, no new messages found Type.........: Mail check message 3 Description..: Shown to the user when messages are found for the user. Example......: Read messages now Type.........: Password failure message Description..: Shown to the user when he/she entered a wrong password for three times and SuperBBS asks if he/she wants to leave a message. Example......: Do you want to leave a message for the Sysop Type.........: Full screen reader Description..: Shown to the new user when SuperBBS asks the user if he/she wants to use the full-screen reader. Example......: Do you want to use the full screen reader -------------------------------------------------------------- SuperBBS v1.12 documentation Page 049 Type.........: Sex question Description..: Shown to the user when SuperBBS asks if the user is a male or female. Example......: Your sex <F>emale or <M>ale ? Type.........: Female character Description..: Character used in the Sex question for the Female. Example......: F Type.........: Male character Description..: Character used in the Sex question for the Male. Example......: M 3.2d Message base strings (Page 1) -------------------------------------------------------------- Strings used in the message base part of the SuperBBS program. Type.........: Board information string 1 Description..: String shown to user when reading or viewing messages. This string gives information about the active messages and the area name. The control codes Ctrl-KC (= active messages) and Ctrl-K5 (= name message board) can be used. Example......: Active message board: ^KC (^K5 act. messages) Type.........: Board information string 2 Description..: Shown to the user when reading or viewing mess- ages. This string gives information about the message numbers in the area. The control codes Ctrl-KD (= lowest message number) and Ctrl-KE (= highest message number) can be used. Example......: System has messages numbered ^KD to ^KE. Type.........: Pause question Description..: Shown to the user when SuperBBS asks the user if he/she wants to pause after each message. Example......: Pause after each message Type.........: Delete confirmation Description..: Shown to the user when SuperBBS asks the user if he/she really wants to delete the message. Example......: Are you sure Type.........: End of replies Description..: Shown to the user when there are no more replies to be read. Example......: End of replies -------------------------------------------------------------- SuperBBS v1.12 documentation Page 050 Type.........: End of messages Description..: Shown to the user when there are no more mess- ages to be read in the area. Example......: End of messages Type.........: Private question Description..: Shown to the user when SuperBBS asks him/her if the message is private or not. Example......: Private message Type.........: Use of alias question Description..: Shown to the user when SuperBBS asks the user if he/she wants to use his/her alias to write the question. Example......: Do you want to use an alias Type.........: Message abort string Description..: Shown to the user when the message is aborted. Example......: Message aborted ... Type.........: Jump number question Description..: Shown to the user when SuperBBS asks the user to which question he/she wants to jump. Example......: Enter message number to jump to : Type.........: Invalid number string Description..: Shown to the user when he/she entered a message number which did not exist. Example......: Invalid message number Type.........: Choose area string Description..: Shown to the user when SuperBBS asks the user to choose a message area. Example......: Choose message area : Type.........: Message to ALL string Description..: Shown to the user when he/she needs to enter the name for whom the message is for telling what to type if the message is to all. Example......: Enter 'ALL' if message is to everyone Type.........: Who to question Description..: Shown to the user when SuperBBS wants to know who the message is for. Example......: Who is the message to : Type.........: Subject question Description..: Shown to the user when SuperBBS wants to know what the subject of the message is. Example......: Subject: -------------------------------------------------------------- SuperBBS v1.12 documentation Page 051 Type.........: Alias in message question Description..: Shown to user when he/she wants to use an alias in the message, but is not using one. Example......: Choose alias to use: Type.........: Start number question Description..: Shown to the user when he/she has to enter the number of the message where SuperBBS has to start displaying. Example......: Enter number to start : Type.........: Name not found Description..: Shown to the user when the user entered a name which is not in the userfile. Example......: Name not in userfile Type.........: No security Description..: Shown to the user when he/she has no rights, set in the messagebase part of the configur- ation, for writing in the area. Example......: You don't have write access 3.2e Message base strings (Page 2) -------------------------------------------------------------- Type.........: New messages Description..: Shown to the user when he/she searches for unread mail in the mail areas. Example......: Following areas have unread mail : Type.........: No new messages Description..: Shown to the user when there are no new mess- ages at an unread message scan. Example......: No unread messages found in any area ... Type.........: How many latest Description..: Shown to the user when he/she wants to read messages and SuperBBS asks how many the user wants to read. Example......: How many messages do you want to read ? Type.........: New string Description..: Shown to the user when there are unread mess- ages found at the mail scan of unread mail. The %1 string is replaced with the number of mess- ages. Example......: %1 new messages -------------------------------------------------------------- SuperBBS v1.12 documentation Page 052 Type.........: To you Description..: Shown to the user when there are personal unread messages found during the mail scan for unread mail. The %1 is replaced by the number of messages. This string is shown behind the previous string. If there are no personal mess- ages, this string is not shown. Example......: , %1 to you Type.........: Private string Description..: Shown to the user when a message is private. This string is shown in the header of the mess- age. Example......: private Type.........: Public string Description..: Same as previous string, except for public messages. Example......: public Type.........: Received string 1 Description..: Shown in the header of a message when the mess- age is received. Example......: Received Type.........: Received string 2 Description..: Shown in the header of a message when the mess- age is received. This string is followed by the date of the message it was received on. Example......: Received on Type.........: Kill/sent Description..: Shown in the header of a netmail message if this message has the kill/sent flag set. Example......: Kill/sent Type.........: Crash Description..: Shown in the header of a netmail message if this message has the crash flag set. Example......: Crash Type.........: Files Description..: Shown in the header of a netmail message if the file attach flag has been set for the message. Example......: Files Type.........: Sent Description..: Shown in the header of a netmail message if the message has the sent flag set. Example......: Sent -------------------------------------------------------------- SuperBBS v1.12 documentation Page 053 Type.........: Date field Description..: Shown in the header of the message to the user in front of the date of the message. Example......: Date : Type.........: From field Description..: Shown in the header of the message to the user in front of the name of the writer of the mess- age. Example......: From : Type.........: To field Description..: Shown to the user in front of the name of the receiver of the message. Example......: To : Type.........: Subject field Description..: Shown in the header of a message to the user indicating the subject of the message. Example......: Subj : Type.........: 1st line Description..: Shown in the header of the message, stating the message number and time and date of the writing of the message. Three control codes are used here: %1 Message number %2 Date of the message %3 Time of the message This is an indication of how old a message is. Example......: Message #%1 on %2 %3 3.2f Message base strings (Page 3) -------------------------------------------------------------- The following strings are used while reading messages on the system. They are the commands shown to the user at the end of a message. It is now possible to define these strings as you like. To tell SuperBBS which character is the command charac- ter, i.e. the key to activate the command, use the @ sign. The character behind this sign will be placed between brackets, to tell the user what the activate key is. Here's an example: ne@Xt message will be displayed as: ne<X>t message Take care you are not using the same character twice or more as an activate key! It is advised to keep the activate charac- ter the same as in the normal english commands, like R for reply and D for delete, although you could change the command word. Please note this is an advise, your free to do other- wise. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 054 Type.........: Next reply Description..: Command for reading the next message in the reply chain. Only shown when there is a reply chain. Example......: @+ Next reply Type.........: Previous reply Description..: Command for reading the previous message in the reply chain. Only shown when there is a reply chain. Example......: @- Previous reply Type.........: Quit reading replies Description..: Command to quit the reading of replies. Example......: @Quit reading replies Type.........: Again string Description..: Command to show the message again. Example......: @Again Type.........: Next string Description..: Command for next message. Example......: @Next Type.........: Back string Description..: Command to show previous message. Example......: @Back Type.........: Jump string Description..: Command to jump to a certain message number. Example......: @Jump Type.........: Reply string Description..: Command for replying to the just read message. Example......: @Reply Type.........: Write string Description..: Command for writing a new message in the cur- rent area. Example......: @Write Type.........: Delete string Description..: Command for deleting the just read message. Example......: @Delete Type.........: Keep string Description..: Command to keep a message unread. Example......: @Keep unread Type.........: Copy string Description..: Command for copying a message. Example......: @Copy -------------------------------------------------------------- SuperBBS v1.12 documentation Page 055 Type.........: Export string Description..: Command for exporting a message (to a printer or file). Example......: @Xport Type.........: Edit string Description..: Command for editing the current message. Example......: @Edit Type.........: Toggle private string Description..: Command to make a message private if public or public if private. Example......: @= Pvt/Public Type.........: Update user string Description..: Command for updating a user. Example......: @Update Type.........: Stop string Description..: Command to stop reading messages. Example......: @Stop Please note that only those commands are shown to the User/Sysop which he/she has access to. 3.2g File area strings (Page 1) -------------------------------------------------------------- Strings shown to the user when he/she is in the file base part of the bulletin board. Type.........: File mask question Description..: Shown to the user just before SuperBBS displays the Files.bbs list. Here the user can enter a search pattern to look for. Example......: Enter filemask (ENTER = ALL) : Type.........: Batch download question Description..: Shown to the user when SuperBBS asks the user what he/she wants to download. Example......: Enter files to download (Wildcards valid) : Type.........: Filename question Description..: Shown to the user when SuperBBS wants to know the filename. Example......: Enter filename : Type.........: String search question Description..: Shown to the user when SuperBBS wants to know what string to look for. Example......: Enter string to look for in listings : -------------------------------------------------------------- SuperBBS v1.12 documentation Page 056 Type.........: Name search question Description..: Shown to the user when SuperBBS wants to know what filename to look for. Example......: Enter filename to search for (Wildcards valid): Type.........: New file search question Description..: Shown to the user when SuperBBS asks the user the date to search from when scanning for new files. Example......: Enter date to search from (mm/dd/yy) ? Type.........: Area change question Description..: Shown to the user when he/she wants to change from a file area to another. Example......: Choose file area : Type.........: Pack files question Description..: Shown to the user when SuperBBS asks the user which files need to be packed from the 'temp' directory option. Example......: Enter file names to pack (ENTER = STOP): Type.........: Delete files question Description..: Shown to the user when SuperBBS asks the user which files need to be deleted from the temp directory. Example......: Enter files to delete : Type.........: Not found string Description..: Shown to the user when a file is not found. Example......: File not found !! Type.........: No upload string Description..: Shown to the user when uploads are not allowed in the file area. Example......: No uploads allowed to this area Type.........: No download string Example......: Shown to the user when downloads are not allowed in the file area. Example......: No downloads allowed from this area Type.........: Files to upload question Description..: Shown to the user when SuperBBS asks the user what he/she wants to upload. Example......: Enter filenames to upload (ENTER = STOP) : Type.........: Before transfer question Description..: Shown to the user before the transfer is started. the user can press 'ENTER', which will start the transfer, press '!' to logoff after the transfer or press 'A' to abort. Example......: [ENTER] = start, [!] = logoff, [A] = abort -------------------------------------------------------------- SuperBBS v1.12 documentation Page 057 Type.........: Start transfer Description..: Shown to the user when SuperBBS starts the transfer. Ctrl-X can interrupt the transfer. Example......: Start transfer. Press Ctrl-X to interrupt Type.........: File exist Description..: Shown to the user when a file already exist in the file base. %1 will be replaced by the filename. Example......: File %1 is already here ! Type.........: Virus in file Description..: Shown to the user when a virus is detected in the uploaded file. %1 will be replaced by the filename. Example......: File %1 contains a virus ! Type.........: Not received Description..: Shown to the user when a file was expected, but not received. %1 will be replaced by the filename. Example......: File %1 was expected but not received ! 3.2h File area strings (Page 2) -------------------------------------------------------------- Type.........: Please describe Description..: Shown to the user when he/she has to describe the file uploaded to the BBS. This is the first information string shown. Example......: Please enter a description for your upload : Type.........: "/" = private file Description..: Shown to the user telling him/her that a '/' in front of the description will make the file private to the Sysop. Example......: (Begin description with '/' if Sysop file) Type.........: Please describe 1 Description..: Shown to the user when the user has to enter the first line of the file description. %1 will be replaced by the filename. Example......: Please describe %1 Type.........: Please describe 2 Description..: Shown to the user when he/she needs to enter the second to fifth line of the description. Example......: Press Enter to stop Type.........: Description to short Description..: Shown to the user when he/she has entered a too short file description. Example......: Description must be at least 4 characters -------------------------------------------------------------- SuperBBS v1.12 documentation Page 058 Type.........: File is unwanted Description..: Shown to the user if he/she is planning to send a file which the Sysop doesn't want. (See the FILES.CTL part in the control file section of the docs.) %1 will be replaced by the filename. Example......: The file %1 is not wanted ! Type.........: Files received Description..: Shown to the user when the files are received. %1 will be replaced by the number of files received. Example......: %1 files received. Type.........: Files sent Description..: Shown to the user when the files have been sent. %1 will be replaced by the number of files. Example......: %1 files sent. Type.........: No files found Description..: Shown to the user when SuperBBS can't find any files to send. Example......: No files found Type.........: Not enough time Description..: Shown to the user when he/she doesn't have enough time to download the file. Example......: You don't have enough time left Type.........: Password question 1 Description..: Shown to the user when he/she tries to download a file which is password protected. (See the FILES.CTL part of the documentation.) %1 is replaced by the filename. Example......: The file %1 is password protected ! Type.........: Password question 2 Description..: Shown to the user when he/she has to enter the password for the file. Example......: Enter password : Type.........: Select area string Description..: Shown to the user at the top of the screen if he/she is using the pick area change command. Example......: Select file area with cursor keys: Type.........: Select area info Description..: Shown at the bottom of the area pick screen, telling the user what to do when changing file areas. Example......: [ENTER]...Choice [A]...Choose area by number -------------------------------------------------------------- SuperBBS v1.12 documentation Page 059 Type.........: Virus check question Description..: Shown to the user when he/she wants to check a file for viruses. Example......: Enter files to be checked : 3.2i Other strings (page 1) -------------------------------------------------------------- Strings which can be found all over SuperBBS are defined here. Type.........: Press Enter string Description..: Shown to the user when he/she has to press ENTER to continue. Example......: Press [ENTER] to continue ... Type.........: Press S or P string Description..: Shown to the user when he/she can press S or P to stop or pause a listing. Example......: Press S to Stop or P to Pause listing Type.........: Please wait string Description..: Shown to the user when he/she has to wait, because SuperBBS is working. Example......: Please wait a moment ... Type.........: Yes character Description..: Character used in SuperBBS to represent the 'Yes' character. Example......: Y Type.........: No character Description..: Character used in SuperBBS to represent the 'No' character. Example......: N Type.........: Chat reason question Description..: Shown to the user when SuperBBS asks the user for the reason to chat. Example......: Reason for chat : Type.........: Chat start string 1 Description..: Shown to the user when the Sysop entered the chat with the user. this is the first line. Example......: Sysop chat mode entered ... Type.........: Chat start string 2 Description..: Second string shown to the user when the Sysop entered chat mode. Ctrl-FW can be used to dis- play the user's first name. Example......: Hello ^FW, this is your Sysop. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 060 Type.........: Chat info string Description..: Shown at the bottom of the full-screen chat screen. Example......: [^R] Redraw screen [^W] to clear your screen Type.........: Chat end string Description..: Shown to users when the chat is over. Example......: Sysop chat mode ended ... Type.........: Dos shell string 1 Description..: Shown to the user when the Sysop jumps to Dos level with Alt-J. Example......: Sysop has shelled to Dos, please wait ... Type.........: Dos shell string 2 Description..: Shown to the user when the Sysop returned from the jump to Dos. Example......: Sysop has returned from Dos. Thanks for waiting Type.........: Update string 1 Description..: Shown to the user when the Sysop is updating the user information. Example......: Sysop is updating you information ... Type.........: Update string 2 Description..: Shown to the user when the Sysop finished up- dating the user information. Example......: Sysop has done it ... The following strings are used when the user asks for the time statistics. (See menu options). Type.........: Current time string Description..: Shown when SuperBBS shows the user the time. The %1 will be replaced by the current time. Example......: Current time : %1 Type.........: Current date string Description..: Shown to the user when SuperBBS tells the user the date. The %1 will be replaced by the date. Example......: Current date : %1 Type.........: Connect time string Description..: Shown to the user when SuperBBS displays the time the user can be connected. The %1 will be replaced by the minutes, the %2 by the seconds. Example......: Connect time : %1 min %2 sec. Type.........: Time used string Description..: Shown when SuperBBS tells the user how much time he/she has been online. Example......: Time used : %1 min %2 sec. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 061 Type.........: Time left string Description..: Shown to tell the user how much time he/she has left over this call. Example......: Time left : %1 min. Type.........: Call limit string Description..: Shown to the user to tell the call limit. Example......: Call limit : %1 min. 3.2j Other strings (Page 2) -------------------------------------------------------------- Type.........: Bad phone number string Description..: Shown to the user when he/she entered a wrong telephone number. Example......: You have to enter a full telephone number ! Type.........: Password not changed Description..: Shown to the user when his/her password is not changed. Example......: Password not changed. Type.........: Ask current password Description..: Shown to the user when he/she wants to change the password and has to enter the current pass- word. Example......: Please enter your CURRENT password : Type.........: Current alias string Description..: Shown to the user when SuperBBS displays the user's current alias. Example......: your current alias is : Type.........: Combined string 1 Description..: Shown to the user when he/she wants to toggle areas on/off for the combined message board. This strings tells the user what to do. Example......: Enter board numbers to toggle on/off Type.........: Combined string 2 Description..: Shown to the user when he/she wants to toggle areas on/off for the combined message board. This string tells the user the commands to use at the toggle menu. Example......: ON=All On OFF=All Off T=Toggle D=Default Type.........: Search user question Description..: Shown to the user when the user wants to search the userlist and SuperBBS asks for part of the name. Example......: Enter part of username to search for : -------------------------------------------------------------- SuperBBS v1.12 documentation Page 062 Type.........: Search alias question Description..: Shown to the user when the user wants to search the alias userlist and SuperBBS asks for part of the alias name. Example......: Enter part of alias or username to search for : Type.........: More question Description..: Shown to the user when the maximum screen length is reached and the user has to state if he wants to continue or not. Example......: More <Y>es or <N>o ? Type.........: More Yes character Description..: Character used in the More? question as the Yes character. Example......: Y Type.........: More No character Description..: Character used in the More? question as the No character. Example......: N Type.........: 20 sec to inactivity Description..: Shown to the user 20 seconds before SuperBBS disconnects, if the user is inactive. Example......: * Warning : Only 20 seconds to hangup ! Type.........: Inactivity string Description..: Shown to the user at the moment SuperBBS dis- connects, because the user was inactive. Example......: User inactive, hanging up ... Type.........: Two minutes warning Description..: Shown to the user by SuperBBS when he/she has only 2 minutes left. Example......: * Warning : Only 2 minutes time left ! Type.........: Time exceeded string Description..: Shown to the user when SuperBBS disconnects because the user's time limit is exceeded. Example......: Time limit exceeded. Call back tomorrow ... Type.........: Yes string Description..: String used within SuperBBS for the Yes string. Example......: Yes Type.........: No string Description..: String used within SuperBBS for the No string. Example......: No -------------------------------------------------------------- SuperBBS v1.12 documentation Page 063 Type.........: Alias list top string Description..: String shown at the top of the alias list. This tells the user which row the alias is and which row the real name. Please note the location carefully. Example......: Name Alias 3.2k Other strings (Page 3) -------------------------------------------------------------- Type.........: Alias in use string Description..: Shown to the user if he/she selected an alias which is already in use. Example......: That's already in use, choose again ! Type.........: Invalid screen length Description..: Shown to the user when the user selected a wrong screen length. (Not between 12 and 60 lines.) Example......: Invalid screenlength entered ! Type.........: Password short string Description..: Shown to the user if a password is entered which is to short. (Min. 4 characters.) Example......: Password is to short. Try again ! Type.........: Password check failed Description..: Shown to the user when he/she entered his/her old password and it didn't match the real pass- word when changing passwords. Example......: Passwords do not match. Type.........: Password changed string Description..: Shown to the user when the password change was successful. Example......: Password changed successfully Type.........: Wrong string Description..: Shown to the user when entering a wrong pass- word. Example......: Wrong !! Type.........: Ask line number string Description..: Shown to the user when he/she has to enter a line number. Example......: Enter line number : Type.........: Minutes in bank Description..: Shown to the user when SuperBBS shows the amount of minutes the user has deposit in the timebank. Ctrl-K7 can be used to display the amount in minutes. Example......: You have ^K7 minutes in the bank -------------------------------------------------------------- SuperBBS v1.12 documentation Page 064 Type.........: Time left string Description..: Shown to the user stating how much time the user has left. Ctrl-KO can be used to display the amount of time left. Example......: You have ^KO minutes left Type.........: Deposit ? Description..: Shown to the user when he/she wants to deposit time in the bank. Example......: How much time do you want to deposit ? Type.........: Withdraw ? Description..: Shown to the user when he/she wants to withdraw time from the bank. Example......: How much time do you want to withdraw ? Type.........: You can deposit Description..: Shown to the user when SuperBBS tells the user how much time he/she can deposit. %1 is replaced by the maximum number of minutes the user can deposit. Example......: You can deposit %1 minutes. Type.........: Next user comment Description..: Shown to the user when he/she wants to enter a comment for the next user. Example......: Enter your comment for next user .... Type.........: Save comment ? Description..: Shown when the user needs to save the comment. Example......: Save comment Type.........: Message after page Description..: Shown to the user after an unsuccessful page attempt and before the user can enter a message to the Sysop. Example......: Would you like to leave a message 3.2l Status string configuration -------------------------------------------------------------- These strings are shown when the user toggles some setting on or off and when SuperBBS displays the settings. Type.........: "On" string Description..: The string to represent the word 'ON'. Example......: ON Type.........: "Off" string Description..: The string to represent the word 'OFF'. Example......: OFF -------------------------------------------------------------- SuperBBS v1.12 documentation Page 065 Type.........: Screen clear status Description..: String to tell the user the status of the screen clear command. The %1 will be replaced by the ON or OFF string. (See above). Example......: Screen clears are now %1 Type.........: More status Description..: String to tell the status of the more prompt. Example......: More prompts are now %1 Type.........: Ansi status Description..: String to tell the status of ANSI graphics. Example......: Ansi graphics are now %1 Type.........: Ansi editor status Description..: String to tell the status of the full screen ANSI editor. Example......: Full screen ANSI editor is now %1 Type.........: Mail check status Description..: String to tell the status of the mail check at logon. Example......: Mail check at logon is now %1 Type.........: New files status Description..: String to tell the status of the new files check at logon. Example......: New files check at logon is now %1 Type.........: Disturb mode status Description..: String to tell the status of the 'Do not disturb' flag. Example......: Do not disturb mode is now %1 Type.........: Full screen viewer status Description..: String to tell the status of the full screen message viewer. Example......: Full screen message viewer is now %1 The following strings are used in conjunction with the Sysop availability option in SuperBBS. (Num-lock On/Off). Type.........: Available string Description..: String to represent the word 'Available'. Example......: Available Type.........: Unavailable string Description..: String to represent the word 'Unavailable'. Example......: Unavailable -------------------------------------------------------------- SuperBBS v1.12 documentation Page 066 3.2m Month names -------------------------------------------------------------- Here you can define the abbreviations for the twelve month. These will be used if SuperBBS has to display the month. Don't use more than 3 characters for the abbreviations. You can also use the numerical code for the month, i.e. Jan = 01, Feb = 02, Mar = 03 etc. 3.2n Weekday names -------------------------------------------------------------- Here you can define the weekday names. Both a long and short version is used. The long version is the full name, the short version is the abbreviation. 3.3 Control codes in strings -------------------------------------------------------------- SuperBBS allows the use of control codes in the strings which you define in Lconfig. These strings can be display different colours or it is even possible to display an ANSI/ASCII file. Colours are brought into the strings with the Ctrl-C and then the colour code. These are the colour numbers: 0. Black 1. Blue 2. Green 3. Cyan 4. Red 5. Purple 6. Brown 7. Grey 8. Dark grey 9. Light blue 10. Light green 11. Light cyan 12. Light red 13. Light purple 14. Yellow 15. White When you want to insert a control code in a string, you first have to press Ctrl-P to tell SuperBBS you are entering a control code. Here's an example: The file ^C14 %1 ^C3 is not wanted ! Enter the string first, then move to the place where you want to insert the colour code. Press Crtl-P, Crtl-C and 14. this will make the text behind it yellow. Repeat the sequence if you want another colour in a different spot. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 067 If you want to make the prompts appearing after a piece of text in the same colour as the last used colour, use this command: Ctrl-C !. This will return the colour of the last used text display. This could be used to set the 'More Y/N prompt in the same colour as the displayed text before it. All control codes, as described later in this manual, can be used in the strings. Just press Ctrl-P first, before entering the code. Another powerful option is the possibility of displaying an ANSI/ASCII file instead of the string. This can be achieved through the use of the Ctrl-A code and the filename to dis- play. Here's an example for the string used for the not wanted files: <^A>UNWANTED This will display the ANSI/ASCII file UNWANTED when a file is not wanted. The file has to be in the text directory specified in the configuration. Don't forget to press Ctrl-P before entering the Ctrl-A code. 3.4 Language.ctl file -------------------------------------------------------------- You will need to make a file called LANGUAGE.CTL. This file is the control file for the languages available. This file is a plain ASCII file with the following format: <Language filename> <Language filename> <Language filename> the first language will be the language SuperBBS starts in. This means that any string shown to the user before he/she entered his/her name is from this language file. Until a caller entered his/her name, SuperBBS doesn't know which language the user is using. When a new user calls to your BBS, some textfiles will be shown to him/her before SuperBBS will ask which language they want. These files are: - NOTFOUND.A?? - NEWUSER1.A?? See for more information about these files the textfile part of this documentation. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 068 3.5 Hints and tips -------------------------------------------------------------- If you have problems understanding what all the strings are for in the language configuration program, use the following method of making a language file: - Copy the supplied ENGLISH.LNG file to your own name. - Start Lconfig with the new .LNG name. - Edit the strings. You will know what the original looks like and you'll be able to see where the special characters are used. (Characters like : and ?) - Exit the program after you're ready. this way it is easy to write a new language file in any lan- guage you like. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 069 Chapter 4. Converting from other software ============================================================== 4.1 General information -------------------------------------------------------------- SuperBBS is a QuickBBS based bulletin board system. Converting from other software to SuperBBS is simple, as long as you use a program also based on QuicKBBS. Otherwise a complete revision of your menus and textfiles may be needed. For users of the RemoteAccess software is a special conversion program available. 4.2 Converting from QuickBBS, Proboard or RemoteAccess -------------------------------------------------------------- When converting to SuperBBS from QuickBBS or RemoteAccess, your userfile, messagebase and most systemfiles can be used by SuperBBS. There are some different menu options and some controlcodes are not the same. SuperBBS can store it's mes- sagebase anywhere you want, which is not available in QuickBBS. If you do run into serious trouble converting from QuickBBS or RemoteAccess to SuperBBS, contact one of our Support nodes or the SuperBBS HQ. You will need to run USERFIX.EXE on your userfile. This pro- gram will scan your userfile so it won't have trouble with the 7/8 bits characters used in Scandinavian countries. SuperBBS fully supports these characters. Put the USERFIX.EXE file in the same directory as your USERS.BBS file is and run the program. 4.3 Converting from other software -------------------------------------------------------------- Converting from other software than QuickBBS, Prodoor and RemoteAccess is more difficult. Mostly your userbase is not compatible and the same is for your messagebase. The SuperBBS structures are available, if you need to write conversion programs. Most Support boards have these structures available. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 070 Chapter 5. Menus ============================================================== 5.1 General information -------------------------------------------------------------- Just like QuickBBS and RemoteAccess is SuperBBS using a menu system that requires to be build up from scratch. (Although an easy installation program with some simple menus is included.) You will have to setup all menus and external screens. Super- BBS does include it's own menu program, which has all options available. It also supports 'unknown' menu options, so you can always use it. At this moment it is the only menu editor which supports the multi language options in SuperBBS. Any other menu program for QuickBBS is usable, as long as it supports 'unlisted' menu types, since SuperBBS has more menu options than QuickBBS has. There are several ways to setup a menu system for your BBS. The most used one looks like this: -------------------- Message menus | Main menu ------------------------- File menus | -------------------- Other menus Another method is to set up your menus by item: Main menu ------------------------- SuperBBS file & message | |------------------- Modem file & message | -------------------- Graphics file & message Either way, plan your menu structure carefully. Users like a menu structure which is easy to follow. Building a menu can be done in two ways. You can either build the whole menu with the menu editor, so text is displayed if needed, or you can start your menu with an ANSI/ASCII display option (with Hot-key) which will display the menu and have all the commands in the menu file. Both have advantages and disad- vantages. Using an ANSI/ASCII file as menu gives you the advantages that you can use more colours on one line, use graphics and even animation. Disadvantage is that all menu options will be visible to all callers, whatever securitylevel they have. You need to setup a display file option with a Crtl-A code, which means the command will be executed automatically. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 071 Using the normal menu has the advantages that you can hide several options from other security levels. Disadvantage is the limited use of colour per line. It will be up to you which way you choose. Be sure to check your menu files at every securitylevel you have set up. Strange things can happen if you make mistakes. Building a menu is simple, building a complex menu with many different options for different securitylevels is more diffi- cult. Take your time is a good advice. When building a menu, you will need to enter the following information: Text to display Text shown to user for this menu option. (Leave this empty if you use an ANSI/ASCII file to display the menu.) This line should contain a description and the char- acter to activate it. Optional data Optional data needed for the given menu type command. (See the menu commands.) Menu type Number of the menu type. (These will be listed below with a full description and the optional data needed.) Security Securitylevel needed to access this menu option. Key Key which activates this menu option. This can be any character on the keyboard. Foreground Colour in which the foreground of the text to display will appear. (Options: 0-15) Background Colour in which the background of the text to display will appear. (Options: 0-7) Flags A-D Flagsettings needed to access this menu option. Two special options are: Highlight colour The highlight colour is a colour which can be displayed on the text to display line through using a '^' in front and behind the text you want 'highlighted'. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 072 An example: Foreground colour: 2 Background colour: 0 Highlight colour...: 14 Text: This is a ^test^ for a menu. Result: This is a test for a menu. The word 'test' will appear in yellow, the rest of the line in dark green. Note that the special characters are not shown when displaying a menu. Prompt Line displayed below the menu options, prompting the user for an action. This line can have a different colour. Note that the supplied SuperBBS menu editor works a bit diffe- rent. See the external utilities part of the documentation for information on the SuperBBS menu editor. These descriptions can differ from menu program to menu pro- gram, but the main idea stays the same. Use a menu editor which has an option for 'unknown' commands, since SuperBBS is expanding faster than the menu editors are, so you will be able to use the editor in the future. 5.2 Menu commands -------------------------------------------------------------- Now for the available menu commands. SuperBBS is pretty power- ful and has a lot of features, so read carefully. Make sure you take note of any optional data needed to set up a menu option. Without this data the menu option will not work or behave strangely. Used characters in the optional data fields: None = means no optional data needed xxxxxxx = means the data entered here is mandatory. <xxxxx> = means the data entered here is optional. The menu commands: Type.........: 0 Description..: Text line Display's the text you've entered in the menu editor for this command. No other action takes place. Optional data: None -------------------------------------------------------------- SuperBBS v1.12 documentation Page 073 Type.........: 1 Description..: Goto a new menu. Will change the menu to the menu set up in the optional data field. Optional data: MenuName </F> </M> <Password> If you want to protect your menu with a pass- word, enter it behind the menu name, separated with a space. Enter the menu name without the .MNU extension. See for the /F and /M the part in this documentation about 'menu templating'. Type.........: 2 Description..: Gosub to a new menu. Same as option 1, with the difference that the previous menu (the menu you left from) will be added to the stack of menus you've visited. This way you can follow the trail back through your menus. Optional data: MenuName </F> </M> <Password> The same as for menu type 1. Type.........: 3 Description..: Return from last gosub. Return to the menu you last visited. This option only works if you use the type 2 menu option to get to a menu. Optional data: None You don't have to enter any menu name, since the stack contains the name of the menu visited last. This name is erased after the return, so you can use menu type 3 again to return to the before last used menu. Type.........: 4 Description..: Goto new menu and clear gosub stack Clears the gosub stack used with menu options 2 and 3. Then goes to the given menu in the optional data field. Optional data: MenuName </F> </M> <Password> The same as for menu type 1 Type.........: 5 Description..: Display .ANS/.ASC file Display a textfile from the textfile directory setup in CONFIG.EXE and LCONFIG.EXE. SuperBBS first looks in the current language text direc- tory. If not found, SuperBBS will look in the directory specified in CONFIG.EXE. If a user has ANSI on, SuperBBS will first look for an ANS file, then for an ASC file. If the user has ANSI off, SuperBBS only looks for the ASC file. Optional data: FileName The filename to be displayed, without extension. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 074 Type.........: 6 Description..: Selection menu Display a textfile which has up to 9 options available of other text files and display the Selection menu prompt, as set up in the CONFIG.EXE program. You will need to name all files the same, except for the last number. Suppose your main file is called BULLET.ANS then your other files will be called BULLET1.ANS to BULLET9.ANS. (If you have 9 files.) The main file is shown to the user. The user selects from the list displayed in the main file, which file he/she wants to read. If the user selects 3, the file BULLET3.ANS (or ASC) will be displayed. If the user selects 5, the file BULLET5.ANS will be displayed. After viewing the file, the user will be shown the main file again. Optional data: FileName This filename can be 7 characters or less. (Character 8 is reserved for the other textfile numbers.) The extension is always ANS or ASC and the files should be in your textfiles directory. Type.........: 7 Description..: Shell to DOS and run program This option is used for starting other pro- grams, like doorgames and mailscanners, in SuperBBS. It shells to DOS and starts the pro- gram given in the optional data field. SuperBBS will return to the menu the exit started from. Optional data: ProgramName <Parameters> This menu is one of the difficult menu options available, because of the large amount of para- meters. These are the parameters available: *B Caller's bps rate. This will be 0 if local, or 300 to 38400 if on-line. *C Full path to your COMMAND.COM file as set in the environment variable COMSPEC. (Con- sult your DOS manual for more information about COMSPEC.) This parameter is needed if you want to start a batchfile from this type 7 menu command. *E Read EXITINFO.BBS when returning to BBS. This can be handy if the program used with the type 7 exit, changes some of the user's data, like a timebank. *F User's firstname. *G Status of ANSI graphics. (0=Off, 1=On) -------------------------------------------------------------- SuperBBS v1.12 documentation Page 075 *H Leave the Fossil driver (X00 or compatible) hot when exiting from SuperBBS. Some programs require this. (Most don't.) *I Path of current language file. *L User's lastname. *N Gives current node number. *P Gives current COM port number. *R User's recordnumber in the user database. *S Swap SuperBBS to EMS or disk. If you run a program which needs more memory than the normal amount available, specify the *S option, so SuperBBS will swap itself to EMS or, if EMS is not available, to disk. *T Time left this call. *U Path to current template file area. (See menu templating.) Mostly you just use the *C and *S parameters. With multi-node operations, you will need the *N and *P options. Normally the documentation from the program you wish to run will supply the needed information. Type.........: 8 Description..: Version and copyright notice This option will show the user the version- number, copyright message and if your program is registered, the registration name of the SuperBBS version you're using. Optional data: None Type.........: 9 Description..: Logoff from the system This will disconnect the user from your system. Before disconnect, SuperBBS will show the user the GOODBYE.ANS (or ASC) file, if available. Optional data: None Type.........: 10 Description..: Display System Usage graph Show the user the system usage graph. This gives you the percentile use per hour. Optional data: None -------------------------------------------------------------- SuperBBS v1.12 documentation Page 076 Type.........: 11 Description..: Page the Sys(tem)Op(erator) for a chat See if the Sysop is available to talk to you. SuperBBS will ask the user for a reason for the chat. If the Sysop is not available, this rea- son will be stored in the SYSTEM.LOG file. Optional data: Prompt Enter the string, which will be shown to users who try to yell you. Type.........: 12 Description..: Execute questionnaire file Execute the given questionnaire, for example NEWUSER.Q-A. The answers will be written in the same file name as the questionnaire, but the extension will be changed to .ASW. Optional data: FileName Extension of a cessionaire must be .Q-A or SuperBBS will not recognize the questionnaire. Answers will be written in the .ASW file. Type.........: 13 Description..: List/search user list Gives the option to search for a name in the userlist or display the whole list. Optional data: None, /S or /L If you specify no optional data, the list will contain no security levels. With the /S the securitylevels will be shown to the user. The /L option only shows the users with the same or lower security level. Type.........: 14 Description..: Time statistics Shows the user how long he/she has been on-line and how much time is left. Also gives the cur- rent date and time. Optional data: None Type.........: 15 Description..: Exits to DOS with errorlevel Leaves SuperBBS and returns to the batchfile which you ran SuperBBS from. There you inter- cept the given errorlevel and start an external action. (For more information about error- levels, consult your DOS manual and see the batch examples in the appendixes of this man- ual.) If possible you should use a type 7 exit, instead of this type 15. Use the *S (and *E) when using a type 7. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 077 Optional data: Errorlevel <MenuName> The errorlevel will start the action required from your batchfile. (Don't use errorlevel below 10.) The optional MenuName tells SuperBBS to which menu it should return after ending the type 15 exit. You should restart the SuperBBS program with the -R option. (See Command Line Parameters.) Type.........: 16 Description..: Change City & State Allows the user to change his/her City and State. Optional data: None Type.........: 17 Description..: Change password Allows the user to change his/her Password. Optional data: None Type.........: 18 Description..: Change screenlength Allows the user to change his/her screenlength. Optional data: None Type.........: 19 Description..: Toggle screen clearing on/off Allows the user to toggle the sending of screen clear codes (CLS) on and off. Optional data: None Type.........: 20 Description..: Toggle the 'More (Y/n)' prompt on/off Allows the user to toggle the more prompt on and off. Optional data: None Type.........: 21 Description..: Toggle ANSI graphics on/off Allows the user to toggle the ANSI graphics on and off. Optional data: None Type.........: 22 Description..: Scan for personal mail This option will scan the userbase and report any unread personal mail. Optional data: None -------------------------------------------------------------- SuperBBS v1.12 documentation Page 078 Type.........: 23 Description..: Read messages Allows the user to read messages in the current message area. If a message is private, it will be skipped if it is not from you or to you. Optional data: AreaNumber or /M Area number of the message base the messages should be read from. (If you use menu templa- ting, this can also be the templating command /M.) Type.........: 24 Description..: Scan messages Gives a list of messages with the header infor- mation (who from, who to and subject) and gives you the option to mark messages for later read- ing. Optional data: Areanumber or /M Area number of the message base the messages should be scanned from. Type.........: 25 Description..: Quick scan messages Gives a list like display of all messages in the area with information about the sender, receiver and subject. Optional data: AreaNumber or /M Area number of the message base the messages should be scanned from. Type.........: 26 Description..: Delete messages Removes messages from the message base. This only works for messages from you or to you. (Unless you have Sysop access to this area.) Optional data: AreaNumber or /M Area number of the message base the messages should be deleted from. Type.........: 27 Description..: Write a message Allows the user to write a message. Optional data: AreaNumber or /M </L> </T=First_Lastname> Area number of the message base to write the message in or the menu templating command /M. The /L will log the user off your system after saving the message (with displaying the file GOODBYE.A??). The /T=First_Lastname will send the message to the name given. Spaces should be set with the underscore character. The /L and /T option only works correct if you use an area number and NOT the /M command. You could use -------------------------------------------------------------- SuperBBS v1.12 documentation Page 079 the /L and /T parameters for sending a message to the Sysop at logoff. If you leave this field blank, SuperBBS will use this menu option as an global write option and will ask the user in which area he/she wants to write the message. Type.........: 28 Description..: Select combined message areas Area 0 is a special message area. You can't write a message in this area, but you can read messages from all areas connected in numerical order. This option allows the user to select the areas he/she wants to use in his/her com- bined board. You can select standard areas or exclude areas from the combined board in the CONFIG.EXE program, the Message base part. Optional data: None Type.........: 29 Description..: Move a file Normally spoken an option only available to the Sysop. It will allow you to move a file from one area to another. It also moves the descrip- tion in the FILES.BBS file. Optional data: FullPath or /F You need to give the full directory path from where the file will be moved or the /F if you use menu templating. Type.........: 30 Description..: MS-Dos directory Like a normal DIR command, will SuperBBS dis- play the given directory. Optional data: FullPath or /F Give the full directory path or the /F. Type.........: 31 Description..: List FILES.BBS The normal way to show a user what's available in the given directory. It will show the filename, date, size and description. For CD- Rom users is an option build in to have the FILES.BBS file in a different location then the files itself are. See the CONFIG.EXE program, the File area editor. Optional data: FullPath or /F Supply the directory or the /F command. CD-Rom users should use the /F command. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 080 Type.........: 32 Description..: Download a file This option will send a file from the BBS to the user. Optional data: None <FullPath> </F> <PassWord> If you leave the optional data field empty, SuperBBS will use this command as a global download command. It will search in every area the user has access to, trying to find the requested file. Use the full path or the /F option and SuperBBS will only look in the cur- rent area. The FullPath and /F option allow the use of a password, which need to be given before the download will be started. Please note that the <*> option is no longer supported. This is replaced with an option in the FILES.CTL file. Please delete the * from your optional data fields, otherwise SuperBBS will ask for a password before downloading. Type.........: 33 Description..: Upload a file This option will receive a file which the user sends to the BBS. Optional data: FullPath or /F Supply the full directory or the /F option. By using the full directory command, it is poss- ible to receive all uploads in one directory. The /F will place the file in the current area. Type.........: 34 Description..: View an archived file Shows what the archive file contains. It sup- ports ZIP, LZH, PAK and ARC files. Optional data: FullPath or /F Supply the full directory path or the /F option. Type.........: 35 Description..: Search for file by Keyword Look for a word in the FILES.BBS files. Optional data: None Type.........: 36 Description..: Search for file by Filename Look for a file in the FILES.BBS files. Wild- cards are allowed as search options. Optional data: None -------------------------------------------------------------- SuperBBS v1.12 documentation Page 081 Type.........: 37 Description..: List new files on system Shows the new files since the last login or the given date. Optional data: None Type.........: 38 Description..: Type a textfile Allows the users to read a textfile on-line from your FILES.BBS list. (If there is a text- file in there.) Optional data: FullPath or /F Supply full directory path or the /F option. Type.........: 39 Description..: Display a textfile Show the user a textfile. This option is like menu option 5, except you have to supply the fullpath and filename. This allows you to show any file you want. No 'Press Return' is given at the end of the file. Optional data: Fullpath+FileName Supply the full path and filename to the text- file. Including the extension! Type.........: 40 Description..: Display ANS/ASC file with Hotkey Show the user an ANSI or ASCI file, but keep the hot keys active. This can be used to dis- play a menu file. If you use this command to show the file, the user doesn't have to wait till the whole screen is drawn, but can make his choice at once. With a type 5 menu, the hot keys are not active during the display of the file. This command is mostly used in combina- tion with a Crtl-A command in your menu. (Crtl- A = Automatic execution) Optional data: FileName Supply the filename to be shown. Don't give an extension, as SuperBBS will always look for a ANS or ASC extension. The file has to be in the textfile directory. Type.........: 41 Description..: Toggle Full Screen editor on/off If you have a full screen editor installed, like Quicked, you can allow your users to toggle the editor on and off with this option. If it is off, the build in editor will be used. Optional data: None Type.........: 42 Description..: RESERVED - Do not use -------------------------------------------------------------- SuperBBS v1.12 documentation Page 082 Type.........: 43 Description..: RESERVED - Do not use Type.........: 44 Description..: RESERVED - Do not use Type.........: 45 Description..: Display ANS/ASC file with 'Press ENTER' The same as menu type 5, except that SuperBBS will put a 'Press ENTER to continue' prompt after it showed the file. This will pause the screen till a reaction from the user is received. Optional data: FileName or fullpath and filename Supply the filename, without extension. The file has to be in the textfile directory. If you supply the filename and path, you can dis- play any file and have the 'Press Enter' at the end. Type.........: 46 Description..: Show GIF pictures resolution Show the resolution of the GIF picture (only of if it is stored on you disk as a .GIF file), which name is supplied by the user. This option doesn't look in archives! Optional data: FullPath or /F Supply the full directory path or use the /F option. Type.........: 47 Description..: Write entry to System log Write the text, given in the optional data field, to the SYSTEM.LOG file. This is handy if you want to know if a menu option is used or for any other information. Optional data: Text to be written The text given in this field will be written to the system logfile. Type.........: 48 Description..: Download a specific file By using this option, you only ask the user which download protocol he/she wants to use and then starts the download. You supplied the filename in the optional data field. This can be used to download your ALLFILES list. Optional data: FullPath+FileName Supply the file the users can download through the use of this option. Type.........: 49 Description..: RESERVED - Do not use -------------------------------------------------------------- SuperBBS v1.12 documentation Page 083 Type.........: 50 Description..: RESERVED - Do not use Type.........: 51 Description..: RESERVED - Do not use Type.........: 52 Description..: RESERVED - Do not use Type.........: 53 Description..: Toggle mailcheck at logon on/off Allows the user to toggle the mailcheck at logon on and off. Optional data: None Type.........: 54 Description..: Toggle newfiles check at logon on/off Allows the user to toggle the newfiles check at logon on or off. Optional data: None Type.........: 55 Description..: Show BBS list (Short) Shows the user the build in BBS list in the short version. Optional data: None Type.........: 56 Description..: Add BBS to BBS list Allows Sysops to add their BBS to your BBS list. Information like telephone number, name, on-line hours, software and Sysop name are stored. Optional data: None Type.........: 57 Description..: Leave comment to next user A comment of 2 lines can be left behind for the next user. This will be shown to the next caller at logon. The user will not be logged off after entering the comment. Optional data: None Type.........: 58 Description..: Show callers Gives a list of the last 15 callers with the time they came on-line and went off-line. Also shown are bps rates and age. Optional data: None or /T If no optional data is specified the list will display the last 15 callers of all available lines. With the /T option, the list will con- tain all callers since midnight. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 084 Please note that the filename for this option has changed. The file used is now called SCALLERS.BBS and the old file SLCALLER.BBS is no longer used and can be deleted. Type.........: 59 Description..: Change colour configuration Allows the user to change the colour configur- ation of the BBS. This is the same as in the CONFIG.EXE program, but only works for the current user, while the CONFIG.EXE part, works for every user. Optional data: None Type.........: 60 Description..: Extract files Allows the user to extract a file, then after- wards he/she can view the files inside the archive and repack (some) files. All from with- in SuperBBS. Optional data: None <FullPath> </F> If you leave the optional data line empty, it means extract the file which is IN the TEMP directory. This TEMP directory is setup in the CONFIG.EXE program. If you enter the full directory path or the /F, for menu templating, this menu type will react as extract TO the TEMP directory. Note the difference! Type.........: 61 Description..: Archive files The user will be asked which files have to be archived. This option is to be used with the extract option, menu type 60. Optional data: FullPath or /F If you enter the full directory path of the TEMP dir, the files will be packed from that area. If you use the /F or the full directory path to your file areas, the requested files from that area will be packed. Type.........: 62 Description..: Delete files The user will be asked which files have to be deleted. This option is to be used with the extract option, menu type 60. Optional data: FullPath or /F If you enter the full directory path of the TEMP dir, the files will be deleted from that area. If you use the /F or the full directory path to your file areas, the requested files from that area will be deleted. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 085 Type.........: 63 Description..: Show BBS list (Long) Show the user the long version of the BBS list. The user has the option to enter the name he/she wants to look for. All available data about the BBS will be shown. Optional data: None Type.........: 64 Description..: Change BBS information in BBS list Allows Sysops to change their BBS data in the BBS list. Only you and the person named as Sysop in the BBS list is able to do this. Optional data: None Type.........: 65 Description..: Delete BBS information from BBS list Allows Sysop to remove their data from the BBS list. Only you and the person named as Sysop in the BBS list is able to do this. Optional data: None Type.........: 66 Description..: Download BBS list Allows users to download the BBS list. Only the protocol will be asked for. Optional data: None Type.........: 67 Description..: Change user's phone number(s) Allows the user to change his/her phone num- ber(s). Optional data: None Type.........: 68 Description..: Select message area from arealist Allows the user to change area with the build in area change command. This will display a three row list of all the available (to this user) message areas. Use this for changing areas when using menu templating. Optional data: None Type.........: 69 Description..: Select file area from arealist Allows users to change area with the build in area change command. This will display a one row list of all the available (to this user) file areas. Use this for changing areas when using menu templating. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 086 Optional data: None or /P If you use the /P, the change area command will change into a pick area command for ANSI users only. The user can select an area from the list with the cursor control keys. Local users should use the cursor control keys on the numeric keyboard with NUMLOCK on. (The other cursor keys are used to change the online time). Type.........: 70 Description..: Change alias Allows the user to change his/her alias. Only works if you allowed the use of an alias on your system. Optional data: None Type.........: 71 Description..: List aliases Shows an user - alias list of all users. The user is given the option to select a search criterium. Optional data: None Type.........: 72 Description..: Show user's balance in the timebank Allows the user to see how much time he/she has deposit in the timebank. You can set a maximum in the CONFIG.EXE program. Optional data: None Type.........: 73 Description..: Deposit time in timebank Allows the user to store time in the timebank. Optional data: None Type.........: 74 Description..: Withdraw time from timebank Allows the user to withdraw time from his/her account. Optional data: None Type.........: 75 Description..: User online / Other line status Show's who is on the other line(s) or the cur- rent status of the other line(s). Optional data: None </S> If you leave the optional data field empty, SuperBBS will show the user who is on the other line(s). If you use the /S parameter, SuperBBS will show you the status of the other line(s). -------------------------------------------------------------- SuperBBS v1.12 documentation Page 087 Type.........: 76 Description..: Send message to other user on-line Allows the user on a line to send a on-line message to a user on another line. This only works if the 'Do not disturb' flag is not on. Optional data: None Type.........: 77 Description..: Change current language Allows the user to change his/her current lan- guage file. (If you run with more than one language file.) Optional data: None Type.........: 78 Description..: Toggle 'Do not disturb' on/off Allows the user to toggle the 'Do not disturb' flag on and off. This way he/she can prevent receiving messages from other line users. Optional data: None Type.........: 79 Description..: Toggle full-screen message viewer on/off Allows the user to toggle in SuperBBS the full- screen message reader on or off. Quotes are now written in a different colour when messages are viewed with the fullscreen message viewer. Optional data: None Type.........: 80 Description..: Displays mail areas with unread mail. All areas which contains mail not yet read by the user will be displayed. The menu option also tells the user how many messages are unread and if there are any personal unread messages. Optional data: None or /C The /C option works on the user selected com- bined boards (Message board 0). If you leave the optional data field empty, it works on all file areas. Type.........: 81 Description..: This menu option allows the user to scan a file for a virus infection. SuperBBS normally scans uploads for viruses (if enabled), but now the user can enter a filename of the file he/she wants to scan. You will need the known ar- chivers and the SCAN virusscanner somewhere in your path. Optional data: /F or Full path -------------------------------------------------------------- SuperBBS v1.12 documentation Page 088 That's it, all 81 available menu commands. If you are convert- ing from RemoteAccess, Prodoor or QuickBBS to SuperBBS remem- ber that there are different options available in SuperBBS, which the others do not have. Please check your configuration carefully if starting with SuperBBS. 5.3 Menu templating -------------------------------------------------------------- Maybe you remember the good old days. In those days you had to build a menu for every available message and file area. Those days are gone. Now there is menu templating. This means you have one menu for all your message areas and another for all your file areas. How does it work? First you design your menu. Then you enter all the needed information. But instead of entering messagebase numbers, you enter /M. SuperBBS will replace this with a message area number. The same for the file areas. Design your menu, enter the /F instead of the directory. SuperBBS will replace it with the information given in the CONFIG.BBS program. Let's have a look at how to setup a message menu this way: First you have to get from your main menu to the message menu. We want to start in area 01. We use menu option 1 and the optional data field would be: MAIL /M=1. MAIL is the menu name, /M=1 tells SuperBBS to go to the first message area defined in CONFIG.EXE. If you want to go to the second area, you could have said /M=2. Now we need the read, write, scan, quickscan and delete options. Set up the menu as you normally would, except instead of using the messagebase number, use the /M in the optional data field. SuperBBS will know in what area the user is. Even if the user goes to the main menu and then returns to the messagebase, he/she will still be in the area he/she left from. You can use the /M (and /F for fileareas) for changing the area. If you use a type 1 menu and as optional data field the menu name and /M=+1, SuperBBS will change to the next area. If you use in the optional data field the /M=-1, SuperBBS will change area to the previous area. This option is endless, because the user is placed back to the first area when he/she wants to go to the next area from the last area. It looks like this: ---> 1 --> 2 --> 3 --> 4 --> 5 --> 6 --> 7 --- | | ---------------------------------------------- -------------------------------------------------------------- SuperBBS v1.12 documentation Page 089 In this example is area 1 the lowest and area 7 the highest. This also works the other way around. So in short: Menu type 1 - MenuName /M=1 = Goto message area 1 Menu type 2 - MenuName /F=31 = Gosub file area 31 Menu type 23 - /M = Read messages in current area Menu type 32 - /F = Download from current area Menu type 1 - /M=+1 = Goto next message area Menu type 1 - /F=-1 = Goto previous file area To show the name and number of the area you are currently in use these codes: Ctrl-K 4 = File area name in ANS/ASC files Ctrl-K 5 = Message area name in ANS/ASC files Ctrl-K " = Number of current message template area Ctrl-K # = Number of current file template area @ (Ascii 64) = File area name in menu textline ' (Ascii 96) = Message area name in menu textline These codes are replaced with the name you have set up in the CONFIG.EXE program. If you use characters behind these codes, please think about the fact that the codes will be replaced by the area name, so you might have to check if your menu is still aligned the way you want it. Example: In your menu: Area ^K#: @ SuperBBS HQ For the user: Area 12: General area SuperBBS HQ In this example the user is in file area 12, General area. Note that the control code should be entered by holding down the Control key and pressing the K key. The # is a normal character which should be entered without the control key being pressed. 5.4 Changing hardcoded menu options -------------------------------------------------------------- SuperBBS has the option to allow the use of your own commands, instead of the hardcoded menus in SuperBBS. These options can be used for these menu commands: 23 Read messages 24 Scan messages 25 Quickscan messages -------------------------------------------------------------- SuperBBS v1.12 documentation Page 090 These are the available commands to replace the hardcoded box in SuperBBS. You need to set these options in the optional data field, when editing a menu. /F Read messages in forward order /R Read messages in reverse order /I Read individual messages /N Read new messages /S Read selected messages /M Read marked messages /O Read n number of messages These options are also available in template menus, so you're able to build a very powerful (and in your own language if needed) message menu. Here is an example of a menu. The first /M is from the message area the second '/' option is to replace the hardcoded menu. Menu Opt. data Menu textline ---- -------- ---------------------------------------------- 23 /M /F Read messages in forward order in current area 23 /M /M Read marked messages in current area 24 8 /S Read selected messages in area 8 25 /M /N Quickscan new messages in current area 27 /M Write a new message in current area 68 Choose other area from area list And your imagination can do the rest. It is just an example, so don't use it as a complete menu! 5.5 Control codes in menu and textfiles -------------------------------------------------------------- You can now use several control codes in your menu. They don't have to be displayed through an ANSI or ASCII file, but can be used on the menu textline itself. Here's a complete list of all the control codes you can use, either in an ANSI or ASCII file or in your menu textline: (^ = Ctrl key) ASCII Char. Function description --------- -------- ----------------------------------------- 1 ^A Wait for ENTER key to be pressed 2 ^B Turns OFF aborting with S key 3 ^C Turns ON aborting with S key 4 ^D Turns ON the 'More' prompt 5 ^E Turns OFF the 'More' prompt 6 ^F Not used alone (See below) 7 ^G Generates a 'BEEP' -------------------------------------------------------------- SuperBBS v1.12 documentation Page 091 ASCII Char. Function description --------- -------- ----------------------------------------- 8 ^H Backspace 9 ^I Tabulator 10 ^J Linefeed 11 ^K Not used alone (See below) 12 ^L Clears screen 13 ^M Carriage return The ^F codes available: (All codes apply to current user!) ASCII Char. Function description --------- -------- ----------------------------------------- 6 65 ^FA User's full name 6 66 ^FB User's city and state 6 67 ^FC User's password (Use with care!) 6 68 ^FD User's business/data phone number 6 69 ^FE User's home/voice phone number 6 70 ^FF User's last calling date 6 71 ^FG User's last calling time (24 hrs format) 6 72 ^FH User's A flagsetting 6 73 ^FI User's B flagsetting 6 74 ^FJ User's C flagsetting 6 75 ^FK User's D flagsetting 6 76 ^FL User's netmail credit 6 77 ^FM Number of messages user has written 6 78 ^FN Highest message number user has read 6 79 ^FO User's security level 6 80 ^FP User's number of calls 6 81 ^FQ User's uploads in files 6 82 ^FR User's uploads in KBytes 6 83 ^FS User's downloads in files 6 84 ^FT User's downloads in KBytes 6 85 ^FU Elapsed time this call in minutes 6 86 ^FV User's screen length 6 87 ^FW User's firstname 6 88 ^FX Status ANSI graphics (ON/OFF) 6 89 ^FY Status More prompt (ON/OFF) 6 90 ^FZ Status CLS codes (ON/OFF) 6 48 ^F0 User's Sysop comment 6 49 ^F1 Status Full Screen editor (ON/OFF) 6 50 ^F2 User's age 6 51 ^F3 User's birthday 6 52 ^F4 User's time of first call (24 hrs format) 6 53 ^F5 User's date of first call 6 54 ^F6 Status of mailcheck at logon (ON/OFF) 6 55 ^F7 User's up/download ratio in KBytes 6 56 ^F8 User's up/download ratio in files 6 57 ^F9 Status new files check at logon (ON/OFF) 6 33 ^F! Total minutes used 6 34 ^F" Status full screen reader -------------------------------------------------------------- SuperBBS v1.12 documentation Page 092 The ^K codes available: ASCII Char. Function description --------- -------- ----------------------------------------- 11 65 ^KA User's total number of calls 11 66 ^KB Name of the last caller 11 67 ^KC Number of active messages on system 11 68 ^KD Number of lowest message on system 11 69 ^KE Number of highest message on system 11 70 ^KF Number of times user has yelled SysOp 11 71 ^KG Day of the week in full 11 72 ^KH Number of users on system 11 73 ^KI Current time (24 hrs format) 11 74 ^KJ Current date (DD-MM-YY) 11 75 ^KK Number of minutes connected this call 11 76 ^KL Number of seconds connected this call 11 77 ^KM Number of minutes used against time limit 11 78 ^KN Number of seconds used against time limit 11 79 ^KO Number of minutes remaining this call 11 80 ^KP Number of seconds remaining this call 11 81 ^KQ Time Limit this call (Minutes) 11 82 ^KR User's baud rate (300-38400) 11 83 ^KS Abbreviated day of week 11 84 ^KT Download Limit in KBytes 11 85 ^KU Number of minutes until next system event 11 86 ^KV Time of next system event (24 hrs format) 11 89 ^KY User's maximum up/download ratio in KBytes 11 90 ^KZ User's maximum up/download ratio in files 11 48 ^K0 Current language file description 11 49 ^K1 Status of scroll lock 11 50 ^K2 One second pause 11 51 ^K3 Display securitylevel comment (LIMITS.BBS) 11 52 ^K4 Name of the current filearea 11 53 ^K5 Name of the current messagearea 11 54 ^K6 User's alias 11 55 ^K7 User's time in bank 11 56 ^K8 User's number of calls today 11 57 ^K9 Number of messages in current area 11 33 ^K! Status of do not disturb flag (ON/OFF) 11 46 ^K. Number of current node 11 34 ^K" Number of current message template area 11 35 ^K# Number of current file template area 11 37 ^K% User's download remaining today in KBytes Do not use the ^Q, ^S and ^Z commands, because these are dangerous and can give you unexpected problems. To enter a code in your textfiles, use the ^x command. This means, press the control key, hold down while pressing the mentioned key, release and press the second character (in case of the ^F and ^K keys.) Another way is holding down the ALT key and pressing the ASCII value from the numeric keypad on the right of the keyboard. This only works on EXTENDED keyboards!! -------------------------------------------------------------- SuperBBS v1.12 documentation Page 093 5.6 Additional control keys -------------------------------------------------------------- Some additional control keys can be used within the message- base from SuperBBS. These codes are: @1 User's name @2 User's City & State @3 User's security level @4 User's birthday @5 User's age @6 User's firstname These codes can be used, if you did allow them to be used in CONFIG.EXE, in messages written in SuperBBS. The following additional control keys are needed for setting up a multiline system with template menus. These codes can be used in the data fields of the menus. The codes are: @N Number of the node the user is on @M Number of current message template area @F Number of current file template area @S User's security level These codes allow you to use the temporarily areas in a multi- line system. For example, name your temporarily directories TEMP1 and TEMP2, for line 1 and 2, and specify the optional data field with TEMP@N, which will be replaced by TEMP1 or TEMP2 depending on the node the user is in. 5.7 INCLUDE1.MNU -------------------------------------------------------------- This is a very special menu file. This menu allows up to 10 commands to be entered, which then will be added to all your existing menus. If SuperBBS finds this file in your menu directory, all menu commands are available to the user at any menu in your BBS. Very useful for the logoff command, paging the Sysop, help and what you can think of. Design the menu as you normally would design a menu. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 094 Chapter 6. Message base ============================================================== 6.1 General information -------------------------------------------------------------- The SuperBBS message base is fully compatible with QuickBBS and RemoteAccess. This will not guarantee that this will stay this way in the future. Either SuperBBS or the other programs might come up with a better type of message base. Currently you can use your old messagebase when converting from RA and QuickBBS to SuperBBS. You should set up the location of your messagebase in the CONFIG.EXE program. User's (and Sysop) are able to read, write, scan, quickscan and delete messages. The messages are numbered in increasing order. The first message starts at one, the second at two and so on. This doesn't mean both messages are in the same area. Besides the message number, SuperBBS also keeps track in which area the message belongs. When reading messages, you will see a notice stating that there are xxxx messages active. And that the lowest message is numbered yyyy and the highest zzzz. Also stated is the amount of messages in the current area. It looks something like this: Active msgs: 1234. Lowest message: 1. Highest message: 23460 Number of messages in this area: 25. This means that from the 1234 messages, which starts at 1 and ends at 23460, there are 25 messages in the current area. 6.2 Sysop keys available -------------------------------------------------------------- The following options are available to the Sysop when reading messages: <A>gain Show current message again. <N>ext Show next message <B>ack Show previous message <J>ump Jump to specified message <R>eply Reply to the current message <W>rite Write a message in current area <D>elete Remove the current message <K>eep as unread Toggle the read/unread flag on/off <X>port Send message to printer or file <C>opy Copy current message to another user/board -------------------------------------------------------------- SuperBBS v1.12 documentation Page 095 <E>dit Edit the message information, like: 1. From Who wrote the message 2. To To whom message is send 3. Subject Subject of the message 4. Board Area number where msg is 5. Quit Abort editing 6. Save Save message <=>Private Toggle the private/public flag on/off <S>top Stop reading messages Use the <E>dit command and option 4 if you want to copy a message to another area. Use the <C>opy command if you want to forward a message to another user or system. One undocumented option is available to Sysops when reading ECHO and NET mail, the <!>. This allows you to see the infor- mation normally hidden in a message through a Ctrl-A code. Information like path and kludges are normally hidden behind these codes. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 096 Chapter 7. Files base ============================================================== 7.1 General information -------------------------------------------------------------- Just like SuperBBS messagebase is the filebase compatible with RemoteAccess and QuickBBS. SuperBBS uses a FILES.BBS file to display the available files to the users. This file looks like this when viewed with a normal ASCII editor: <Filename> <Description> SuperBBS will add the information like size and date if the file is found in the current area. If not, the word OFF-LINE will be displayed instead of the date and size. The descrip- tion has to start on character number 14. SuperBBS allows you to have more then one file description line. You can set this information in the CONFIG.EXE program. If you want to add a line with a text editor, use one who ends without putting a Ctrl-Z at the end of the document, start the extra description line with the ' >'(ASCII 32+62) sign. This will tell SuperBBS it is a file description line and will display it at the right place. SuperBBS now also wraps the text around if the textline is longer than 45 characters. The wrapped text will be displayed at the right indent. 7.2 Extract and view option -------------------------------------------------------------- SuperBBS allows you and your users to extract, view and repack a file while on-line. SuperBBS has support for ZIP, LZH, PAK, ARJ and ARC files. You can extract a file, view the contents of the file, read textfiles from within the file and repack only the wanted files, while discarding the rest. SuperBBS makes use for this option of the TEMP directory which you have to set up in CONFIG.EXE. After use, SuperBBS will clean the area in case the user doesn't and you have set the option on in CONFIG.EXE. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 097 Chapter 8. Support files ============================================================== 8.1 General information -------------------------------------------------------------- SuperBBS uses a whole range of extra ANSI and ASCII support files. You can define these files yourself, or use the build in (English) support files. This way you can personalize your system. If a file is not available, SuperBBS will display a message of it's own, if needed. You can make these ANSI and ASCII files with a program like Thedraw. It even allows you to use animation in your ANSI files. Do remember that users are calling in and that a long screen build up will scare them away, or they switch to ASCII. SuperBBS will first look for the files in the ANSI/ASCII textfile directory specified in the language files, then in the text directory specified in the CONFIG.EXE program and if still no file is found, it will display the message of it's own, which is normally just a textline explaining what is going on. 8.2 ANSI and ASCII Support files -------------------------------------------------------------- These are the support files: Name.........: 0001 (0102, 0203......2223, 2324) Type.........: ANS/ASC Description..: File to be displayed at logon, between 00:00 and 01:00 hrs. This way you can setup a file for every hour. 1516.ANS would be displayed between 15:00 and 16:00 hrs. Name.........: ALIASASK Type.........: ANS/ASC Description..: This file is displayed at logon of a newuser just before asking the alias he/she wants to use. This file should contain some information about the use of an alias on your board. Name.........: BIRTHDAY Type.........: ANS/ASC Description..: Shown when a user calls on his/her birthday. Name.........: DNLDHRS Type.........: ANS/ASC Description..: Shown to a user who wants to download when downloading is not allowed as specified in CONFIG.EXE. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 098 Name.........: EDITHELP Type.........: ANS/ASC Description..: Shown to the user when he/she asks for help within the message editor. Name.........: GOODBYE Type.........: ANS/ASC Description..: Shown to the user at logoff, just before the modems disconnect. Name.........: LOGO Type.........: ANS/ASC Description..: Shown to the user before asking the user's name at logon to your system. At this moment is SuperBBS not aware which language a user is using, so it uses the directory specified in the first language file in LANGUAGE.CTL. If you are using different languages, this file should contain all available languages. Name.........: MAXPAGE Type.........: ANS/ASC Description..: Shown to the user when trying to page the Sysop more times then specified in CONFIG.EXE. Name.........: NEWS Type.........: ANS/ASC Description..: File displayed to every user at logon. Useful for newsflashes. Programs like NEWS_140.xxx are easy for creating and editing this file. Name.........: NEWUSER1 Type.........: ANS/ASC Description..: Shown to newusers after he/she has verified his/her name and before the other logon ques- tions are asked. At this point does SuperBBS not know which language the user wants to use, so you should make this file contain all avail- able languages. Name.........: NEWUSER2 Type.........: ANS/ASC Description..: File displayed to a new user after he/she answered the questions about system options and selected a password, but before the NEWUSER.Q-A questionnaire is answered. Name.........: NO300 Type.........: ANS/ASC Description..: Shown to the user trying to logon to your BBS at 300 Baud when this is not allowed as you specified in the CONFIG.EXE file. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 099 Name.........: NOPAGE Type.........: ANS/ASC Description..: Shown to the user when you are paged, but you disabled yell with the Scroll-lock key. Name.........: NOTAVAIL Type.........: ANS/ASC Description..: Shown to the user when you are paged outside yelling hours. Name.........: NOTFOUND Type.........: ANS/ASC Description..: Shown to the user if the system can't find the user's name in the user list. At this moment is SuperBBS not aware of the language the user is using or want to use. This file should there- fore contain all available languages. Name.........: PAGEABRT Type.........: ANS/ASC Description..: Shown to the user when the Sysop aborts the yell from the user. Name.........: PAGED Type.........: ANS/ASC Description..: Shown to the user after a yell for the Sysop, incase the Sysop didn't answer. Name.........: PASSWORD Type.........: ANS/ASC Description..: Shown to the new user just before the system asks for a password, or just before the user has the option to change his/her password. Name.........: PRIVATE Type.........: ANS/ASC Description..: Shown to the user if your system is a private system and a non-registered user is trying to get in. The user will be disconnected after displaying the file. Name.........: RATIO Type.........: ANS/ASC Description..: Shown to the user when the upload/download file ratio is exceeded as configured in CONFIG.EXE. Name.........: RATIOK Type.........: ANS/ASC Description..: Shown to the user when the upload/download kbytes ratio is exceeded as configured in CONFIG.EXE. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 100 Name.........: READHELP Type.........: ANS/ASC Description..: Shown to the user if he/she asks for help with the read, scan and quickscan commands. Name.........: SECxxxxx Type.........: ANS/ASC Description..: Shown to the user just after the welcome screen if he/she has the security level 'xxxxx'. 'xxxxx' has to be a value between 0 and 32000. (SEC20.ANS will be shown to security level 20 user's.) If this file is not found, SuperBBS will look for a SECALL.A?? file. Name.........: SECALL Type.........: ANS/ASC Description..: Shown to the user if for his/her security level no SECxxxxx.A?? file is available. Name.........: TIMEWARN Type.........: ANS/ASC Description..: Shown to the user when his/her time is adjusted due to an upcoming event. Name.........: TOOSLOW Type.........: ANS/ASC Description..: Shown to the user when trying to logon to the system at a bps rate which is not fast enough, as configured in CONFIG.EXE. Name.........: TRASHCAN Type.........: ANS/ASC Description..: Shown to the user when his/her name was found in the TRASHCAN.CTL list. The user will be disconnected after displaying the file. Name.........: VIP Type.........: ANS/ASC Description..: Shown to the user after the welcome screen if his/her name was found in the VIP.CTL list. Name.........: WELCOME Type.........: ANS/ASC Description..: Shown to the user after he/she entered her name and password. Name.........: WELCOME1 Type.........: ANS/ASC Description..: Shown just after the welcome screen. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 101 Name.........: XFERHELP Type.........: ANS/ASC Description..: Shown to the user when the user asks for help with the transfer protocols and file transfer. 8.3 .CTL, .LNG and .BBS Support files -------------------------------------------------------------- Besides the ANSI and ASCII files, SuperBBS uses a couple of .CTL, .LNG and .BBS files to control his behaviour. The .CTL files are all plain ASCII files and can be edited with every normal texteditor, even Edlin if you like. The .BBS files are all controlled through the CONFIG.EXE program. The .LNG files are language files and are controlled through the LCONFIG.EXE program. The .BBS and .LNG files are mentioned here as refer- ence, so you know what every file is for. Their set up is explained in detail in chapter 3. Type.........: *.LNG Description..: Language support files. Type.........: AREAS.BBS Description..: Not a file needed for SuperBBS, but most echomail processors need this file, that's why we mention it. It contains information about your message areas and who to send them to. The format is as follows: <Area Nr.> <Description_of_area> <Destination> Don't use the first three lines of the file. Just put a ';' in there. This is just a plain ASCII file. Type.........: COMBINED.BBS Description..: Contains information about the user's settings for the combined message board (Area 0). There should be no reason to delete this file. Type.........: CONFIG.BBS Description..: Contains the complete setup from your system. This file should never be deleted, because you will have to setup your system again. This file is 100% QuickBBS compatible. Type.........: DORINFO1.DEF Description..: One of two files, the other is the EXITINFO.BBS file, which contains information to be used by programs running outside SuperBBS. These files are generated when you do a type 7 or 15 exit. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 102 Type.........: ECHOORIG.CTL Description..: Plain ASCII file. With this file it is possible to have a different origin line in every mail area. The format of the file is as follows: <AreaNr.> <Origin line> <AreaNr.> <Origin line> Place this file in your main system area. Type.........: EXITINFO.BBS Description..: One of two files, the other is the DORINFO1.DEF file, which contains information to be used by programs running outside SuperBBS. These files are generated when you do a type 7 or 15 exit. Type.........: FILES.CTL Description..: This file, which is a plain ASCII file, gives you control over the files in your filebase. It is possible to assign passwords to files, spec- ify unwanted files and give free files. Use this file as follows: <Filename> /FREE <Filename> /UNWANTED <Filename> /PWD=<password> You can use wildcards in the filenames. If you don't specify a directory, the option will work in all file areas. Here's an example: SBBS_111.ZIP /FREE BETA_112.ZIP /PWD=BETATEST /FREE *.GIF /UNWANTED C:\TMP\ZIP.ZIP /FREE This will make the SBBS file free, protect the free file Beta with a password, tells users .GIF files are not welcome and makes the ZIP.ZIP in the TMP directory also free. Type.........: FLSEARCH.BBS Description..: Contains all information about your file areas. Location, securitylevels, flagsettings, age to have access and if in the menu templating is stored in this file. Type.........: LASTREAD.BBS Description..: Contains information about every user and his/her lastread message number. Never delete this file, because all message will be displayed as new messages to the user's. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 103 Type.........: LIMITS.BBS Description..: Contains the information about userlevels and their limits. SuperBBS checks this file to find the information about the userlevels. Type.........: MSGIDX.BBS / MSGINFO.BBS / MSGTOIDX.BBS / MSGHDR.BBS / MSGTXT.BBS Description..: Contains the information about the messages on your system. If you want to start with a new and empty database, delete these files. Type.........: PFILES.BBS Description..: Contains information about private uploads done to you. This is a normal ASCII file. All pri- vate upload descriptions are stored in this file. Type.........: SLCALLER.BBS Description..: Contains information about the last 15 users to your BBS. You can delete this file if you want, but there should be no reason for it. Type.........: SUSERS.BBS Description..: Contains the extra user information like age, birthday, sex etc. Only delete this file if your userbase is messy and you want to clean it up. SuperBBS will ask every user for the needed information again. Type.........: TIMELOG.BBS Description..: Contains information about the usage of the BBS. The usage log is created out of this file. If you want to start all over with your usage log, delete this file. Type.........: TRASHCAN.CTL Description..: Contains user names you don't want to have on your board, like Sysop, Dr., Hacker etc. This is a plain ASCII file in the following format: <User name> <User name> <User name> Type.........: USERS.BBS Description..: Contains the information about the users. All normal user information is stored in this file. Only delete this file if you want to start with 0 user's. Backup this file often to prevent damage to your userfile if something happens. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 104 Type.........: VIP.CTL Description..: Contains information about special users to your BBS system. SuperBBS will show the file VIP.A?? to them at logon. This is a plain ASCII file with the following format: <User name> <User name> <User name> SuperBBS uses two logfiles for storing system information. One you hopefully never have to see. These files are: Type.........: ERRORS.LOG & ERRORS.BBS Description..: Contains all errors which occur during oper- ation of SuperBBS. Please take note of these files and send the information to us, when you come across an error. Send this information to our support nodes or the SuperBBS HQ. Type.........: SYSTEM.LOG Description..: Contains all information about what the user did on your system. Information like name, userlevel, alias, wrong passwords, exits to doors and time on-line are stored in here. This file is a plain ASCII file. If this file is missing, SuperBBS will create it the next time it is run, so you can delete this file as many times as you wish. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 105 Chapter 9. Questionnaire language ============================================================== 9.1 General information -------------------------------------------------------------- SuperBBS has a powerful questionnaire language available to the Sysop for designing question files. SuperBBS will run the questionnaire called NEWUSER.Q-A if a new user enters your system and the file is found. Answers will be stored under the same filename, but with the extension .ASW. All questionnaires have to have the extension .Q-A and all answer files will have the extension .ASW. You can design as many questionnaires as you like. You can run a questionnaire from a menutype 12. On the optional datafield, you have to supply the name of the questionnaire. 9.2 Available commands -------------------------------------------------------------- Here's a list of the available commands in the questionnaires: Used codes: <.......> = Mandatory [.......] = Optional Command.....: ASK <length> <variable> [default] Description.: Asks for a string from the user. Length defines the number of characters the answer can take, the variable is the answer number, which you can use in combination with other commands. The option Default allows you to enter some infor- mation as default in the answer field. If you use as default USERNAME, this will be replaced through the username of the user answering the questionnaire. Example.....: ASK 40 1 USERNAME Command.....: CAPITALIZE <on/off> Description.: If capitalize is on, all first letters of the words entered in an answer field will be capi- talized. If off, the user decides if a letter is capitalized through the use of his/her Shift(-Lock) key. Example.....: CAPITALIZE ON Command.....: CHANGECOLOR <foreground> <background> Description.: Changes colour to the given combination. Fore- ground (or textcolour) can be between 0 and 15, background between 0 and 7. See earlier in this documentation for a complete list of the col- ours. Example.....: CHANGECOLOR 14 1 -------------------------------------------------------------- SuperBBS v1.12 documentation Page 106 Command.....: CLEARSCREEN Description.: Clears the screen if user has selected CLS codes. Example.....: CLEARSCREEN Command.....: DISPLAY <"text"> Description.: Displays a text to the user. The pipe symbol '|' acts as a carriage return. Every textline should not exceed the screen width. If no '|' is given, SuperBBS will continue at the end of the last line. Use the '|' also after the GETCHOICE command as the first character of a textline. You can use as many '|' symbols behind each other as you like. Example.....: DISPLAY "Welcome to this BBS system.|" Command.....: DISPLAYASW <variable> Description.: Shows the answer given to the question given as the variable. This should be the same variable as used with the question. Example.....: DISPLAYASW 1 Command.....: DISPLAYFILE <filename> Description.: Displays the file given as filename from the textfile directory. If the user has ANSI enabled this will be the ANSI version if avail- able, otherwise the ASCII version is shown. SuperBBS first looks in the directory specified in the language file, then in the directory specified in CONFIG.EXE. Example.....: DISPLAYFILE WELCOME Command.....: DOMENUC <menutype> <"data"> Description.: This command will run the menu command (see list for numbers) given as data in the menutype field. The information given in the data field will be displayed to the user. Example.....: DOMENUC 11 "Yelling Sysop" Command.....: ENDIF Description.: Use this command as the end of an IF loop. (See the IF command.) Example.....: ENDIF Command.....: EXEC <command> Description.: Executes the program given as the command option. This allows you to execute an external program. This program should be in the path or current directory. Example.....: EXEC USERCHEC.EXE -------------------------------------------------------------- SuperBBS v1.12 documentation Page 107 Command.....: GOTO <label> Description.: This command allows you to jump to a character or value. Label must be ONE character or a value. The place GOTO will jump to is deter- mined by the same character or value preceded by a colon ':'. So the command GOTO A, will jump to :A. Example.....: GOTO B Command.....: GETCHOICE <options> <variable> [default] Description.: This command allows you to ask the user a ques- tion, with only a limited one character answer available. Options are the characters which are valid for this answer, variable is the question number the answer should be stored under in memory and default is the default answer, so when a user just presses ENTER, it will default to the answer stated in default. Example.....: GETCHOICE YN 2 Y Command.....: IF <variable = "string"> Description.: This command allows you to jump over certain parts of your questionnaire if the compiled variable does not match the given string. Vari- able is the question number stored in memory and string is the string to match. SuperBBS will compile the user's answer and compare it to the string. If this doesn't match, SuperBBS will jump to the first ENDIF found. Example.....: IF 1 = "Frank Hemmelder" Command.....: OUTPUTANSWER ["string"] <variable> Description.: This commands allow you to store the answers given by the user in an ASCII file with the same name as the questionnaire, but with an ASW extension. String is the text which should be placed in front of the answer, variable is the number of the answer stored in memory. Example.....: OUTPUTANSWER "Full name : " 1 Command.....: POSTINFO Description.: This command will write the current system time, data and the username to the answer file. This command should be used in front of the OUTPUTANSWER lines. Some programs, like READANS.EXE, allows you to upgrade newusers easily by reading the answers in the NEWUSER.ASW file, but they need the information from POSTINFO to separate the different users. Example.....: POSTINFO -------------------------------------------------------------- SuperBBS v1.12 documentation Page 108 Command.....: QUIT Description.: Ends the questionnaire. This does not mean this command has to be at the end of all the ques- tions. If you use the IF and ENDIF commands, this could be half way through your question- naire. Example.....: QUIT Command.....: SETFLAG <flag> <on/off> Description.: Allows you to change a flagsetting from the current user. Flag should be a character/number combination, flags are numbered A1 to D8, and they should be followed by the on or off com- mand. Example.....: SETFLAG B5 ON Command.....: SETSECURITY <level> Description.: Allows you to change the userlevel. Level should be the new level. Example.....: SETSECURITY 0 Command.....: WAITENTER Description.: This command displays the 'Press ENTER to continue' string and waits for the user to press the ENTER key. The 'Press ENTER....' will be done in the current language. Example.....: WAITENTER Now let's have a look at this little example. You could use it, but I recommend you change it and make it better. It will first display a textfile to the user, stating the rules of the BBS, then ask the most important questions and asks if you are a Sysop. If you are, you'll be able to enter your BBS informa- tion. Then all answers are displayed, so the user can check them and eventually start all over if he/she made a mistake. CLEARSCREEN DISPLAYFILE RULES CHANGCOLOR 11 0 CAPITALIZE ON DISPLAY "Do you still want to continue? (Y/n) " GETCHOICE YN 1 Y CAPITALIZE OFF IF 1 = "N" SETSECURITY 0 CHANGECOLOR 14 4 DISPLAY "You will be logged off now!" QUIT ENDIF :A CLEARSCREEN -------------------------------------------------------------- SuperBBS v1.12 documentation Page 109 CHANGECOLOR 10 0 DISPLAY "|Your full name........: " ASK 40 2 USERNAME CHANGECOLOR 10 0 DISPLAY "Address................: " ASK 40 3 CHANGECOLOR 10 0 DISPLAY "City and State.........: " ASK 40 4 CHANGECOLOR 10 0 DISPLAY "Telephone number.......: " ASK 15 5 CHANGECOLOR 10 0 DISPLAY "|Are you a Sysop? (y/N) " CAPITALIZE ON GETCHOICE YN 6 N CAPITALIZE OFF IF 6 = "Y' CHANGECOLOR 10 0 DISPLAY "BBS name...............: " ASK 40 7 CHANGECOLOR 10 0 DISPLAY "Telephone number.......: " ASK 15 8 ENDIF CHANGECOLOR 13 0 DISPLAY "|Thank you for filling out all the questions." DISPLAY "|Now you can check your answers.| WAITENTER CLEARSCREEN CHANGECOLOR 11 0 DISPLAY "|These are your answers: " CHANGECOLOR 10 0 DISPLAY "|Name..................: " DISPLAYASW 2 CHANGECOLOR 10 0 DISPLAY "Address................: " DISPLAYASW 3 CHANGECOLOR 10 0 DISPLAY "City and State.........: " DISPLAYASW 4 CHANGECOLOR 10 0 DISPLAY "Telephone number.......: " DISPLAYASW 5 CHANGECOLOR 10 0 IF 6 = "Y' CHANGECOLOR 10 0 DISPLAY "BBS name...............: " DISPLAYASW 7 CHANGECOLOR 10 0 DISPLAY "Telephone number.......: " DISPLAYASW 8 ENDIF -------------------------------------------------------------- SuperBBS v1.12 documentation Page 110 CHANGECOLOR 14 1 DISPLAY "|All answers correct? (Y/n) CAPITALIZE ON GETCHOICE YN 9 Y CAPITALIZE OFF IF 9 = "N" GOTO A ENDIF CHANGECOLOR 12 0 DISPLAY "|Thank you for answering all questions." DISPLAY "|The answers are now stored." POSTINFO OUTPUTANSWER "Name.........: " 2 OUTPUTANSWER "Address......: " 3 OUTPUTANSWER "City & State.: " 4 OUTPUTANSWER "Phone........: " 5 IF 6 = "Y" OUTPUTANSWER "BBS name.....: " 7 OUTPUTANSWER "Phone........: " 8 QUIT -------------------------------------------------------------- SuperBBS v1.12 documentation Page 111 Chapter 10. Running SuperBBS ============================================================== 10.1 General information -------------------------------------------------------------- SuperBBS can be run as a stand alone program or with a front- end mailer like Frontdoor, D'Bridge or any other mailer pro- gram. In both cases you need to run SuperBBS from a batchfile. Two examples are given in the appendixes of this documenta- tion. One for running SuperBBS as stand alone program and one for running SuperBBS in combination with a mailer. If you are using SuperBBS with a mailer, please read all the documentation of the mailer program carefully, so you know how the two programs interact with each other. 10.2 Command line options -------------------------------------------------------------- SuperBBS can be started by running the program BBS.EXE without any parameter. This will put the main SuperBBS program on- line. You will see a SuperBBS screen with some information, like time and date, last user and more. When this screen is visible (or the screensaver is working) you have two options: [L] This will put the BBS program in local mode. This way you will be able to connect to the system, just like you are running the system remotely. Beware that if you have any door programs installed which uses a Carrier Detect monitor, these won't run because there is no carrier signal available. [ESCAPE] Shutdown SuperBBS and returns you to the DOS prompt. There is a third option, this is that you get a caller on- line. SuperBBS will connect at the right modem speed and will handle the connection. A carrier check is build in, so if the user disconnects, the system will restart (if run from a batchfile). To start the BBS program in local mode, use the -L option. This option and the other command line options are as follows: Type.........: -Bxxxx Description..: Starts SuperBBS with a BPS rate of xxxx. This is a value between 300 and 38400, depending on your modemspeed. This option is mostly used in a batchfile running a mailer, telling SuperBBS at what BPS rate the user is calling. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 112 Type.........: -Exxx Description..: Tells SuperBBS to exit the call with errorlevel xxx. This can be handy if you wish to start some external program after SuperBBS finishes. Type.........: -L Description..: Starts the SuperBBS program in Local mode. Type.........: -Oxxxxxx Description..: This option will increase the overlay buffer with xxxxxx bytes. (For a 286-12 Mhz machine this should be somewhere between 50000 and 100000 bytes.) Experiment a bit with it to find the right value. This will speed up the Super- BBS operation on slow machines or machines with no EMS. This option defaults to 50000 bytes. Type.........: -Px Description..: Tells SuperBBS what COM port to use for the connection. Type.........: -R Description..: Tells SuperBBS it is already connected to a caller and just has to restart the main pro- gram. This option is used after a type 15 exit. Type.........: -T Description..: Tells SuperBBS the user has -T time left. This time is forwarded by the mailer, to prevent an overshoot of an event. Frontdoor uses this in it's DOBBS.BAT file. (Frontdoor v2.01 also has a bug at 14400 EC, stating the -B command as 9600 Bps, instead of the correct Bps). See your mailer manual for further information on call- ing the BBS. Type.........: -* Description..: Tells SuperBBS not to load the overlay file in EMS. Combinations of these parameters are possible. These parame- ters are not necessary to run the SuperBBS program, but are sometimes needed. 10.3 On-line Sysop keys -------------------------------------------------------------- While the SuperBBS is on-line and a caller is in the system, the sysop has several keys which he/she can use. All Fx keys refer to the status line which is shown at the bottom of the local screen. All keys apply to the current user on-line. All the available keys are: -------------------------------------------------------------- SuperBBS v1.12 documentation Page 113 Type.........: F1 Description..: Shows user's information on status line. Name, city, bps rate, securitylevel, times called, time left and line number are displayed. Type.........: F2 Description..: Shows user's flags. Type.........: F3 Description..: Shows user's up/download levels and ratio. Type.........: F4 Description..: Shows chat reason (if any) and if the Sysop is available. Type.........: F5 Description..: Shows sysop comment (from SBBSUSER.EXE) and alias information. Type.........: F6 Description..: Shows the current time and date, user's phone numbers, total calls to system, number of mess- ages written and last caller. Type.........: F7 Description..: Shows the last and first time and date the user called. Type.........: F9 Description..: Remove status lines from screen. This gives you the same view as the user. Type.........: F10 Description..: Gives information about the on-line keys Type.........: ALT-C Description..: Chat with the user. A message will be displayed to the user at the start and finnish of the conversation. Type.........: ALT-E Description..: Run the on-line user editor. This allows you to edit the current user. All changes will be saved in the user file. A message will be dis- played to the user, unless you have CapsLock on. Type.........: ALT-F Description..: Change the current user's flagsettings. All changes will be saved in the user file. A mess- age will be displayed to the user, unless you have CapsLock on. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 114 Type.........: ALT-H Description..: Disconnect user without showing GOODBYE.A??. Type.........: ALT-J Description..: Shell to DOS from SuperBBS. SuperBBS can swap to EMS or disk if allowed through the CONFIG.EXE program. A message will be displayed to the user when you shell out and when you return. Type.........: ALT-L Description..: Locks the user out of your system. He/she will be disconnected and his/her level will be lowered to 0. Type.........: ALT-S Description..: Change the caller's security level. A message will be displayed to the user, unless CapsLock is on. Type.........: ALT-T Description..: Change the timelimit for the user for this call. Type.........: ALT-1 Description..: Generate line noise. This can be useful if you want a user off-line. Type.........: ALT-2 Description..: Toggle the ratio check for the current user on or off. Type.........: ALT-3 Description..: Set a new download limit for this call. Type.........: ALT-4 Description..: Generates a BEEP on the user's console. Type.........: ALT-5 Description..: Toggle output to user's screen on or off. Type.........: ALT-6 Description..: Toggle user's keyboard on or off. Type.........: Up arrow Description..: Increase time limit with 1 minute. Type.........: Down arrow Description..: Decrease time limit with 1 minute. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 115 Type.........: Scroll lock Description..: Toggle Sysop availability on/off. Status lock on means Sysop not available. Also no messages are send to the user, when the Sysop changes the user information. 10.4 User's on-line keys -------------------------------------------------------------- Just as the Sysop has the user some special keys on-line. These are: Type.........: P Description..: Pause all output from text. Type.........: S Description..: Abort current operation. This works in most places in the SuperBBS program. Type.........: Ctrl-C Description..: Stops Sysop yell and message scan. Type.........: Ctrl-Y Description..: Clears any input line. (When you have to answer a question.) As of version 1.10, SuperBBS supports the 'normal' text editor keys as usable keys at input fields. This means you can use the arrow keys, Ctrl-T, Ctrl-Y, Insert, Delete, Home and End keys while entering text. 10.5 Errorlevels -------------------------------------------------------------- SuperBBS normally exits with an errorlevel. You can influence the 'normal' exit through the -Exxx command parameter (see above), but there are some more errorlevels reserved for SuperBBS. Here they are: Errorlevel...: 0 Description..: Normal exit, no problems encountered. Errorlevel...: 2 Description..: Sysop dropped to DOS by pressing ESCAPE in stand alone mode. Errorlevel...: 3 Description..: User logged off and entered Netmail. Errorlevel...: 4 Description..: User logged off and entered Echomail. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 116 Errorlevel...: 5 Description..: User logged off and entered both Net and Echo- mail. In general it is useful not to use the errorlevel of 10 and below. These levels are mostly used to control program behav- iour. 10.6 Yell and chat -------------------------------------------------------------- SuperBBS has a chat option build in to the main program. When a user tries to yell for you, the SuperBBS program will ask for a reason. Then, if a reason is entered, the system will page you. Normally this is a creeping siren sound, but you can choose a melody through the use of YELLCFG.EXE. This program allows you to choose a page melody. You can even write your own tune, check the SBBSYELL.CFG file for an example. If you want to randomly change the tune every day, run the following option in your daily maintenance: YELLCFG.EXE CHANGE. This will take a different melody from the list every time it is run. The chat will be in two colours and if ANSI available it will be full screen by default. One window for the Sysop and one for the user. (Naturally only when user has ANSI on.) If the Sysop starts a chat, the user will get all the time spent in the chat back after ending the chat. If the user starts the chat, the time will continue. If you don't want the full screen chat, press the Left-Shift key, while pressing Alt-C or when you answer the chat. Five keys are available during a chat: Type.........: Ctrl-A Description..: Toggle capture file on/off Type.........: Ctrl-B Description..: Display an ANSI/ASCII file Type.........: Ctrl-Y Description..: Clears current line Type.........: Ctrl-R (in Fullscreen chat) Description..: Redraws the screen Type.........: Ctrl-W (in Fullscreen chat) Description..: Clears the your window The Sysop can end the chat with the ESCAPE key. Through the Ctrl-A key is it possible to keep a capture file for later reviewing of the chat. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 117 10.7 Alias system -------------------------------------------------------------- SuperBBS allows a full alias system. The Sysop can select the use of an alias in all message areas. (Most echomail areas don't allow aliases.) Mailcheck at logon or after a menu type 22 command, will be done for the user's real and alias name. No double aliases are allowed and SuperBBS checks this after a caller enters an alias. SuperBBS includes an option to view a list with real names and their aliases. The alias system only works if you set the option in the CONFIG.EXE program to Yes. 10.8 View a certain file -------------------------------------------------------------- An option in the user record is the field: File to view. Here you can specify per user a file which will be displayed to the user. You can select this file through the use of the SBBSUSER.EXE program. There is an option to allow the file to be deleted after viewing and only showing the file once. 10.9 File to run -------------------------------------------------------------- SuperBBS allows users to enter the system at another menu then the TOP.MNU menu. In the SBBSUSER.EXE program is a field for this option. Here you can enter the name of the menu the user wants to start at. SuperBBS will then pass the user directly to the menu given in the MenuToRun field. This menu can be different for every user. There is currently no automatic way to do this. You will have to adjust the userrecord yourself if you want this option available to your users. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 118 Chapter 11. Multitasking and multiline ============================================================== 11.1 General information -------------------------------------------------------------- Note that I, the writer of the documentation, am not running a multiline system at this moment, so information may not be complete. SuperBBS is now able of running a system with more lines. We ask everybody who uses SuperBBS to give their opinion and ideas. That way we can expand and improve the multi-node option. SuperBBS currently uses 160 KByte memory per line. The setup explained here is for a system running a multitasker like Desqview. How to set a multi node system up. First make the directories where the files will be placed. This could be as follows: C:\SUPERBBS\ Main directory C:\SUPERBBS\LINE1 Line 1 directory C:\SUPERBBS\LINE2 Line 2 directory C:\SUPERBBS\LINE3 Line 3 directory Make for all directories a TEMP and a WORK directory. Make sure the main directory is in your path statement. Copy the main BBS files into the main directory. These files are: BBS.EXE (and overlay file) CONFIG.EXE LCONFIG.EXE SBBSUSER.EXE (and helpfile) *.LNG files other utilities files Go into the line 1 directory and run CONFIG. Do the same for all three lines. (Line 3 could be a local line.) Copy the following files to every directory: (Some of these files may not exist until you run the BBS program.) FLSEARCH.BBS LIMITS.BBS CONFIG.BBS SCONFIG.BBS YELLCFG.CTL (If you use it) LANGUAGE.CTL If you don't copy the FLSEARCH.BBS and LIMITS.BBS to all directories, SuperBBS will look for them in the directory specified in the SBBS variable (Set SBBS=<drive+path>), which should be your main directory. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 119 In this directory SuperBBS will also create the userfiles, BBS list and other support files. The message base files will be created in the directory specified in CONFIG.EXE or, if none specified, the current directory. Make sure you set the common path of all nodes to the same directory. If possible a 30-50 KByte RAM disk. Here all the information about the operations is stored. Also make sure you set the number of lines in all config files the same. (Remember, every line has it's own configuration file!) Set the system directory path in CONFIG.EXE to the directory you are running the node from. Do this for every line. Now you have to design your menus and textfiles. Also Desqview needs to be setup. Read the documentation provided with the program carefully. Multi-node can't run without SHARE.EXE, so load this file at startup of your system. This file should be supplied with your DOS files. SuperBBS currently opens all files to deny none mode. You have to start SuperBBS with the -Nxx command line parame- ter to tell SuperBBS which line it is running on. For example: BBS -L -N2 will start SuperBBS in local mode on line 2. This has to be done from the directory the line is run from. (For line 1 this means C:\SUPERBBS\LINE1) At type 7 exits, two new command options are available: *N Gives you current node number *P Gives you current COM port number SuperBBS searches in the directory specified in the SBBS variable for it's language files, if they are not found in the current directory. If SuperBBS won't run on your system in multi-node mode, let us know. Documentation on running SuperBBS with a Lantastic network will be available in the future. (= Beginning 1992) 11.2 Multitaskers -------------------------------------------------------------- SuperBBS has been tested with these multitaskers: - Desqview 2.25 (Normal and 386 versions) - Desqview 2.31 - DoubleDos 4.0 -------------------------------------------------------------- SuperBBS v1.12 documentation Page 120 SuperBBS support multitasking with Desqview. It will release time slicks and SBBSUSER will ask from Desqview what memory to use for direct screen writes. If you run SuperBBS with any other multitasker, like Windows, let us know. We're always interested in any information about SuperBBS and his behaviour under a multitasker. 11.3 Locking -------------------------------------------------------------- SuperBBS v1.12 has a new message base locking system. It is completely rewritten and available on request from the SuperBBS headquarters for third party programmers. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 121 Chapter 12. Net & Echomail ============================================================== 12.1 General information -------------------------------------------------------------- SuperBBS is a fidonet compatible BBS program. This means you can exchange messages with other systems. These messages can be NETMAIL or ECHOMAIL. 12.2 Netmail -------------------------------------------------------------- SuperBBS doesn't use a nodelist, so if you want to run net- mail, mail from one node to another, you will need a mailer who will handle the address part of netmail, for example D'Bridge or Frontdoor. If you have setup a netmail directory, SuperBBS will ask you for the address the message has to be send to. Here you have to enter a valid fidonet address. There are several external programs available for browsing through a nodelist. After you supplied the destination address, SuperBBS will ask you if the message is a CRASH (or send immediately) message. Third and last question is about File attachments. You can send a file to another BBS this way. If you say YES to the previous ques- tion, SuperBBS will ask you for the filename. Then you can enter your message. Contact a BBS system running Netmail if you want more information on this subject. 12.3 Echomail -------------------------------------------------------------- Echomail is mail that is distributed every night over several BBS systems. This means your message could get all over the world, depending on the area your in. This also is the most expensive form of mail. A message written on your system can be read on hundreds of other systems. All messages are always public. You can setup every message area in SuperBBS for echomail use. You can select a different AKA address (if you have them) and choose an origin line for every area (through ECHOORIG.CTL). You will need a front end program (also called mailer) to run Echomail. To run echomail you need an echomail processor. These will unpack messages from the archives they are send in and toss them to your echomail area. They also pack new messages from your system and prepare them to be transferred. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 122 Some processors are: - ZmailH Echo & Netmail scanner/tosser - TosScan Echo & Netmail scanner/tosser - Imail Echo & Netmail scanner/tosser - GEcho Echomail processor There are more programs available. Ask for them at a BBS near you, running echomail. The D'Bridge mailer has net and echo- mail support build into the program and support SuperBBS. You will also need some echomail utility program. This program must be capable of linking messages, renumbering and deleting them. One of the best programs around is MBUTIL written by Gerard van der Land. This program can take care of all your echomail area maintenance and more. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 123 Chapter 13 External programs ============================================================== 13.1 General information. -------------------------------------------------------------- SuperBBS comes with a few external programs. These are: - USERPACK - SBBSUSER - SBBSUTIL - SBBSMENU - STOP These programs are specially written for the use with Super- BBS. Other programs are available, but do not always support all SuperBBS functions. 13.2 Userpack -------------------------------------------------------------- This program is designed to clean your user database. It will delete all users from the USER.BBS and SUSER.BBS files who have the DELETE flag on. The only exception are user's with the NO-KILL flag on. It will also pack your userdatabase for faster processing. Userpack allows multiple commandline parameters, but all parameters are optional. These are the available options: Type.........: -B Description..: Makes backup of the user files. This will take the program longer to run than without this option. Type.........: -Dxxx Description..: Deletes users from the list who haven't called in xxx days. Type.........: -O Description..: Don't make backup copies if there is not enough diskspace. Use this command in combination with the -B option. Type.........: -R Description..: Removes backup copies after run is complete. Type.........: -Sxxx Description..: Deletes users with a securitylevel lower than xxx. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 124 Type.........: ? Description..: Gives a short help screen. Use only as single command line option. If you run userpack without any options, it will just pack your user base and delete every user with the DELETE flag on. 13.3 Sbbsuser -------------------------------------------------------------- This is the user editor for SuperBBS. You will be able to edit all available information in the user record. It is a full- screen program, with the function keys it uses displayed on the bottom line. Their are two modes (or windows). Edit mode and the main window. Edit mode allows you to change informa- tion from a caller. The main window is the command centre of the program. Here all function keys are active. From here you go to the edit window. These are the available keys: Key..........: Cursor keys Description..: Move around in the editmode of the program. This will move you from edit field to edit field. Key..........: Escape Description..: If in editing mode will ask you if you want to save the information and leave the edit mode. If in the main window, it will exit you to DOS. Key..........: Home Description..: Will move you to the first user when in the main window. Key..........: End Description..: Will move you to the last user when in the main window. Key..........: PgUp Description..: Will move you 10 users forward when in the main window. Key..........: PgDn Description..: Will move you 10 users backwards when in the main window. Key..........: F1 Description..: Display help screens for SBBSUSER. Key..........: F2 Description..: Goto general edit mode. This allows you to change most information available. Changing the security level fast is possible with the ALT-S option. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 125 Key..........: F3 Description..: Search for the user in the NEWUSER.ASW file and display his/her answers. Useful if you want to update users. Key..........: F4 Description..: Search option. This allows you to search for part of a name, alias or city. Key..........: F5 Description..: Put current user in window in the TRASHCAN.CTL file. Key..........: F6 Description..: Add a new user to the database. Key..........: F7 Description..: Change the user's colour configuration. Key..........: F8 Description..: Change the user's flagsettings. Key..........: F9 Description..: Change the user's attributes. The delete flag can also be set from the main window through the ALT-D key. Key..........: F10 Description..: Exit the program. Key..........: Shift-F1 Description..: Add user to the VIP.CTL list. Key..........: Shift-F4 Description..: Change the number of calls With the numerical keys you can select an userrecord. Just enter the number of the record your looking for. SBBSUSER.EXE let's you edit the USER.BBS and SUSER.BBS file. Other user editors mostly allow only editing of the USER.BBS file. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 126 13.4 Sbbsutil -------------------------------------------------------------- SBBSUTIL.EXE allows you to convert some SuperBBS files to general QuickBBS type files. This is useful for some external programs which can't handle the specific SuperBBS type files. The program also gives you the option to initialize your file directories. All commands are done through the use of command- line parameters. Start the program as follows: SBBSUTIL.EXE <parameter> The parameters are: Type.........: FLSEARCH Description..: Converts SuperBBS FLSEARCH.BBS to FLSEARCH.CTL, which can be used with RemoteAccess and/or QuickBBS utilities. Type.........: LIMITS Description..: Converts SuperBBS LIMITS.BBS to LIMITS.CTL. Type.........: INITFILEAREAS Description..: Will initialize all file areas listed in the file FLSEARCH.BBS. Here you can use three extra parameters: -F Make FILES.BBS files if not available. -D Make DIR.BBS files if not available. -A Add all missing files, files which are in the directory, but not in the FILES.BBS list, to the FILES.BBS list. Running the util program with the option: SBBSUTIL.EXE <parameter> ? will display a little help screen for the available options. 13.5 Usersort -------------------------------------------------------------- Usersort is a utility to sort your userbase. This can be done in several ways. The available options are: -L Sort on lastname -F Sort on firstname -S Sort on userlevel -D Sort in descending order Normally ascending sort order is used. The program will take more then one command option. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 127 Example: USERSORT -S -L -F -D will sort your userbase on security, if these are the same on lastname, if these are the same on firstname. It will start at the highest level and will end at the lowest. 13.6 Sbbsmenu -------------------------------------------------------------- New with this release of SuperBBS is the SBBSMENU.EXE program. This is a complete menu editor for SuperBBS. It supports the multi-language aspects of SuperBBS. When you start the pro- gram, it should be in your directory containing the configur- ation files, you will be presented with the TOP.MNU menu if available. Otherwise you will start in a new menu. Pressing [ESC] will display the menu. This menu has the fol- lowing options: Command......: Files Description..: Here you will be able to save, load, copy files and do other maintenance functions. Command......: Text Description..: Here you will find the options which work on the textpart of the menu. Command......: Commands Description..: Here you will find the options which work on the menu options from the menu. Command......: Prompt Description..: Commands for the prompt, which will be visible underneath the menu. Command......: Setup Description..: Setup commands for the menu editor. All menu commands will be described in detail below. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 128 13.6a File commands -------------------------------------------------------------- Here are the commands you will find, when you enter the file menu of the SuperBBS menu editor. Command......: Load menu Description..: Loads a menu from the directory specified in the current language file. You will be pres- ented with a box stating what to look for. (Mostly *.MNU files.) Enter the value you want, or press ENTER and the editor will display a list of the available menus. With the cursor keys you can select a file. Pressing ENTER will load the file. Command......: Save menu Description..: Saves the menu you are currently working on. Command......: New menu Description..: Start building a new menu. The editor will ask you for a menu name. Command......: Write to Description..: Write the menu file to a specified name. This option is useful if you want to use a menu to build another. This way you can save a menu with a different name. Command......: Rename Description..: Rename a menu in the directory. The editor will ask you which menu to rename. Command......: Copy Description..: Copies a menu to another name. The editor will ask you for the name of the menu to copy. Command......: Language Description..: Changes the language currently in use. This allows you to quickly change menus for all languages, without leaving the editor. Command......: DOS Shell Description..: Shell temporarily to DOS. You need to type EXIT to return to the editor from DOS. Command......: Exit to DOS Description..: Exits the menu editor. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 129 13.6b Text commands -------------------------------------------------------------- Command......: Edit text Description..: Change the text of the menu. Pressing ALT-F10 while in the text editor will display a help- file. Command......: Simulate text Description..: The editor will show you what your menu will look like if a user would see it. You will have to enter a security level and flagsetting. Command......: Clear text Description..: Clears the current text screen. Command......: View text Description..: View a text belonging to the menu. This option allows you to see files which are not part of the menu, but will be displayed through the ANSI/ASCII display file option in the menu. Command......: Run editor Description..: Enter an ANSI or ASCII text editor as you have described in the setup of the SuperBBS menu editor program. When you press ALT-F10 while you are in text edit, a help menu will be displayed. Here you will find all the commands avail- able to you. The use of extended ASCII characters is supported, so you can design lines and other graphics. 13.6c Menu Commands -------------------------------------------------------------- This is the important part of the SuperBBS editor. Here you specify the menu commands. You will find the following com- mands in this menu: Command......: Edit menu Description..: Edit a menu file. Here you enter the menu type, securitylevel, hotkey and optional data. Command......: Text dump Description..: Dump the text to a printer. Command......: Menu dump Description..: Dump the menu information to a printer. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 130 When you press ALT-F10 while you are in menu edit, a help menu will be displayed. here you will find all the commands avail- able to you. Entering a menu is done through dialogue boxes for the menu type. If a menu type is not available in the menus given, you can use the option for 'other' menu types. 13.6d Prompt -------------------------------------------------------------- This menu option allows you to edit the prompt which is shown to the user. These commands are available: Command......: Edit prompt Description..: Change the text of the prompt. You can use control codes in the prompt if you want. Command......: Change colours Description..: Change the colours of the prompt. 13.6e Setup -------------------------------------------------------------- This option allows you to setup the menu editor. You can specify an ANSI and ASCII text editor and the default prompt. The text editors will be called if you want to edit a text- file, so make sure they are in your path, or you specified the complete name. 13.7 External programs, not specific for SuperBBS -------------------------------------------------------------- Here's a list of programs which will run with SuperBBS although not all of them were build to do so. Some programs have build in support for SuperBBS, others use the QuickBBS standards. All files are copyrighted to the authors of the programs. This is just a short list, we do not pretend to have a complete list of all programs available. If you write a program which supports SuperBBS, let us know! Here's the list: BIGBROOV.ZIP Ratio counter for SuperBBS systems. BNU170.ZIP BNU fossil driver. COMCREAT.ZIP Comment creator for SuperBBS v1.05. DM_400.ZIP Doormaster door converter. FAST_410.ZIP File area statistics program. FEBBS180.ZIP File area manager with SuperBBS support. MBU_110.ZIP Message base utilities. MENUP_11.ZIP Change prompt in all your SuperBBS menus. MKNEW100.ZIP Replacement for scanning newfiles. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 131 PYVSB10.ZIP Display you against top user. QED120.ZIP Quicked full screen editor. XRS201.ZIP Quick Mail Express with SuperBBS support. SECHK203.ZIP Security checker for SuperBBS systems. SU_02.ZIP Edit special files from SuperBBS. SUPERNEWS.ZIP ANSI/ASCII file compiler. SX229Q1.ZIP Silver Xpress mail program. UAGE16.ZIP User age ANSI/ASCII screen designer. UBM_102.ZIP Userbase editor/utilities. Many options. X00_V124.ZIP X00 fossil driver. As you can see, programs enough. It is possible and most likely, that some of these programs have been replaced with newer versions. Using a disk cacher will speed up your system. Programs like Hyperdisk, Norton Cache and other cachers, can be found in most computershops or, if shareware, on most bulletin boards. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 132 Chapter 14 Documentation and credits ============================================================== 14.1 General information -------------------------------------------------------------- This is my third attempt to write a set of documentation for a program. This means it is probably still full with illogical text. I still hope it can be of use to you, the user of Super- BBS. If you have any comments on this documentation, positive or negative, let me know. You can find my address in chapter 1, or you can reach me in the SuperBBS echomail area. Please note that I'm not running a multi-node system, I'm no part of the SuperBBS developers team and English is not my native language. I will do my best to correct any errors in this documentation in the next version. I can not be held responsible if anything happens to you or your system through the use of this documentation! 14.2 Missing parts and credits -------------------------------------------------------------- Any part of this documentation is written with the best poss- ible intentions, but I'm human, so I probably forget to credit people for things they have done. Anybody who is not mentioned here, but has done something for SuperBBS or the external programs mentioned in this documentation, deserves credit. I'm sorry if I didn't mentioned you. Here's a list of acknowledgments: Product: Trademark of: -------- ------------- Acer Multitech Inc. Amstrad Amstrad (Electronics), Inc. ARC System Enhancement Associates, Inc. BinkleyTerm Bit Bucket Software BNU David Nugent & Unique computing DataBridge Chris Irwin EasyData EasyData Inc. Everex Everex Inc. FidoNet Tom Jennings (IFNA) FrontDoor Joaquim H. Homrighausen Harris Lanier Harris Adacom/Harris Corporation Hayes Microcomputer Products, Inc. Hyundai Hyundai Inc. IBM International Business Machines LHA Haruyasu Yoshizaki MBUTIL Gerard van der Land MS-DOS Microsoft Corporation PKPAK PKWare, Inc. PKZIP PKWare, Inc. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 133 Protocol Engine Joaquim H. Homrighausen Qecho QuickBBS Group, inc. QuickBBS QuickBBS Group, inc. QuickEd Dror and Oren Tirosh RemoteAccess Continental Software Telix Exis Inc. TosScan Joaquim H. Homrighausen TurboPascal Borland Inc. USRobotics USRobotics Inc. Ventel Ventel Inc. X00.SYS Raymond L. Gwinn ZmailH Claude N. Warren (Mojave Group) ZOO Rahul Dhesi And everybody who I forgot to mention. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 134 Chapter 15 General information ============================================================== 15.1 General information -------------------------------------------------------------- In this chapter you will find information concerning batch files, Pascal errors and other useful information. Please read this chapter carefully. 15.2 Batchfiles -------------------------------------------------------------- To run SuperBBS you will need a batchfile. Two examples are given. The first is a short one for running SuperBBS in stand alone mode. The second is from a system with a Frontdoor mailer. This is the stand alone version: @echo off :start bbs if errorlevel 2 goto end goto start :end echo SysOp dropped to dos Nice and simple. Start the batch file and the screen will be cleared. After that SuperBBS is started. If the Sysop presses the ESCAPE key, SuperBBS will exit with errorlevel 2, which will end the batchfile. Otherwise SuperBBS is restarted. See your DOS documentation for more information about batch files and errorlevels. The @echo off only works in DOS 3.3 and higher. Otherwise just leave the @ off. Here's the second example. Everything behind the period is a comment and should not be used in a batchfile, as is the period. echo off . Stops echoing characters :start . Defines 'start' label D: . Changes to 'D:' drive cls . Clears screen cd\front . Changes to 'front' dir FD /M . Starts fd in mono mode if errorlevel 240 goto 2400_baud . Checks if 2400Bps caller if errorlevel 120 goto 1200_baud . Checks if 1200Bps caller if errorlevel 100 goto unpack_mail . Checks if unpack mail if errorlevel 80 goto clean_up . Checks if cleanup event if errorlevel 50 goto local_bbs . Checks if local call if errorlevel 10 goto end . Checks if drop to dos -------------------------------------------------------------- SuperBBS v1.12 documentation Page 135 :unpack_mail . Defines 'Unpack_mail' echo ath1m0>com1 . Puts modem to offhook cd\sbbs . Changes to 'sbbs' dir zmailq q pu pi pf ei ni nf . Runs ZmailQ to unpack goto pack_all . Go to 'pack_all' label :pack_all . Defines 'Pack_all' label echo ath1m0>com1 . Puts modem to offhook cd\sbbs . Changes to 'sbbs' dir zmailq pe q pa ef ee ne . Runs ZmailQ to pack mail goto start . Go to 'start' label :2400_baud . Defines '2400_baud' cd\sbbs . Changes to 'sbbs' dir bbs -B2400 -P1 . SuperBBS at 2400,com1 goto after_sbbs . Go to 'after_sbbs' label :1200_baud . Defines '1200_baud' cd\sbbs . Changes to 'sbbs' dir echo Call detected...1200BPS . Echoes a message sysop bbs -B1200 -P1 . SuperBBS at 1200,com1 goto after_sbbs . Go to 'after_sbbs' label :local_bbs . Defines 'local_bbs' echo Local call detected . Echoes a message sysop echo Taking modem OFF-HOOK . Echoes a message sysop echo ath1m0>com1 . Puts modem to offhook cd\sbbs . Changes to 'sbbs' dir bbs -L . Runs SuperBBS local mode goto after_sbbs . Go to 'after_sbbs' label :after_sbbs . Defines 'after_sbbs' if errorlevel 246 goto spurgux . if request Spurgux if errorlevel 220 goto bank . if request TimeBank if errorlevel 5 goto pack_all . if caller enter mail if errorlevel 4 goto pack_all . if caller enter mail if errorlevel 3 goto pack_all . if caller enter mail goto start . otherwise restart FD :spurgux . Defines 'spurgux' label cd\sbbs\doors\spurgux . Changes to sub-directory ctty gate1 . Activates gateway spu.exe . Runs doorgame 'spurgux' ctty con . DeActivates gateway cd\sbbs . Changes to 'sbbs' dir goto restart_sbbs . Go to 'restart_sbbs' :bank . Defines 'bank' label cd\sbbs\doors . Changes to sub-directory hambank.exe D:\SBBS M . Runs timebank (HamBank) tym2qbbs D:\SBBS . Converts Hambank's files cd\sbbs . Changes back to 'sbbs' goto restart_sbbs . Go to 'restart_sbbs' -------------------------------------------------------------- SuperBBS v1.12 documentation Page 136 :restart_sbbs . Defines 'restart_sbbs' bbs -R -P1 . Restarts SuperBBS after exit to dos (type 15) goto after_sbbs . Go to 'after_sbbs' label :clean_up . Defines 'clean_up' label echo ath1m0>com1 . Puts modem to offhook cd\sbbs . Changes to 'sbbs' dir msgpack . Runs MsgPack (QuickBBS's msgbase packer/cleaner) goto start . Go to 'start' label :end . Defines 'end' label Echo The Earthquake down . Echoes a message SysOp This is the end of the second batchfile example. Check the comments to see what happens. Ask a Sysop near you for help if you have problems running a batchfile like this. This is just an example, you will have to make modifications before you can use this batchfile. 15.3 Equipment -------------------------------------------------------------- SuperBBS has been tested with the following equipment: Acer 500+ ( 8Mhz, Nv20 65,32 Mb HD, 640Kb,Hercules) Adc 386sx (16Mhz, 386/sx, 65 Mb HD, 1Mb,VGA) Amstrad PC1640 ( 8Mhz, 8086-II,17 Mb HD, 640Kb,Hercules) Graph 386 (25Mhz, 80386, 100 Mb HD, 4Mb,VGA) Harris P2500 (25Mhz, 80386, 650 Mb HD, 8MB,VGA) Hyundai 386Sx (16Mhx, 80386, 125 Mb HD, 2Mb,VGA) Ibm PS/2-60 (12Mhz, 80286,2x45 Mb HD, 1Mb,VGA) NoName 386 (25Mhz, 80386, 190 Mb HD, 8Mb,SVGA) NoName 386 (33Mhz, AMD , 330 Mb HD, 4Mb,VGA) Sperry Pc ( 5Mhz, 8088, 20 Mb HD, 640Kb,Hercules) Toshiba T3100e (12Mhz, 80286, 20 Mb HD, 1Mb,CGA/AT&T) And with the following modems: Acer 2400 V.22Bis (external) ATD V.22bis V.22Bis (external) Bausch CN-3532SA V.32Bis/V.42Bis/MNP (external) Discovery 2400S V.22Bis (card) EasyData 2400 V.22Bis (card) Everex 2400 V.22Bis (card) Hidem 2400E V.22Bis (external) Hyundai 1200P V.22 (card) Prodem 2400H V.22Bis (card) USRobotics courier HST dual standard V.32Bis/HST (external) Ventel 2400 V.22Bis (PS/2-Card) -------------------------------------------------------------- SuperBBS v1.12 documentation Page 137 No problems have been found running these configurations. But if you have any problem, let us know. Contact either the SuperBBS HQ or the Support nodes. 15.4 Turbo Pascal errors -------------------------------------------------------------- SuperBBS is written in Turbo Pascal. Here are some Turbo Pascal errors. If you receive a message like: Runtime error: ???? It means an error occurred. The following list might help you to discover what went wrong. Code.........: 2 Description..: File not found Solution.....: You've deleted a SuperBBS file and SuperBBS can't find it. Check which file is possibly missing and replace it. Code.........: 3 Description..: Path not found Solution.....: You've configured a non existing path in the configuration. Check your setup. Code.........: 4 Description..: Too many open files Solution.....: MsDos 'Files=??' statement in config.sys is too low, increase the value. You will need to re- boot your computer. Code.........: 5 Description..: File access denied Solution.....: You've used a Hidden/ReadOnly attribute with a SuperBBS file. Don't do that! Code.........: 15 Description..: Invalid drive number Solution.....: You've configured an illegal drive in the con- figuration. Code.........: 100 Description..: Disk read error Solution.....: Your hard disk has problems, check it. Code.........: 103 Description..: File not open Solution.....: Problems with open/close/read files, try to increase 'Files=??' statement first. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 138 Code.........: 150 Description..: Disk write protected Solution.....: You've a write protected disk, don't do that. Code.........: 151 Description..: Unknown unit Solution.....: You've configured an illegal unit/drive in the configuration. Code.........: 152 Description..: Drive not ready Solution.....: Problems with your disk drive, check it. Code.........: 156 Description..: Disk seek error Solution.....: Problems with your disk drive, check it. Code.........: 157 Description..: Unknown media type Solution.....: Operating system doesn't recognize your disk drive's format. Check it. Code.........: 158 Description..: Sector not found Solution.....: Problems with your disk drive, check it. Code.........: 162 Description..: Hardware failure Solution.....: Problems with your hardware, check it. Code.........: 200 Description..: Division by zero Solution.....: Program error, inform authors. Code.........: 202 Description..: Stack overflow error Solution.....: Program error, inform authors. That's it. For more information about these errors, refer to the Turbo Pascal manuals, or contact the nearest SuperBBS help support or the authors. -------------------------------------------------------------- SuperBBS v1.12 documentation Page 139 Chapter 16 SuperNet ============================================================== SuperNet is an elite network joining SuperBBS bulletin board systems all over the world. It is a direct connection to the SuperBBS group, documentation writer and users alike to dis- cuss SuperBBS operations and development, watch for program and utilities updates or just a place to chat about SuperBBS. SuperNet will make a nice addition to your local SuperBBS bulletin board system. Currently SuperNet is available in the following countries: - Finland - Sweden - Denmark - USA - Canada - Germany - Holland - Japan - Taiwan - Swiss For more information concerning SuperNet, send a Crash netmail to SuperBBS Support Sweden, Fidonet 2:203/111 or SuperNet 42:1003/101, telephone **.46.31.312461. Poll again 24 hours later for a reply. Or you can contact a SuperBBS system con- nected to SuperNet in a country already connected. SuperNet nodes are using the 42:xxxx/xxxx node numbers. The Northern America sites are using net 43 for their nodenumbers. Most SuperNet systems have the nodelist available for down- load. Ask a SuperBBS Support site for one, if you can't find a nodelist from SuperNet near you. There are several echomail areas available in SuperNet. Most of these areas are available to all users and Sysops of the Bulletin Board System. Here's a short overview: Area.........: SBBS_INT Description..: SuperNet echomail about all kinds of subjects, not necessarily about SuperBBS. Available to.: Sysops and users Area.........: Superthoughts Description..: SuperNet echomail for chit chat. Subject is free. (Except for personal attacks and commer- cials). Available to.: Sysops and users -------------------------------------------------------------- SuperBBS v1.12 documentation Page 140 Area.........: SBBS_BUGS Description..: SuperNet echomail for reporting bugs in Super- BBS. Replies can be given as long they concern the subject. Available to.: Sysops (write access) Area.........: SBBS_TIPS Description..: SuperNet echomail for tips and hints about SuperBBS. Replies can be given as long they concern the subject. Available to.: Sysops (write access) Area.........: SNET_INT Description..: SuperNet READ ONLY echomail area with news from the SuperNet coordinators and the SuperBBS team. Available to.: Sysops (READ ONLY) More areas are available, this is only a small sample of the current areas. Most countries have their own national echomail areas available. Join an elite network, join SuperNet! -------------------------------------------------------------- SuperBBS v1.12 documentation Page 141 Appendix A Menu list ============================================================== Menu Description Page ------ ---------------------------------------------- ------ 0 Text line 073 1 Goto new menu 074 2 Gosub new menu 074 3 Return from last gosub 074 4 Goto new menu and clear gosub stack 074 5 Display .ANS/.ASC file 074 6 Selection menu 075 7 Shell to dos 075 8 Version and copyright notice 076 9 Logoff from system 076 10 Display system usage graph 076 11 Page the Sysop 077 12 Execute questionnaire 077 13 List/search userlist 077 14 Time statistics 077 15 Exit to DOS with errorlevel 077 16 Change city and state 078 17 Change password 078 18 Change screenlength 078 19 Toggle screen clearing 078 20 Toggle more prompt 078 21 Toggle ANSI graphics 078 22 Scan for personal mail 078 23 Read messages 079 24 Scan messages 079 25 Quick scan messages 079 26 Delete messages 079 27 Write messages 079 28 Select combined message areas 080 29 Move a file 080 30 MS-Dos directory list 080 31 List FILES.BBS 080 32 Download file 081 33 Upload file 081 34 View archived file 081 35 Search for file by keyword 081 36 Search for file by filename 081 37 List new files on system 082 38 Type a textfile 082 39 Display a textfile 082 40 Display .ANS/.ASC file with Hotkey enabled 082 41 Toggle fullscreen editor 082 42 RESERVED - Do not use 43 RESERVED - Do not use 44 RESERVED - Do not use 45 Display .ANS/.ASC file with 'Press ENTER' 083 46 Show GIF resolution 083 47 Write entry in system logfile 083 -------------------------------------------------------------- SuperBBS v1.12 documentation Page 142 Menu Description Page ------ ---------------------------------------------- ------ 48 Download specific file 083 49 RESERVED - Do not use 50 RESERVED - Do not use 51 RESERVED - Do not use 52 RESERVED - Do not use 53 Toggle mailcheck at logon 084 54 Toggle newfiles check at logon 084 55 Show BBS list (Short) 084 56 Add BBS to BBS list 084 57 Leave comment for next user 084 58 Show callers 084 59 Change colour configuration 085 60 Extract files 085 61 Archive files 085 62 Delete files 085 63 Show BBS list (Long) 086 64 Change BBS information in BBS list 086 65 Delete BBS information in BBS list 086 66 Download BBS list 086 67 Change user's phonenumber(s) 086 68 Select message area from list 086 69 Select/Pick file area from list 086 70 Change alias 087 71 List aliasses 087 72 Show user's balance in timebank 087 73 Deposit time in timebank 087 74 Withdraw time from timebank 087 75 User online 087 76 Send message to other line 088 77 Change current language 088 78 Toggle 'Do not disturb' flag 088 79 Toggle fullscreen message viewer 088 80 Display areas with unread mail 088 81 Perform viruscheck 088 -------------------------------------------------------------- SuperBBS v1.12 documentation Page 143 Appendix B Bugreport and Suggestion form ============================================================== Suggestions form. Send this to the SuperBBS HQ in Finland. Date..................: ... - ... - 19 ... Name..................: ____________________________________ Address...............: ____________________________________ ____________________________________ ____________________________________ BBS name..............: ____________________________________ BBS telephone nr......: ____________________________________ My suggestion is : ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ -------------------------------------------------------------- SuperBBS v1.12 documentation Page 144 Bugreport form. Send this to the SuperBBS HQ in Finland. Date..................: ... - ... - 19 ... Name..................: ____________________________________ Address...............: ____________________________________ ____________________________________ ____________________________________ BBS name..............: ____________________________________ BBS telephone nr......: ____________________________________ The bug found is : (Please be as clearly as possible) ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ -------------------------------------------------------------- SuperBBS v1.12 documentation Page 145 Appendix C Index ============================================================== 1 SuperBBS general information.......................001 1.1 General information..............................001 1.2 SuperBBS credits.................................002 1.3 SuperBBS addresses...............................002 1.4 How to contact us................................003 1.5 Legal stuff......................................003 1.6 How to register..................................004 1.6a Registration in Finland only...................005 1.6b Registration abroad............................005 1.6c Site registrations.............................006 1.7 Differences registered/evaluation version........006 1.8 Distribution files...............................007 2 Installation.......................................008 2.1 General information..............................008 2.2 Software requirments.............................008 2.3 Hardware requirments.............................009 2.4 Unpacking the software...........................009 2.5 Configuring SuperBBS.............................010 2.5a Paths & description............................011 2.5b Modem..........................................013 2.5c Netmail........................................014 2.5d New user parameters............................015 2.5e General (Page 1)...............................016 2.5f General (Page 2)...............................022 2.5g General (Page 3)...............................025 2.5h Restrictions...................................027 2.5i Colour configuration...........................028 2.5j Alt Fkeys......................................028 2.5k String configuration...........................029 2.5l Message base editor............................030 2.5m Event editor...................................033 2.5n File area editor...............................034 2.5o Limits.........................................036 2.5p Protocol editor................................038 2.6 Environment variable.............................043 3 Language support...................................044 3.1 General information..............................044 3.2 Lconfig.exe......................................044 3.2a Path & description.............................045 3.2b Logon strings (Page 1).........................047 3.2c Logon strings (Page 2).........................049 3.2d Message base strings (Page 1)..................050 3.2e Message base strings (Page 2)..................052 3.2f Message base strings (Page 3)..................054 3.2g File area strings (Page 1).....................056 3.2h File area strings (Page 2).....................058 -------------------------------------------------------------- SuperBBS v1.12 documentation Page 146 3.2i Other strings (Page 1).........................060 3.2j Other strings (Page 2).........................062 3.2k Other strings (Page 3).........................064 3.2l Status strings.................................065 3.2m Month names....................................067 3.2n Weekday names..................................067 3.3 Control codes in strings.........................067 3.4 Language.ctl file................................068 3.5 Hints and tips...................................069 4 Converting from other software.....................070 4.1 General information..............................070 4.2 Converting from QuickBBS, RemoteAccess...........070 4.3 Converting from other software...................070 5 Menus..............................................071 5.1 General information..............................071 5.2 Menu commands....................................073 5.3 Menu templating..................................089 5.4 Changing hardcoded menus.........................090 5.5 Control codes in menus & textfiles...............091 5.6 Additional control keys..........................094 5.7 INCLUDE1.MNU.....................................094 6 Message base.......................................095 6.1 General information..............................095 6.2 Sysop keys.......................................095 7 Files base.........................................097 7.1 General information..............................097 7.2 Extract and view option..........................097 8 Support files......................................098 8.1 General information..............................098 8.2 ANSI and ASCII files.............................098 8.3 .CTL, .LNG & .BBS files..........................102 9 Questionnaire language.............................106 9.1 General information..............................106 9.2 Available commands...............................106 10 Running SuperBBS...................................112 10.1 General information..............................112 10.2 Command line options.............................112 10.3 Online sysops keys...............................113 10.4 User's online keys...............................116 10.5 Errorlevels......................................116 10.6 Yell & chat......................................117 10.7 Alias system.....................................118 10.8 View a certain file..............................118 10.9 Menu to run......................................118 -------------------------------------------------------------- SuperBBS v1.12 documentation Page 147 11 Multitasking.......................................119 11.1 General information..............................119 11.2 Multitaskers.....................................120 11.3 Locking..........................................121 12 Net & echomail.....................................122 12.1 General information..............................122 12.2 Netmail..........................................122 12.3 Echomail.........................................122 13 External programs..................................124 13.1 General information..............................124 13.2 Userpack.........................................124 13.3 Sbbsuser.........................................125 13.4 Sbbsutil.........................................127 13.5 Usersort.........................................127 13.6 Sbbsmenu.........................................128 13.6a File commands..................................129 13.6b Text commands..................................130 13.6c Menu commands..................................130 13.6d Prompt.........................................131 13.6e Setup..........................................131 13.7 External programs................................131 14 Documentation & credits............................133 14.1 General information..............................133 14.2 Missing parts & credits..........................133 15 General information................................135 15.1 General information..............................135 15.2 Batchfiles.......................................135 15.3 Equipment........................................137 15.4 Turbo pascal errors..............................138 16 SuperNet...........................................140 Appendixes: A Menu list..........................................142 B Bugreport & Suggestion form........................144 C Index..............................................146 >> This documentation contains more than 35000 words << -------------------------------------------------------------- SuperBBS v1.12 documentation Page 149