The Devil's Doorknob BBS Capture (1996-2003)

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

/ The Devil's Doorknob BBS Capture (1996-2003) / devilsdoorknobbbscapture1996-2003.iso / Dloads / MISSING / WWA1-422.ZIP / WWDOC422.ZIP / WW4SETUP.DOC < prev next >

Wrap

Text File | 1992-12-10 | 62KB | 1,509 lines

Sysop's Guide to Installation and Configuration of WWIV by Filo <aka> Wig De Moville and Random <aka> Wayne Bell Copyright (c) 1991 by Wayne Bell based on INSTALLATION/CONFIGURATION DOCUMENTATION By William Daystrom Copyright (c) 1989 White Star Software Sysop's Guide to Installation and Confirguration of WWIV 1.0 SECTION ONE - INITIAL SETUP 1.1 History WWIV is the name of a BBS program developed by Wayne Bell. The program was initially written in basic ; after this initial beginning, the author switched to Pascal and developed WWIV v3.xx. The last version in Pascal was v3.21D. WWIV v4.xx are all written in C. The current version is v4.21. This part of the documentation is meant to help you get your WWIV operational in the shortest time possible. 1.2 Hardware Requirements In order to run WWIV v4, you will need the following system hardware: An IBM PC/XT/AT, PS/2, or compatible PC/MS-DOS v3.0 or later 512k (640k recommended) A modem, preferably Hayes compatible A 10 meg (or larger) hard disk 1.3 Definitions of Common Terms The terms defined below are used throughout the documentation. Because these terms are often referred to by their abbreviation and/or short name, it will be useful if you familiarize yourself with these definitions now. 1.3a SL SL stands for Security Level, and is the main determinant of what a caller can and can not do. The most obvious effect of different SL's is time allowed on the system. For higher SL's, more time is allowed on the system, and the caller is able to send more mail, and post more messages. Higher SL's also generally give more anonymous privileges. Any of these privileges can be changed in the INIT program, described later. The default settings are as follows: 70+ = can post anonymously on any message base 80+ = can send anonymous email 90+ = can read names of anonymous posts 95+ = can read names of anonymous email 99+ = can delete and validate messages 100+ = can access any co-sysop functions 255 = can access any sysop function An SL of 100 will allow a caller to perform just about all of the functions necessary to the day-to-day running of the BBS, except validating new callers. SL's of 100 should be given out VERY sparingly, as anyone with an SL of 100 could do enormous damage to the BBS if they wanted to. A SL of 255 has a few things different from other SL's. First off, a caller with an SL of 255 needs to enter the system password in order to log on remotely. This means that any caller with an SL of 255 needs to know the system password. With an SL of 255 and the system password, a user can do ANYTHING with the BBS, with the exception of running the INIT program remotely. The caller could also drop to DOS, and do anything to any files on your computer, INCLUDING DELETION OF FILES ON YOUR DISK. For this reason, SL's of 255 should be given to other people only where ABSOLUTELY NECESSARY. The SL also helps determine which subs a caller has access to. Generally, a higher SL allows a caller access to more sub-boards. Also, the SL helps determine access to on-line programs, and gfile sections. 1.3B DSL The DSL is like the SL, only in a more limited sense. The DSL stands for "Download Security Level," and the only place the DSL matters at all is in the file section. The only effect of the DSL is to help determine which directories that caller has access to. Also, a DSL of at least 100 allows the caller to perform co-sysop functions in the transfer section, but NOT in the main BBS. 1.3C AR AR stands for access required, and helps determine (along with the SL) which sub-boards a caller can access. It also helps determine access to on-line programs and gfile sections. Each caller can have from zero to 16 AR's set. Each AR is given a letter, from A to P. Each sub-board can also have ONE AR set. In addition to other requirements, for a caller to have access to a sub-board with an AR set, the caller must also have the same AR set. For example, if a sub-board for sysops only is given an AR of A. Then, whenever another sysop logs on, that person should be given an AR of A, and he would then have access to the sysop sub. 1.3D DAR This functions just like AR, only for the file section, and directory access. Continuing the example above, a special sysop file directory could be assigned a DAR of A. Then if the calling sysop were given a DAR of A, he would have access to the sysop file directory, whereas all other callers would not. 1.3E Sub A Sub (or sub-board or message base) refers to an area where messages can be posted by callers about a certain topic. 1.3F WFC WFC stands for "Waiting For a Caller," and signifies the mode where the screen is blank, and the BBS is ready to accept calls. This screen will have a blinking cursor in the upper-left hand corner. 1.3G Sysop The sysop is the primary operator of the bulletin board. The security level of the sysop is almost-always 255, and the sysop has access to every area of the bulletin board. 1.3H Co-Sysop The co-sysop is an assistant to the sysop. The security level of the co-sysop is usually anywhere from 100 to 255, and the co-sysop has access to most if not all areas of the bulletin board. The co-sysop's job usually consists of handling routine maintenance of the bulletin board. 1.3I Limited Co-Sysop This person is an assistant co-sysop of one or more message bases. The limited co-sysop usually has a security level of 99, and can delete and/or validate messages in message bases specifically assigned to be controlled by that limited co-sysop. The limited co-sysop does not have the ability to handle routine maintenance. 1.3J Sysopsub If a caller is a limited co-sysop, you can specify a sysopsub, which restricts that caller's limited co-sysop status to only one sub-board. The sysop sub should be the actual sub-board number (as given in BOARDEDIT) for that sub. When a caller is a limited co-sysop of a sub, he/she has all of the co-sysop message base commands available to normal co-sysops FOR THAT SUB ONLY. To deactivate a sysopsub, set the caller's sysopsub to 255. 1.3K Exemptions Exemptions allow the sysop to exempt a caller from something. There is currently only one exemption available to you. An exemption of 1 will exempt a caller from any upload/download ratio requirement you may have. To deactivate the exemption, set it to zero. 1.3L Restrictions This allows the sysop to restrict the caller from doing certain things on the BBS. For example, the sysop can restrict the caller from being able to post. Or, the caller's uploads can be forced to go to the sysop directory only, and you can restrict the caller from using a WWIV network (if you are a part of the network). See the section on UEDIT for complete details of all restrictions. 1.4 Installing WWIV In order to run WWIV v4, you will NEED the following files: BBS.EXE INIT.EXE HELP.MSG MENUS.MSG MODEMS.MDM The first step in installing WWIV is to create a directory for it on the hard disk. You should install WWIV in a sub-directory made explicitly for WWIV, and should NOT be installed in the root-directory of any drive. For example, if you have a hard disk as drive C:, you should type the following: C: CD\ MD WWIV CD WWIV This will make a directory called WWIV, and make that your current directory. You will then need to copy the WWIV v4 files listed earlier into that directory. Alternatively, you can unzip the software into this directory. Most sysops call their WWIV directory either WWIV or BBS. The initialization/configuration program features an automatic port/modem/modem type detection function. During initial setup, the initialization/configuration program checks COM ports 1-4 (staring with 1) to see if a modem is present. As soon as it detects the presence of a modem, the program will determine the type and maximum speed of that modem. The program stops checking COM ports as soon as it detects a modem. If you have modems connected to COM 1 and COM 2, the program will stop checking ports after if finds the modem in COM 1, and will create various BBS modem data files for that modem. So, prior to running the initialization/configuration program for the first time, have your modem turned on and connected to the COM port you will be running the BBS on. Nothing bad will happen if you don't to this, but doing so will enable you to take advantage of the port/modem auto-detect feature of the initialization/configuration program. Additionally, the presence of a buffered UART chip for the modem COM port is also checked. The next step is to run the initialization/configuration program. To do this, simply type "INIT" at the DOS prompt. It is possible that when you run INIT, you will receive the message "Abnormal program termination" or "Program code corrupted." If you do receive this message, simply try running INIT again. If you still have problems, try rebooting your computer and running it again. If you are still having problems running INIT, either you have a bad copy of WWIV, and need to get another copy, or there is something in your system setup that WWIV doesn't like. Once you run INIT (for the first time), you will be told that CONFIG.DAT wasn't found, and you will be asked if you wish to perform the initial installation. You should answer Y. INIT will then proceed to install the necessary files and directories for WWIV to run. You should note that all directories will be made as sub-directories of whatever your current directory is, so be SURE that your current directory is the one you want to use as your main WWIV directory, when you first run INIT. After a bit of disk I/O, the screen will display which COM port (if any) a modem was detected; the speed and and type of modem; and which modem config file will be created and used. If no modem is found, a 'generic' 2400 baud Hayes compatible modem set-up will be created. Next, you will be told that your system password has defaulted to SYSOP. The system password is a password that should only be known by the primary system operator. The system password should be entered whenever you see the "SY:" prompt. You will need to enter the system password whenever you run INIT, or run more sensitive sysop functions from the BBS. After you are told what the system password is, you will be given the "SY:" prompt, and you will need to enter the system password, SYSOP. After correctly entering the system password, you will be in the WWIV v4 initialization/configuration program. You will have a list of 14 options. These options will be described in order. If you don't fully understand some of the options, just leave them as they are, and their use will probably become clear after playing with the system a bit, or reading the WWIV sysop manual. 2.0 SECTION TWO - PRIMARY CONFIGURATION 2.1 Using INIT Once INIT is run, and after you have correctly entered the system password, you will be presented with a menu listing fourteen options. This section will describe each of them, giving examples of how to use and modify your configuration. 2.2 Option 1. System info (name, passwords, newuser info, etc) This section allows the sysop to change general system information. The things you can change are: 2.2A System password The system password defaults to SYSOP, but you should be sure to change it to something else, hopefully something that other people will have a difficult time guessing. Selecting your own personalized system password helps prevent other people from gaining unauthorized access to your BBS. 2.2B System name This should be set to the name of your BBS, but if it isn't set correctly, nothing bad will happen. 2.2C System phone This should be set to the phone number of your BBS. This isn't critical information UNLESS your board is a member of a WWIV network. 2.2D WWIV Reg Num If you have registered your BBS, you will have a registration number. This is where you enter that number. This information is shown to callers when they log on to the BBS. 2.2E Newuser PW This is the password people will have to enter in order to log on as new users. If there is no newuser password, anyone may log on as a new user. This should only be used if you wish to operate a "private" system. 2.2F Newuser restrict This sets the restrictions that all new users are given. This should probably be left as-is until you fully understand what the restrictions are used for. See "Restrictions" on page 2 for more details. The default restriction of M means that any messages that the user posts, will not be seen by anyone else until you have validated the messages. 2.2G Newuser SL This sets the security level that all new users are given. The default is 10. This should also be left alone until you understand what the different security levels do, and even then, most sysops will probably want to leave this set to 10. 2.2H Newuser DSL This sets the download security level that all new users are given. The default is zero. New users are severely limited in what they can do on the BBS until you have 'validated' them which usually involves an increase in their SL and DSL as well as possibly the assignment of some ARS and DARS. 2.2I Newuser gold WWIV keeps track of an amount of "gold" for use in on-line games, if needed. This sets the default amount new users are given. The regular distribution version of WWIV does not use gold for anything. If you have registered your BBS and obtained the source code, modifications are available which can allow you to use gold, for example, to regulate downloads or game use by requiring that the caller "earn" a certain amount of gold by posting. 2.2J Sysop name At a few points in the BBS, the system will need to print out the name of the system operator. This is where you can set what that name will be. 2.2K Sysop low time The sysop low time and sysop high time set the time limits that the sysop is available to be chatted with. If, for example, you don't want people to be able to request a chat between 11pm and 7am, then your chat hours would be 7am to 11pm. The low time (when chat hours begin) would then be 7am, and the high time (when chat hours end) would be 11pm. You enter the time in the standard 24-hour format, where 7am is 07:00 and 11pm is 23:00. Normally, the scroll lock key determines when the sysop is available for chat. If sysop hours are defined, the system ignores the status of scroll lock during the hours the sysop is supposed to be unavailable. In other words, if you followed the above example and chose available hours to be from 7am to 11pm, callers will not be able to request chats with you from 11pm to 7am, regardless of the scroll lock setting. During the sysop hours (7am to 11pm), scroll lock IS monitored, and will determine whether or not the sysop is available for chat. If the scroll lock is on, callers will be told you are available, and if they request a chat, a chat alarm will be sounded (unless you have turned the beep off. See "Beep for chat" on page 6 for details. 2.2L Up/Download ratio Many sysops want to have up/download ratio requirements. This allows you to set them. A caller's ratio is defined to be the number of k (1024 bytes) of files uploaded divided by the number of k of files downloaded. So, if you want a caller to be able to download 5k for every 1k uploaded, the required ratio would then be 1/5=0.2, so you would set the ratio required to be 0.200. This way, when a caller has violated the ratio (downloaded over five times what he/she uploaded), the caller would not be allowed to download again until the caller uploaded enough data to clear the ratio. 2.2M Post/Call ratio Similar to the Up/Download ratio, this restricts users from downloading if they do not meet the minimum ratio established. 2.2N Max waiting Each caller may have a number of pieces of mail waiting. This allows you to set the maximum number of pieces of mail a caller can have waiting. NOTE: The sysop (sl=255) can have 5 times this number of mail waiting. So, if, for normal callers, 20 is the maximum, then 100 would be the maximum for the sysop. 2.2O Max users The BBS requires you set the maximum number of users that can be on the system. This defaults to 500, but you may increase or decrease it. The absolute maximum is 32,767, but 2,000 is probably about the limit for performance reasons (ie, the system slows down the more users you have). 2.2P Caller number If you have converted to WWIV v4 from another BBS (possibly an earlier version of WWIV), you may set the current caller number with this option. This counter is increased by one each time the system receives a non-network call unless the remote caller is the sysop. 2.3 Option 2. More system info (net, status, etc) 2.3A System number If your system is a member of a WWIV network, the node number is entered here. A node number is something that is assigned to you by a network administrator and is the means by which others can address your system with e-mail and/or send you a networked sub. In v4.21a and higher, if your network software is NET31 or more, the option for Node Number is moved to option N. If you do not have NET31 or higher AND v4.21a or higher, you will still configure your node number here. In these other versions, you will see option N which is discussed below. 2.3B Net low time You can specify hours during which your BBS will only accept network connections. Anyone else calling at that time will be asked to call back later and be disconnected. The net low time is the time from which your BBS will stop accepting regular calls. The time is entered in 24-hour format, just like the sysop hours (ie, 4pm = 16:00). 2.3C Net high time This parameter, used in conjunction with the net low time, specifies the time at which regular calls will be accepted again. 2.3D Closed system If you don't want to allow new callers on at all, set this option to "Y," and no new callers may log on remotely. 2.3E Local system It is possible that you may want to run the BBS on a computer that you don't have continual access to. Setting local sysop to "N" will: a) disable all function keys, b) disable the top of screen data, and c) disable sysop functions while the BBS is waiting for a caller. 2.3F Beep for chat Normally, the BBS will make a horrid beeping noise in an attempt to attract your attention when a caller requests a chat. If you would prefer not to be such annoyed, simply set this to "N," and the BBS will no longer beep at you for chat requests. 2.3G Phone off hook When the sysop wants to check up on his system locally, remote callers can not log on. If you would prefer people calling while you are on to get a busy signal (instead of ringing), set this to "Y," and the BBS will pick up the phone while you log on locally, or read feedback, or use any other WFC command that is likely to take some time. 2.3H Two color chat Normally, in chat mode, all text will be the same color. If you would prefer text typed locally and remotely to be two different colors (if the caller supports ANSI graphics), set this option to "Y." 2.3I Two way chat Under normal conditions, two way chat mode will be used when the caller has ANSI and is calling at 1200 bps or higher. This option allows you to disable two-way chat capability. Chat is discussed in detail in the Sysop Guide To WWIV. 2.3J Allow aliases If you would prefer to disallow the use of aliases on your BBS, set this option to "N." 2.3K Close transfers This option will allow you to close the transfer section of your BBS. This means that no one will be able to upload or download from your BBS. This option may be very useful if you have limited disk space available for the board. 2.3L All UL to sysop This option forces all uploads to be placed in your sysop directory. Directories are discussed in detail in the Sysop Guide To WWIV. 2.3M Sysoplog to printer If you would like the sysoplog to be printed out to the printer as events occur, then set this option to "Y." Please note that you must have a printer connected and ready on LPT1: in order for this to work. 2.3N Use list utility If you have a text file viewing utility, you may use it to view your sysop logs from WFC. The utility must be named "LIST" and be placed in the DOS path (or main BBS directory). If the list utility is not used, sysop logs are always printed to screen as if TYPE were used (i.e. they are listed continuously from top to bottom). 2.3O Free format phone This option allows "non-standard" telephone numbers to be entered. "Standard" format being what is used in the United States and Canada, which is ###-###-####. Other countries may have a different format that may have more or fewer numbers. This allows systems to operate in other countries as well as allowing callers from other countries to call BBS's in the United states and Canada. When this option is set to "Y", users are not prompted for their last 4 digits when logging on. 2.3P Notify user of DL If this is set to "Y", when a user logs onto the BBS, a short message is displayed advising who downloaded any files they uploaded. This option only checks user numbers, so it is possible a user may be notified of an download that was uploaded by the person who previously had that same user number. 2.3Q Extended Information on Users Toggling this option will ask your old users for the address information and so forth that has been added to v4.22. 2.4 Option 3. Paths (messages, gfiles, data, etc) If you have more than one hard disk, you may wish to split up the BBS files among your hard disks, in order to better use the space. Using this option, you may change the directories that the BBS looks to for certain things. Please note that changing any of the options here will only change where the BBS looks for the data; IT WILL NOT ACTUALLY MOVE ANY FILES OR DIRECTORIES. 2.4A Messages dir Information regarding all e-mail and posts is stored here. 2.4B Gfiles dir The Directory where the bbs text files are stored. These files can be read by users while they are on line. See GFILES in the User's Guide To WWIV and GFILEEDIT in the Sysop's Guide To WWIV. 2.4C Data dir Data files used by the BBS are storesd here. 2.4D Dloads dir This directory is used to set the default directory for new file sections. 2.4E Temp dir This area is used to temporarily store files for the BBS. Because this area is "deleted" each time that a user logs off, you should not store anything in this directory. 2.4F Batch dir This directory is used to temporarily store files that are batch uploaded (defaults to Temp dir--should have adequate disk space for files being batch uploaded; at least 2 megs recommended). You may freely change the dloads dir, temp dir and batch dir to whatever you want without hurting anything. HOWEVER, the temp/batch directories MUST exist. If you can, have the temporary directory exist as a ramdisk. If the temp dir is a sub-dir of a ramdisk, MAKE SURE that the directory is created BEFORE the BBS is run. In other words, run the BBS in a batch file that first creates the temp directory. Please note also that any files found in the temporary directory when the BBS is run will be DELETED. If you point the temporary directory to your root directory, or the BBS directory, ALL THE FILES IN THAT DIRECTORY WILL BE ERASED. Therefore, have the temporary directory be one that doesn't contain any files you care about. After batch uploads are completed, the BBS will automaticaly move the files into the appropriate drive and directory. The others (messages, gfiles, data), however, will have files in them that the BBS needs to find in the appropriate directories. Use the following guidelines for selecting and naming new directories (if you wish to use any): 1. Never use the root directory of any drive to store BBS files; the root directory can only hold a fixed number of files, while any sub-directories may hold an unlimited number of files in them. 2. Always have a backslash on the end of the path/directory name. The software will normally add this backslash for you. 3. The directory may be specified relative to the main BBS directory, or as a full pathname. In other words, "msgs\" is recognized as a sub-directory of the main BBS dir. In most instances, however, you won't need to change the default directories. If you choose to have directories located on another drive, remember to include the drive letter in the pathname. If you change the messages, gfiles, or data directory, you must then: 1. Go to DOS and create the new directory. 2. Move all the files from the old to the new directory. 3. You should then probably erase the old files and old directory, to ensure you aren't confused by multiple copies later on. If you have any gfile sections (described later), you will have sub-directories of the gfiles directory, ie, "gfiles\section1\". You will then need to create sub-directories, of the new directory, with THE SAME NAME, and copy all files from the old sub-directory to the new one. 2.5 Option 4. Com port info (port, IRQ, base address, etc) 2.5A Com Port This sets the com port number that your modem is connected to. If this is set to zero, the result is that the BBS will not use a modem at all (same as /m parameter). Initially, the com port is identified and set with the auto-detect features of the INIT program. 2.5B Interrupt This allows you to manually change the interrupt used by the BBS. You will probably not need to modify this. 2.5C Base address This sets the com base address used by the BBS, and is dependent upon the com port number. It is set automatically when you change the com port option, and you will not need to change this, unless necessary. 2.5D Slow UART The INIT program automatically detects the presence of the 16550 buffered UART chip for the com port listed. "Y" indicates INIT has detected a 'slower' UART chip and the "Unbuffered UART on COMx" message will be displayed. 2.6 Option 5. Select modem type This option allows the manual selection of the modem type to be used by the BBS. Using up/dowm arrow keys, scroll to the modem type that most closely describes your modem; press enter, and a new MODEM.DAT file will be compiled and placed in the DATA directory. It is this file that contains all modem information the BBS needs. MODEM.DAT is a data type file that cannot be altered or changed. The source for the MODEM.DAT file is a configurable text file called MODEMS.MDM. MODEMS.MDM is one of the files that now comes with WWIV. When you run INIT for the first time, this file is moved to the DATA directory. It is very unlikely that you ever need to change the data stored in MODEM.DAT, but if it ever became necessary (changing a result code or such), the place to do so is in MODEMS.MDM, then re-select that modem type and a new MODEM.DAT file will be compiled. For more information on this, consult the WWIVMODM.DOC file. 2.7 Option 6. External programs (zip, terminal, etc) 2.7A Terminal program This should be set to the name of a batch file to run a terminal program. If, for example, you want to run Qmodem, and your Qmodem files are in the directory c:\qmodem, you should then set the terminal program option to QMODEM. Then, in your main BBS directory, you should create a file to run Qmodem, such as: copy con qmodem.bat c: cd \qmodem qmodem ^Z You don't need to worry about changing back to the BBS directory when done, the BBS will do that for you. One side note: Due to the size of Qmodem, and the size of the BBS, you probably can't actually use Qmodem unless you "shrink" the BBS out of memory during the time you are using the comm program. Also, you don't necessarily have to run a terminal program with this option. It simply allows you to run an external program from WFC. You could, for example, run a file management utility from the BBS by running it instead of a terminal program. The only limitation in that instance is, again, the memory remaining. 2.7B BeginDay Event This is a batch file or program that the BBS will automatically run after the first caller logs on after midnight, every night. You can write a batch file, for example, to run the maintenance program of an on-line game. Or, you can write a batch file to backup some BBS files. 2.7C Logon Event This is just like the BeginDay Event, except that it is run every time a caller logs on. This option may be used to run a program that gives the caller a "quote for the day" or other similar utility. 2.7D Newuser Event This is also like the BeginDay Event. This time, though, it is executed immediately after a new user has saved the validation letter. 2.7E Upload Event This is similar to the BeginDay Event, and will execute after a user uploads file(s). This is a good opportunity to "virus scan" uploads, change the archiving method or even change/add zip comments, just to name a few possibilities. Parameters that can be used in this event are: %1 chain.txt path and name %2 directory %3 filename 2.7F External Event Again, this is not too different from the above-listed events. This one, however, can be set to run at any pre-defined time. See the next section for details. 2.7G Time for Event This is how you can set the time that the External Event will run. Any caller that logs on before the external event is set to run will have his/her time on-line shortened so that the caller will be off the BBS before the event runs. 2.7H Archive Extension This option is listed four times, as are the other extension-related settings. This is because WWIV can support up to four different archiving programs. In the transfer system, you or a caller may view the files within an archive, extract individual files from archives, and add those extracted files to a new archive. Archive Extension is simply the filename extension of the archive program you want to support. For example, ZIP, ARC, PAK, and LZH are all popular archive extensions. NOTE: The first archive listed is the most important in one respect: it is the only archive that will be used when the Add to archive option is selected. For example, if a caller extracts a file from within a LZH archive, and then wants to add the file to a temporary archive to download later, ZIP would be used to create the new archive if ZIP were listed first in INIT. Select which archive you want to use for this role, and enter its extension first in order. 2.7I List Archive This is the archive command used to see a listing of the files within an archive. Some sample commands are: (for ZIP): PKUNZIP -V %1 (for PAK): PAK V %1 (for LZH): LHARC V %1 The %1 is a parameter which the BBS uses to pass the filename of the archive to be viewed. 2.7J Extract Archive This is the archive command used to extract a file from within an archive. Some sample commands are: (for ZIP): PKUNZIP -O %1 %2 (for PAK): PAK E %1 %2 (for LZH): LHARC E %1 %2 Again, %1 is replaced by the BBS with the filename of the archive to be worked on, and %2 in this instance is replaced by the path of the temporary directory (discussed earlier). 2.7K Add to Archive This is the archive command used to add a file to the temporary archive. As stated earlier, only the first "Add to Archive" entry is important; you may leave the other three blank. Some sample commands are: (for ZIP): PKZIP -A %1 %2 (for PAK): PAK A %1 %2 (for LZH): LHARC A %1 %2 In this case, the BBS replaces %1 with the filename of the temporary archive to be created, and %2 is replaced by the path and filename of the file(s) to be added to that temporary archive. 2.8 Option 7. External protocols (other than X,Ymodem) Using this option, you will be able to insert, delete, and modify external protocols for the BBS to use. Following are some examples of commands to use for various external protocols: Description : Zmodem Xfer OK Code : 0 Require MNP/LAPM : No Receive command line: dsz port %2 speed %1 est 0 %4 rz %3 Send command line: dsz port %2 speed %1 est 0 %4 sz -r %3 Receive Batch Command Line: dsz port %2 speed %1 est 0 %4 restrict rz %3 Send Batch Command Line: dsz port %2 speed %1 est 0 %4 sz @%3 Bi-directional transfer command line (not implemented yet): The return code is only checked for sending files. Also, if you leave either the send or receive command line blank, that protocol will be disabled for the function omitted. In other words, if you didn't specify a command for sending with Zmodem, callers would only be able to use Zmodem when uploading to you. HS-LINK is covered in one of the appendices to this doc file. Under v4.22 and up, you may override the built-in protocols of Xmodem and Ymodem by entering alternative parameters to them. For example, you might wish to replace those functions with those found in DSZ by Omen Technologies. However, if you do this, be aware that the BBS will consume about 3k more of memory. 2.9 Option 8. External editors (full screen) Full screen editors allow you and your callers (with ANSI) to write email and posts using an editor that is not restricted to the line-by-line approach used by WWIV's built-in text editor. Some editors allow the use of function and arrow keys to move the cursor about the screen, in much the same manner as a regular word processor. Full screen editors tend to be awkward for callers to use, however, as while the sysop might use the arrow keys to move the cursor, the caller must almost always use control-key combinations to achieve the same thing -- not very easy. Still, there are some great advantages to using a full screen editor, especially from the sysop's point of view, and so provision is made in WWIV for their use. The full screen editor must do all I/O through DOS calls. A well-known full screen editor because it has been used in many versions of WWIV is FSED, written by Sagredo. The command lines to use FSED could be: remote: fsed +dosansi.cfg +wordstar.cfg -w%2 -h%3 -l%4 %1 local: fsed +console.cfg %1 Other well-known full-screen editors for WWIV include WWIVEDIT, ZEDIT, MEREDIT and FEDIT. Beginning with v4.22 of WWIV, WWIVedit is distributed as one of the accessory programs. The registration of WWIV does NOT include the registration of WWIVedit. If you wish to continue to use WWIVedit as an external editor, you should register it with its author. Information on how to do this will be found in the WWIVedit documentation. If you utilize FSED, you can experiment with the commands provided in the FSED documentation to find a combination that you like best, but the above is probably the best for general use - especially from the sysop's perspective. 2.10 Option 9. Seclev data change For each security level (0-255), there is a set of data that determine what a caller with this SL may do. This option will allow you to change that data. Using {,},[,], you can scan through until you find an SL you want to change. Then, hit enter to edit the data. You can then alter: 2.10A Security level Changing this changes to that security level. The other data on the screen is appropriately changed. Any data changed for the previous SL is saved. 2.10B Time per day This gives the time, in minutes, that a caller with that SL is able to be logged on the system per day, regardless of the number of calls. 2.10C Time per logon This gives the time, in minutes, that a caller with that SL is able to be logged on to the system per call. Normally, the time per day is 2.5 times the time per logon. Normally, the time allowed on is limited by the time per logon, but after the second call that day, the time per day may cut down the total amount of time on. Of course, the time allowed on may be affected by uploads, chat time, and extra time allowed by the sysop. 2.10D Messages read This sets the number of messages that can be read (per call) by a caller with that SL. 2.10E Emails per day This sets the maximum number of pieces of mail that a caller with that SL can send, per day. NOTE: Email excludes feedback. A caller is allowed to send up to 5 pieces of feedback per day. 2.10F Posts per day This sets the maximum number of posts a caller with that SL can post per day. 2.10G Post anony If set, this means that a caller can post a message anonymously on any message base. 2.10H Email anony If set, this means that a caller can send anonymous e-mail. 2.10I Read anony posts If set, a caller with this SL can read the names on anonymous posts. 2.10J Read anony email If set, a caller with this SL can read the names on anonymous e-mail. 2.10K Limited co-sysop If set, a caller with this SL can validate and delete messages from any caller. Normally, callers can only delete messages they themselves have written. 2.10L Co-sysop If set, a caller with this SL has access to all co-sysop functions. 2.11 Option 10. Auto-Validation data change The sysop can set the Alt-F keys (Alt-F1 through Alt-F10) to set certain data for a caller. This function allows you to change that data. You may set the SL, DSL, AR, DAR, and restrictions. Then, when a caller is on-line, you may press any ALT-function key combination to immediately change that caller's security levels, AR, and restrictions. This may be useful for validating a caller - you can, for example, just hit Alt-F1, and if you have that configured to give the caller standard access, the caller will immediately receive said access. It all happens very quickly, and there is no immediate indication on the caller's side that anything has happened, save perhaps a dramatic increase in the time-left display. Be careful, though. If you are logged-on locally, and hit an Alt-key combination, your stats will be altered as well. This would do no permanent damage, but it will cause an annoyance as you have to go to the indignity of validating yourself again. 2.12 Option A. Auto-Detect modem type (if possible) This option, if selected, will have the software try to match your modem to one of the types as best it can. 2.13 Option N. Update Network info If you have both v4.21a or higher of the BBS software AND NET31 or higher, you will see Option N and it will enable you to configure your system for more than one network. When selected, you will see the self-explanatory prompt: Networks: M:odify, D:elete, I:nsert, Q:uit : If you select I:nsert, you will be prompted to provide information on the network name, the node number of your system in that network and the directory where the data files for that network are to be found. Each network should have its own data directory so that bbslists and so forth may be updated properly. The network software will look first to this directory for network files, so if some files for a particular network are different, they should be placed here as should the BBSLIST and CONNECT information for that network. 2.14 Option U. Userrec (WWIV v4.21a) Max # Subs/Dirs (WWIV v4.22+) If you have not modified your userrec, then this option will adjust your userrec for the increased message base size (32 to 64 subs) available on v4.21a. If your userrec has been modified, this option will do nothing. In v4.22, you may use this option to increase the number of message bases and/or directories that are in use. The software will increment these in blocks of 32 each. You should NOT select more than you think that you will actually need, for more memory is required as the number is increased. If you are counting for the 14 options, the 14th is Q to quit. 2.15 General Text Files -- Especially Default Messages The GFILES directory contains a number of text files which the BBS will use to accomplish various tasks. You can change any of them to suit your desires. For files with a MSG extension, you can use any text editor you want as long as the editor saves the files in standard ASCII format. For files with a B&W or ANS extension, you need to use an ANSI editing program. A note about MSG, B&W, and ANS files: ANS files are printed when the caller has color ANSI selected in his/her defaults. B&W files are printed when the caller has ANSI, but no color. MSG files are printed to callers without ANSI. MSG files are the default. In other words, if the caller is capable of seeing a ANS file, but it doesn't exist, the BBS will look for a B&W file. It that doesn't exist either, it will print the MSG file. So, you don't necessarily have to create ANS or B&W files. If you don't have one or the other, the BBS will use MSG. 2.15A WELCOME.MSG [ANS] This text file is printed out right after a caller connects, but before he logs on. You will probably want to change this so that it tells the name of your system, and perhaps gives a logo for your system. If you have a WELCOME.ANS file, the software will attempt to auto-detect whether or not the caller has ansi; if he does, then the Welcome.ANS message will be displayed; otherwise the system will show the Welcome.MSG. 2.15B LOGON.MSG [ANS, B&W] This file is printed out after a caller logs on, but before he gets to the main menu. This usually describes recent news that may affect the system. Once a caller is on the BBS, he can also access this file with an I at the Main Menu. 2.15C SYSTEM.MSG [ANS, B&W] This file describes your system. It should probably tell what type of system you run, what its purpose is, what hardware it is run on, and any other information you think necessary. This is the first text file printed out to new callers. It is also printed when the caller hits 'I' for system info. 2.15D NEWUSER.MSG This is the second text file printed out to new callers, and is printed out before they enter any information. It should describe what you expect from new callers. 2.15E FEEDBACK.MSG This text file is printed out after a new caller has entered his information, but before he sends validation feedback to the sysop. This should tell the caller what you expect to be told in the validation letter. 2.15F LOGOFF.MSG [ANS, B&W] This file is printed out just before a caller is logged off. 2.15G HELP.MSG This is a large file which holds the context-sensitive help information which is printed when the caller hits control-O. You probably will not need to change anything in it. 2.15H TRASHCAN.TXT This is a text file listing names (aliases) which you do not want your callers to be able to use. Usually, this file will contain a list of profane words, one per line, so that you won't have anyone using certain names on your board that you don't like. 2.16 Menus 2.16A MENUS.MSG This is a file which contains the menus WWIV may display at various times. If a MENUSANS.MSG file does not exist (and it should), callers will see the menus in this file. 2.16B MENUS40.MSG This file contains a list of menus shown to 40-column callers only. You don't really need to have this file. 2.16C MENUSANS.MSG This file contains menus displayed to callers who have ANSI selected. It may have true ANSI or WWIVansi codes. What does this mean? WWIV does not use true ANSI codes to display color to you or your callers. It uses what is called WWIVansi, which is a different system of encoding colors in text. When WWIV displays a file written with WWIVansi, it interprets the color codes and translates them to standard ANSI format. WWIV will still display standard ANSI files correctly, of course. WWIVansi is just a system you can use which doesn't force you to use ANSI editors or strange escape codes. At any rate, MENUSANS.MSG may have either format of ANSI in its menus. 2.16D MENU[0...14].MSG [ANS] Each menu has a number attached to it by WWIV. You can see these numbers listed at the beginning of each menu in the MENUS.MSG file. The BBS will first look for a file named MENU*.MSG [ANS], where * is a number from 0 through 14. If the caller has ANSI, the BBS will print the ANS version of the MENU file if it exists. Following are the numbers for the menus: 0 - Main Menu 1 - Message Base Commands 2 - Editor Commands 3 - File Transfer Menu 4 - Mail Menu 5 - Sysop and CoSysop Menu 6 - UEDIT Menu 7 - WFC Menu 8 - Sysop File Transfer Menu 9 - Batch Transfer Menu 10 - User Restriction Menu 11 - Sysop Editor Menu 12 - Multimail Menu 13 - Message Base Commands for Cosysops and Sysops 14 - Archiving Commands Menu Rather than editing menus within the MENUS.MSG or MENUSANS.MSG files, you can simply create the menu you want to change, name it with the format described earlier, and the BBS will print that menu instead of the one listed in one of the large menu files. For example, if you want to change what your main menu looks like, you can create a file with an ANSI editor (for color) or a text editor (for plain ASCII), name it MENU0.ANS (or MENU0.MSG), and place it in your GFILES directory. The BBS will print that menu when required. 3.0 SECTION THREE - EXECUTING THE BBS 3.1 Startup Now your system should be initialized, and you are ready to go about configuring it. To begin configuring your system, you first need to run the BBS. There are several command-line switches you may select when running the BBS. At the DOS prompt, the command format is: C> BBS [/Brate] [/Srate] [/Nlevel] [A/level] [/O] [/H] [/M] /B - someone already logged on at rate (specify 300, 1200, 2400, etc) /S - com port baud rate to use (if locked at 38400, etc) /N - normal exit level /A - abnormal exit level /O - quit WWIV after one caller done /H - don't hang up on caller when he disconnects /M - don't access modem at all /F - Used only with Hi-Speed Modems in conjunction with /B and /S /C - Echo controls (CTS/RTS) /R - Limit users remaining time to the integer followinr R. Most of the commands above are self-explanatory. Use /B if somebody is already connected to your modem and you want to run the BBS. If you don't, the BBS would attempt to initialize the modem upon startup, something you wouldn't want to happen if somebody was already on-line. /N and /A are normally used as a pair in a batch file. The following is an example of such a batch file: copy con wwiv.bat :bbs BBS /N0 /A1 %1 %2 %3 %4 %5 if errorlevel 1 goto bbs ^Z This batch file would run the BBS, allowing you to enter other switches if necessary. If the BBS aborted abnormally for any reason (you did NOT hit Q at WFC), the batch file would automatically reboot the BBS. If the BBS was terminated normally (you hit Q at WFC), the batch file would end. One last note about switches. The /M switch may be very useful to you as you initially set up your BBS. It causes the BBS to totally ignore the modem. So, you can run the BBS without a modem even attached to the computer. If you were to try that without the /M switch, the BBS would lock-up in it's attempt to initialize the modem. The /S, /F, /C, and /R parameters are normally only used when you are running a front end mailer like FrontDoor or Binkley Term or when you are running WWIV as a door from another BBS system. Once you've entered the BBS command to execute the BBS, you will see a copyright notice, the screen will clear, and "Waiting..." will flash on the screen for a moment. The "Waiting..." message means that the BBS is trying to initialize the modem. If after 30 seconds, the Waiting... message is still on the screen, you have a problem with your modem, or the BBS doesn't have the right information about your modem. If Waiting... is still on your screen for over 30 seconds, you will need to reboot your computer, and should then recheck the modem information in the INIT program. If that all looks correct, you should check your modem itself, perhaps running a terminal program to make sure everything is working correctly. Sometimes numbers will be observed after the "Waiting..." such as "Waiting...(0)...(0)...(4)..." These numbers have specific meanings. The (0) means that the modem did not acknowledge the codes which were sent. The (4) means that the modem returned an error response. When your modem is configured correctly, you should not see any numbers following the "Waiting..." After Waiting... disappears from the screen, the screen will be blank. The system is now waiting for a caller. This mode is termed WFC, for quick reference. 3.2 Creating the Sysop Account Your first task will be to log on with the sysop account. To do this, you will hit the spacebar at WFC. You will be asked if you want to log on. You do, so hit Y. You will be presented with the welcome message, and will be asked for your name or number or new. You will be new, so type "NEW" and hit [Enter]. You will be prompted for: your name/alias, real name, phone number, callsign, sex, birthdate, computer type, screen size, and ANSI support. The BBS does internal ANSI decoding, so you can always see ANSI locally. After entering this information, you will be presented with a list, and asked if you want to change anything. Make sure all is correct, and press Q. After verifying your password, you will be logged on and taken to the main menu. You now need to validate the sysop account. To do this, hit F1. A window will pop up in the middle of the screen which displays the current info about the account. You will want to set the SL and DSL to 255, and the AR and DAR to include the following "ABCDEFGHIJKLMNOP". To do this, enter 255 for SL, and hit [Enter]. You will now be at the AR prompt. Hold down Z until all letters appear. In the future, you can toggle letters by typing them. You can remove a letter by pressing the spacebar while the cursor is over the letter to be removed, and you can add consecutive letters by holding down any key that is not an AR setting itself (ie, not A-P). Hit [Enter], and repeat for DSL and DAR. If there are any restrictions highlighted, move the cursor to that character (with the left & right arrow keys), and hit the spacebar to remove that restriction (you can also press the letter which is indicated to toggle it on or off, just like with the AR and DAR). When done, hit escape (or F1 again) to quit back to the main menu. The procedure that you have just followed is known as on- line validation. If you should ever want to validate a caller that is on line, you will follow the same procedures although you would not give the user all ARS and DARS nor would you want to give him a 255 SL. The sysop account is now logged on and validated. Type /O to log off, and you will be returned to WFC. Please note that there are a few differences between logging on locally and logging on remotely. First, and most obviously, the ANSI welcome message (if present) and logon message are not printed out when you log on locally, because the system assumes you already know what they are. Furthermore, when logging on locally, you will not need to enter the system password. When you log on in the future locally, you can simply press F after pressing the spacebar. That will immediately log you on, without need of typing your password or phone number. It will also bypass the welcome message and information screen. You have completed initial setup of your bulletin board. However, you are far from going on-line with a full-featured BBS. What you have now is a rather barren bulletin board with one user account - your's. Your BBS will have one message base already installed, General, and two file directories, Sysop and Misc. There are no g-file sections, no on-line programs, no files for transfer, and no messages. Chances are, you do not have most text files prepared (for news, new callers, info, etc.). Make no mistake - you have a great deal of work ahead of you. Your next stop is the Sysop Guide To WWIV. It will show you in detail what your main BBS sysop options are. You will learn how to create and modify message bases and file directories. You will also see how on-line programs are installed, and how g-file sections are added. Your bulletin board as it is now is a shell, waiting for you to personalize with your own interests. 4.0 APPENDICES 4.1 Table of Contents Section Description Page 1.0 SECTION ONE; INITIAL SETUP .............. 2 1.1 History ................................ 2 1.2 Hardware Requirements .................. 2 1.3 Definitions of Common Terms ............ 2 1.3A SL ................................... 2 1.3B DSL .................................. 3 1.3C AR ................................... 3 1.3D DAR .................................. 3 1.3E Sub .................................. 4 1.3F WFC .................................. 4 1.3G Sysop ................................ 4 1.3H Co-Sysop ............................. 4 1.3I Limited Co-Sysop ..................... 4 1.3J SysopSub ............................. 4 1.3K Exemptions ........................... 4 1.3L Restrictions ......................... 5 1.4 Installing WWIV ........................ 5 2.0 SECTION TWO - PRIMARY CONFIGURATION ...... 6 2.1 Using Init ............................. 6 2.2 Option 1 - System Info ................. 7 2.2A System Password ...................... 7 2.2B System Name .......................... 7 2.2C System Phone ......................... 7 2.2D WWIV RegNumb ......................... 7 2.2E Newuser Password ..................... 7 2.2F Newuser Restrict ..................... 7 2.2G Newuser SL ........................... 7 2.2H Newuser DSL .......................... 8 2.2I Newuser Gold ......................... 8 2.2J Sysop Name ........................... 8 2.2K Sysop Low Time ....................... 8 2.2L Upload Ratio ......................... 8 2.2M Post/Call Ratio ...................... 9 2.2N Max Waiting .......................... 9 2.2O Max Users ............................ 9 2.2P Caller Number ........................ 9 2.3 Option 2 - More System Info ............ 9 2.3A System Number ........................ 9 2.3B Net Low Time ......................... 9 2.3C Net High Time ........................ 10 2.3D Closed System ........................ 10 2.3E Local System ......................... 10 2.3F Beep for Chat ........................ 10 2.3G Phone Off Hook ....................... 10 2.3H Two-Color Chat ....................... 10 2.3I Two-Way Chat ......................... 10 2.3J Allow Aliases ........................ 10 2.3K Close Transfers ...................... 11 2.3L All UL to Sysop ...................... 11 2.3M Sysop Log to Printer ................. 11 2.3N Use LIST Utility ..................... 11 2.3O Free Format Phone .................... 11 2.3P Notify User of DL .................... 11 2.4 Option 3 - Paths ....................... 11 2.4A Messages Dir ......................... 12 2.4B Gfiles Dir ........................... 12 2.4C Data Dir ............................. 12 2.4D Dloads Dir ........................... 12 2.4E Temp Dir ............................. 12 2.4F Batch Dir ............................ 12 2.5 Option 4 - Modem Info .................. 13 2.5A Com Port ............................. 13 2.5B Interrupts ........................... 13 2.5C Base Addresses ....................... 13 2.5D Slow Uart ............................ 14 2.6 Option 5 - Select Modem Type ........... 14 2.7 Option 6 - External Events & Archives .. 14 2.7A Terminal Program ..................... 14 2.7B BeginDay Event ....................... 15 2.7C Logon Event .......................... 15 2.7D Newuser Event ........................ 15 2.7E Upload Event ......................... 15 2.7F External Event ....................... 15 2.7G Time for Event ....................... 15 2.7H Archive Extension .................... 15 2.7I List Archive ......................... 16 2.7J Extract Archive ...................... 16 2.7K Add to Archive ....................... 16 2.8 Option 7 - External Protocols .......... 17 2.9 Option 8 - External Editors ............ 17 2.10 Option 9 - SecLev Data Change .......... 18 2.10A Security Level ....................... 18 2.10B Time Per Day ......................... 18 2.10C Time Per Logon ....................... 18 2.10D Messages Read ........................ 18 2.10E Emails Per Day ....................... 18 2.10F Posts Per Day ........................ 18 2.10G Post Anony ........................... 18 2.10H Email Anony .......................... 18 2.10I Read Anony Posts ..................... 19 2.10J Read Anony Email ..................... 19 2.10K Limited Co-Sysop ..................... 19 2.10L Co-Sysop ............................. 19 2.11 Option 10 - Auto-Validation Data Change. 19 2.12 Option A - Auto-Detect Modem Type 19 2.13 Option N - Multiple Network Setup 19 2.14 Option U - Userrec Update 19 2.15 General Text Files - Especially Default. 19 2.15A Welcome.Msg .......................... 20 2.15B Logon.Msg ............................ 20 2.15C System.Msg ........................... 20 2.15D Newuser.Msg .......................... 20 2.15E Feedback.Msg ......................... 20 2.15F Logoff.Msg ........................... 20 2.15G Help.Msg ............................. 20 2.15H Trashcan.Txt ......................... 21 2.16 Menus .................................. 21 2.16A Menus.Msg ............................ 21 2.16B Menus40.Msg .......................... 21 2.16C Menusans.Msg ......................... 21 2.16E Menus [0...14] ....................... 21 3.0 SECTION 3: EXECUTING THE BBS .......... 22 3.1 Start up ............................... 22 3.2 Creating the Sysop Account ............. 23 4.0 APPENDICES ............................. 25 4.1 Table of Contents ...................... 25