---------------------------------------------------------------------oooo oooo 8888o 888 oooo oooo 88 888o8 88 888 888 88 888 88 888 888 o88o 8 o88o 8888

o8o888 oooooooo8 ooooooooooo ooooo oooooooo8 888 88 888 88 888 o888 88 888oooooo 888 888 888 888 888 888 888o oo o88oooo888 o888o o888o 888oooo88 Ascii Art by The Dutch Dude '98

Mystic BBS Sysop Documentation Copyright (C) 1997-1999 By James Coyle. All Rights Reserved All mentioned programs are copyrighted by their respected authors. ---------------------------------------------------------------------MYSTIC BBS OFFICIAL SUPPORT ---------------------------------------------------------------------Support for Mystic BBS can be found all over the internet! Below is a list of internet support sites: WWW: http://www.geocities.com/SiliconValley/Horizon/9426 http://www.mysticbbs.com E-MAIL: mysticbbs@geocities.com USENET: alt.bbs.mystic IRC: #mysticbbs (efnet) MAILING LIST: You can join the official Mystic BBS mailing list by sending e-mail to "listserv@dar tech.org" with the message body of: "subscribe mystic". You will then receive a welcome message for the mailing list. ---------------------------------------------------------------------READ THIS NOW READ THIS NOW READ THIS NOW READ THIS NOW ---------------------------------------------------------------------These DOCs are not yet completed. I will be wor ing on them as time permits. If you are very familiar with Mystic BBS and would li e to help write the documentation, please e-mail me or sign my suggestion boo on the Mystic BBS web page. I would appreciate any help I can get as writing the DOCs ta es a lot of time from the development of Mystic BBS. Please also read the HISTORY.DOC file which was included with the archive. It explains a lot of things that have not yet been covered in the DOCs. Between MYSTIC.DOC and HISTORY.DOC, you should be able to get a good idea of what Mystic BBS offers and how to use it. ---------------------------------------------------------------------DONATIONS DONATIONS DONATIONS DONATIONS DONATIONS ---------------------------------------------------------------------Mystic BBS is donation ware. This means that the software is free,

and no registration fee is required. However, it is as ed that if you do use Mystic BBS software that you ma e a monitary contribution to the Mystic BBS developement fund of $25 or more. Especially if you're using Mystic BBS in a commercial environement. If you can profit from Mystic, why shouldn't you donate to help eep it around? All donations received are used STRICKLY for development of Mystic BBS software, and NOTHING else. For example, had it not been for the donations made by both Sonic and Sloop, Mystic BBS would not currently have it's Win32 and OS/2 native versions. Some of the things that I plan to use donated money and hardware for are: A native Linux port of Mystic BBS. Many people have been requesting this lately, but without enough donations to put together a cheap computer for Linux programming, a native Linux port will not become reality. I'm also in need of a Linux RedHat installation CD to ma e my life easier! =) If you would li e to ma e a donation, please either send e-mail to me at mysticbbs@geocities.com or send a US chec or money order to: James Coyle (c/o Mystic BBS) 702 S. Catherine Street Bloomsburg, PA 17815 USA All people who ma e donations can optionally have their name and BBS information listed at the end of the Mystic BBS documentation. If you would li e your name / BBS name listed, please supply such information along with your donation. ** Sending cash in the mail is a ris . If the mail gets lost, so does ** your cash. It is advised that you send a US chec or money order ** ONLY. ----------------------------------------------------------------------GENERAL INFORMATION ABOUT RUNNING MYSTIC BBS ----------------------------------------------------------------------This section contains some information on things that are not documented yet. I add stuff here as I thin of it, so this section probably isn't completed. Errorlevels returned by Mystic BBS: 0 1 5 6 7 255 --Sysop commands while a user is online: ALT B Change status bar display Normal exit Critical Error New FidoNet mail has been entered. New UseNet (newsgroup) mail has been entered. Both FidoNet and UseNet mail has been entered. (Q)uit from WFC menu was selected

--DOOR MCI Codes: (used when running a door only) %0 %1 %2 %3 --General notes (UNDOCUMENTED FEATURES): 1. NEWUSER.MPE is executed (if it exists) after a user saves their new user information. ComPort handle (Win32 and OS/2 versions only) ComPort Baud Rate Node number

Mi e Hunt Homer Simpson If the above were the contents of TRASHCAN.DAT in the data directory, Mystic will refuse to allow new users to use those listed names. 3. When editing menus, the following can be used in the "hot ey" field of the menu command: FIRSTCMD : Automatically run the command each time the menu is loaded. EVERY : Automatically run the command each time the menu is redrawn (before its actually redrawn) AFTER : Automatically run the command each time the menu is redrawn, just before the prompt is displayed. When editing menus, the following can be used in the "hot ey" field of the menu command in NON-LIGHTBAR menus only:

---------------------------------------------------------------------

ENTER ESCAPE TAB RIGHT LEFT UP DOWN

: : : : : : :

Use Use Use Use Use Use Use

the the the the the the the

ENTER ey as the hot ey ESCAPE ey as the hot ey TAB ey as the hot ey RIGHT arrow as the hot ey LEFT arrow as the hot ey UP arrow as the hot ey DOWN arrow as the hot ey

2. TRASHCAN.DAT (stored in the data directory) can be used to bloc certain user names from being used by a new user. This file is a straight DOS ASCII file with one user name per line. For example:

ALT C ALL E ALT H ALT J ALT S ALT T ALT U ALT + ALT F1..F4

Brea into line chat mode Edit the online user's account Hang-up on user Shell to DOS Brea into split screen chat mode Toggle status line mode (2 line, 1 line, or none) Upgrade user to a defined security level. Add a minute to the user's time left. Subtract a minute to the user's time left Definable SysOp macros.

About Mystic BBS --------------------------------------------------------------------Mystic BBS is a full featured BBS pac age written from the ground up. It is not a hac of any existing BBS software - it has been developed from scratch in highly optimized Pascal and Assembler code. The project goal for Mystic BBS is to produce a fast and reliable BBS pac age which offers features not found in any other BBS pac age, and features previously only found in expensive commercial pac ages. At this time, Mystic BBS is donation ware. It is free for use, but if you do run Mystic, it's as ed that you ma e a donation towards future development of Mystic BBS. See above section of DONATIONS for more information, or REGISTER.DOC which is included with the distribution archive. Mystic BBS is copyright (C) 1997-1999 by James Coyle All Rights Reserved --------------------------------------------------------------------System Requirements --------------------------------------------------------------------Minimum requirements to run a bulletin board with Mystic BBS Software for DOS: * * * * * * IBM or compatible with at least a 286 CPU. DOS 3.0 or compatible operating system with SHARE.EXE loaded. 512 RAM. 1 megabyte of dis space. 300 BPS modem or higher. Revision 5 FOSSIL driver (such as X00 or BNU).

While it is probably possible to run Mystic BBS on a 286/12 with only floppy dis drives and a 300bps modem, it is DEFINETLY not suggested. Minimum requirements to run a bulletin board with Mystic BBS software for Windows: * IBM compatible with at least a 486 CPU. * Win32-compatible operating system, such as: - Windows 95 - Windows 98 - Windows NT Mystic may run also run under Windows 3.1 with Win32, as well as OS/2 with Win32 support, but it has not been tested. * 1 megabyte of dis space. * Serial modem, or a virtual modem driver. Minimum requirements to run a bulletin board with Mystic BBS software for OS/2: * IBM compatible with at least a 486 CPU * OS/2 compatible operating system, such as:

- OS/2 v2.1 - OS/2 Warp v3.0 - OS/2 Warp v4.0 Mystic may also run on other versions of OS/2 as well. * 1 megabyte of dis space. * Serial modem, or a virtual modem driver. --------------------------------------------------------------------DISCLAIMER --------------------------------------------------------------------By attempting to install Mystic BBS, you understand and agree that the author of Mystic BBS ma es no guarantees that this program will do anything other than ta e up space on your drive. The author will not be held responsible for any damage caused by the use, or misuse, of Mystic BBS or any of it's included programs. By continuing to use this program, you hearby agree that the author shall not be held liable for any reason, under any circumstance, due to the use of this program. If you do not agree with this disclaimer, delete this program and do not use it until you are willing to abide. --------------------------------------------------------------------Starting Mystic BBS --------------------------------------------------------------------There are many command line options which can be used when executing Mystic BBS. For example, when starting Mystic for the first time, the option "-L" should be added on the command line. This will tell Mystic to run in "local" mode, meaning it will not try to communicate with the modem. This will need to be done in order to enter the Modem Configuration and set up your modem properly. The following command line options are available: -L - This option will tell Mystic BBS to run in local mode, meaning that it will not try to send any commands to the modem. If Mystic is returning a modem initialization error, then this command should be ran so the modem can be properly configured for Mystic BBS. This command is also useful if running an external mailer or any type of front door software. -Nx - This option is used to specify which node of Mystic BBS to load. The x is replaced with the node number that is to be loaded. For many SysOps, this can be ignored. It is only needed if multiple phone lines are being used. For more information, see the Running Multi-Node section below. -Bx - This option is used to tell Mystic BBS that a user has already been connected through other software. When this command is passed, Mystic BBS will s ip the Waiting For Call screen and go directly to the user login procedures. The x is replaced with the baud rate which the user is connected at. This command line is normally used if you are running a mailer frontend, or running Mystic BBS as a door from some other software.

-Tx - This option is used along with the -B command to specify the the maximum number of minutes to give the user. The X is the number of minutes the user will be able to remain online. This command is normally used when you are running your BBS from a frontend and the frontend software has an upcoming event. --------------------------------------------------------------------Waiting for Call Screen --------------------------------------------------------------------When Mystic BBS is executed, the first thing you will see is the Waiting for Call Screen. This screen will give you access to all of the configuration options of your BBS, as well as answer any incoming phone calls to your BBS. The following options are available from the Waiting for Call screen: [SPACE] Local Login ------------------This option will allow the Sysop to log into the BBS system locally. [#] Menu Editor --------------This option will allow all the menus that callers will see to be edited in almost any way possible. The menu system is the bac bone of the BBS. For more information, see the Menu Editor section below. [A] Archive Editor -----------------This option will allow archive software to be configured into the BBS for use in compressing messages and files. For more information, see the section on the Archive Editor below. [E] Event Editor ---------------This option will allow system events to be configured. A system event can be used to automatically shell to the operating system and run any number of utilities or functions that you might want to run. For more information, see the Event Editor section below. [F] File Base Editor -------------------This option will allow the SysOp to set up the file base section where software can be transferred to and from the system For more information, see the File Base Editor section below. [G] Group Editor ---------------This option will allow the setup of "groups", which can be used to categorize both file and message bases together. For more information on this, see the Group Editor section below. [L] Security Level Editor ------------------------This option will allow security access levels to be configured.

For more information, see the Security Level Editor section. [M] Message Base Editor ----------------------This option will allow message conferences to be setup in the BBS. Mystic supports local message bases as well as networ ed message bases (such as FidoNet) with extra 3rd party utilities. For more information on this, see the Message Base Editor section below. [P] Protocol Editor ------------------This option will allow file transfer protocols to be setup with Mystic BBS. File transfer protocols are used to transfer files to and from the BBS system. For more information, see the Protocol Editor section below. [S] System Configuration -----------------------This option is where all the general information about your BBS is defined. For more information, see the System Configuration section below. [U] User Editor --------------This option will allow editing of the user database. All information stored about each system user can be edited in the User Editor. For more information see the User Editor section below. [V] Voting Booth Editor ----------------------This option will allow the editing of the voting booth questions. For more information, see the Voting Booth Editor section below. [PGUP and PGDN] Node Status Window ---------------------------------This option will allow the "node status" window to be scrolled. Mystic BBS currently supports up to 255 simultaneous connections, all of which have their status listed in the status window. --------------------------------------------------------------------Using the ACS System (Access Command Strings) --------------------------------------------------------------------The ACS system is used throughout the BBS to limit access to certain commands and functions. It is an extremely powerful system designed to give the SysOp total control over who can do what. In any of the configuration editors where there is an ACS field, these commands are to be used. Mystic supports the following ACS commands: Ax - This command is used to chec the user's age. Where X is the age the user must be in order to pass.

Dx

- This command is used to chec if a user has a certain flag toggled ON in their SECOND set of flags. Where X is the flag which the user must have in order to pass. For

example: DA will require the user to have user access flag D in flag set 2 in order to pass. Ex - This command is used to chec the user's current graphics mode. Where X is one of the following: 1 - User must have ANSI graphics 0 - User must have ASCII (none) graphics. Fx - This command is used to chec if a user has a certain flag toggled ON in their FIRST set of flags. Where X is the flag which the user must have in order to pass. For example: FA will require the user to have user access flag A in flag set 1 in order to pass. Gx - This command is used to chec if a user is in a certain message group. Where X is the number of the group as listed in the message group editor. For example: G1 will require the user to be in message group #1 in order to pass. Hx - This command is used to chec if a user is accessing a command at a certain hour. Where X is the hour in the 24-hour mode (ie 00 is midnight or after, 23 is 11pm or after). For example: H12 will prevent the user from accessing this command before 12 noon on any given day. Nx - This command is used to chec if a user is online a certain node number. For example: N1 will require that the user is currently logged in on Node 1 in order to pass.

OI - This command is used to chec if a user's node status is invisible to other nodes. It will be set TRUE if the user is invisible, false if not. OK - This command is used to chec the result of the last called Boolean menu command. For more information, see the menu commands: -P, -Y, and -N. OP - This command is used to chec the status of the user's post / call ratio. If the user meets the currently set ratio, then OP will be true - otherwise, if will return false. This option is useful to restrict users from downloading if they're not active message posters. Sx - This command is used to chec if a user meets a certain security level. For example: S20 will require the user to have a security level of 20 or higher in order to pass. Tx - This command is used to chec if a user has at least X minutes remaining in online time. For example: T10 would require the user to have a least 10 minutes of remaining time in order to pass.

OA - This command node message receive node they are not

is used to chec the status of the user's availibility. If the user is able to messages, OA will return true. False if available.

Ux - This command is used to chec a user's permanent user number, where X is the number of the permanent index the user must match. For example: U1 would require the user to have the permanent user index of 1. Each user's permanent index is listed in the user editor, and no two users will ever have the same permanent index number. Zx - This command is used to chec if a user is in a certain File Group. Where X is the number of the group as listed in the File Group editor. For example, Z1 will require the user to be in File Group #1 in order to pass the ACS chec . Any of the above commands can be used together to create an ACS string used by Mystic BBS. Below are some examples of how they can be used: s255 - User must have security of 255 or higher. s255n1fA - User must have a security level of 255 or higher, be currently logged into Node 1, and have user flag A toggled on, in order to pass this ACS string. s10z1h12 - User must have a security level of 10 or higher, be currently in File Group #1, and be accessing this function after 12:00 noon, in order to pass this ACS string. For added flexibility, Mystic also supports five logical operators which can be used in ACS strings: & | ! ^ % = = = = = Logical AND Logical OR Logical NOT Always TRUE Always FALSE

In addition to the operators, Mystic BBS also allows parenthesis in ACS strings to allow evaluation of grouped ACS commands. Some examples of using operators and grouping are: ^ % Always returns TRUE. Grants access to ALL users. Always returns FALSE. Grants access to NO users, not even the SysOp. s10!s20 User must have a security level which is at least 10 but NOT 20 or greater. t20|s255 User must have 20 minutes of time remaining, OR have a security level of 255. !(s255|fa) User must NOT have a security level of 255 and flag A toggled on. (s20fa)|(s255) User must have a security level of 20 with flag A toggled on, *OR* have a security level of 255 or higher. As you can see, the access command system gives Mystic BBS an incredible amount of flexibility when it comes to system security! --------------------------------------------------------------------[S] System Configuration --------------------------------------------------------------------The System Configuration is where setting up the BBS begins. Here is where all of the basic BBS definitions are found, including System

Paths, Modem Setup, and more. Below is a screen capture of what the System Configuration screen loo s li e, followed by an explanation as to what each option does. System Configuration A. B. C. D. E. F. L. N. System Paths Modem/Node Settings General Settings File Area Settings Message Area Settings Networ Settings Language Editor New User Settings

Command (Q/Quit): ---------------------------------------------------------------[A] System Paths (System Configuration Editor) ---------------------------------------------------------------The system paths option will allow you to setup and change the directories that Mystic BBS will use to store and process it's data files. These paths are setup initially by the installation program and in most cases they don't need to be changed. The follow options are available in the System Paths setup: System Paths A. B. C. D. E. F. G. H. I. System Path : Data Path : Message Base Path: System Logs Path : Protocol Path : Archive Path : Local QWK Path : File Attach Path : Script Path : C:\MYSTIC\ C:\MYSTIC\DATA\ C:\MYSTIC\MSGS\ C:\MYSTIC\LOGS\ C:\MYSTIC\FILES\ C:\MYSTIC\ARCS\ C:\MYSTIC\ C:\MYSTIC\ATTACH\ C:\MYSTIC\SCRIPT\

Command (Q/Quit): [A] System Path --------------The system path is the main BBS directory where MYSTIC.EXE and its supporting files are located. In almost all cases, this directory never needs to be changed. [B] Data Path ------------The data path is the directory where Mystic BBS will store all of it's data files. In almost all cases, this directory never needs to be changed. [C] Message Base Path --------------------The message base path is the default directory where Mystic BBS will store it's message base data files. Mystic BBS also allows the option of storing each message base in a different directory, but in most cases this is not needed and will just clutter up your hard drive. For more information on storing

message bases in different directories, see the Message Base Editor section. [D] System Logs Path -------------------The system logs path is the directory where Mystic BBS will eep an updated log file of BBS activity. The log files can be used to see what each caller was doing while they were online. These files are not used by Mystic BBS at all and exist for information purposes only. It is a good idea to delete the files in this directory every so often so they do not become large and waste drive space. [E] Protocol Path ----------------The protocol path is the directory where all external protocol drivers are stored. For more information on file transfer protocols, see the Protocol Editor section. [F] Archive Path ---------------The archive path is the directory where all external archive utilities are stored (ie PKZIP.EXE, RAR.EXE, ARJ.EXE, etc). For more information on archives, see the Archive Editor section. [G] Local QWK Path -----------------The local QWK path is the directory where Mystic BBS will create QWK offline mail pac ets if the user is logged into the BBS locally. This directory usually points to the same directory of your offline mail reader, if you use one. For more information, see the QWK Offline Mail section. [H] File Attach Path -------------------The file attach path is the directory where Mystic BBS will store files that are attached to messages. Mystic BBS allows users to optionally include a file to any message posted on the BBS system. [I] Script Path --------------The script path is the directory where all compiled Mystic BBS programming files are found. Mystic BBS supports an internal programming language that can be used by SysOps to create games, utilities, or BBS enhancements with ease. For more information see the MPL.DOC file included with Mystic BBS. ---------------------------------------------------------------[B] Modem/Node Settings (System Configuration Editor) ---------------------------------------------------------------The Modem/Node setup is where all information about the modem used on the currently loaded node is defined. Mystic BBS requires the use of a FOSSIL driver in order to communicate with a modem. A FOSSIL driver is a program which is loaded before the BBS software and provides the software with an easy way to communicate with many different types of modem setups. Most

FOSSIL drivers are free for non-commercial use and can be found on various BBSs and throughout the Internet. They are always available on the Mystic BBS web site and the Mystic BBS support BBS if they can not be found somewhere else. Below is a screen capture of the Modem/Node Settings screen followed by an explanation of what each option does: Node 1 Settings A. C. E. F. G. H. I. J. Com Port RTS/CTS Flow Modem Init Modem Hangup Modem Offhoo Modem "OK" Modem "RING" Modem "ATA" 1200 4800 9600 14400 19200 24000 28800 33600 57600 : : : : : : : : : : : : : : : : : 4 Yes ATZV1| +++~~~~ATH0|~~~~ ATM0H1| OK RING ATA 1200 4800 9600 14400 19200 24000 28800 33600 57600 2. 4. 6. 8. 10. 12. 14. 16. 18. B. Baud Rate : 38400 D. XON/XOFF Flow: No

1. 3. 5. 7. 9. 11. 13. 15. 17.

CONNECT CONNECT CONNECT CONNECT CONNECT CONNECT CONNECT CONNECT CONNECT

Command (Q/Quit): [A] Communication Port ---------------------This defines the communication port that your modem is setup on. Valid communication ports are usually 1 through 4, but in some cases can be setup to use other ports. For more information on the Com Port, please refer to the instruction manual that came with your modem. If you are still having problems, try reading the documentation that came with the FOSSIL driver, or possibly the instruction manual for the operating system (ie Windows, DOS, OS/2) that is being used. [B] Modem Baud Rate ------------------This option defines what modem speed to use with the FOSSIL driver. Valid baud rates are currently 300 through 38400 although some FOSSIL drivers allow baud rates up to 115200. For more information on this setting, please refer to the documentation that came with your FOSSIL driver. [C] RTS/CTS Flow Control -----------------------This option defines whether or not Mystic BBS will open the FOSSIL driver with RTS/CTS hardware flow control. Mystic BBS has this option toggled to Yes by default, and in most cases it shouldn't need to be changed. For more information on RTS/CTS flow control, please refer to your modem or FOSSIL documentation. [D] XON/XOFF Flow Control

K. Telnet Node : Yes 2400 7200 12000 16800 21600 26400 31200 38400 115200 : : : : : : : : : CONNECT CONNECT CONNECT CONNECT CONNECT CONNECT CONNECT CONNECT CONNECT 2400 7200 12000 16800 21600 26400 31200 38400 115200

------------------------This option defines whether or not Mystic BBS will open the FOSSIL driver with XON/XOFF software flow control. Mystic BBS has this option toggled to No by default, and in most cases it shouldn't need to be changed. For more information on XON/XOFF flow control, please refer to your modem or FOSSIL documentation. [E] Modem Initialization Command -------------------------------This option defines the modem initialization command, which is sent to the modem upon the startup of Mystic BBS. This command is used to set the modem to wor with Mystic BBS. By default, Mystic BBS expects your modem to NOT answer the phone when a ring is detected, and to return verbose connect strings such as CONNECT x (where x is the baud rate). With many modems these options are already on by factory default, but in some cases they are not. If Mystic BBS is having problems answering incoming calls, please refer to your modem manual for the proper modem commands. [F] Modem Hangup Command -----------------------This option defines the modem hangup command, which is sent to the modem after a user terminates the call to the BBS. This command should tell your modem to hangup if it is connected to another modem. In many cases, the default hangup command will wor , but in some cases it will not. If Mystic BBS is having problems hanging up the phone after each call, you may need to refer to your modem instruction manual for modem commands that will wor . [G] Modem Offhoo Command ------------------------This option defines the modem offhoo command, which is sent to the modem before a local login. This command is used to ta e the modem offhoo so if someone dials the BBS, the phone line reports a BUSY signal. In most cases the default offhoo command will wor , but if the BBS phone is still ringing during a local logon, you will need to refer to your modem instruction manual for the command to ta e your modem offhoo . [H] Modem "OK" Result --------------------This option defines the result string that your modem returns when a modem command has been sent successfully. In almost all cases "OK" is returned by a modem when a successful command has been entered, but if Mystic is having problems communicating with your modem, you may need to chec your modem instruction manual to ma e sure that it returns an OK. [I] Modem "RING" Result ----------------------This option defines the result string that your modem returns when a RING is detected. In almost all cases, a modem will return the text "RING", but if Mystic is having problems answering incoming phone calls, you may need to refer to your modem instruction manual and adjust this command accordingly.

[J] Modem "ATA" Command ----------------------This option defines the command that is sent to the modem to ma e it answer an incoming phone call. In almost all cases the default "ATA" command will wor , but if Mystic is having problems answering incoming phone calls, you may need to refer to your modem instruction manual and adjust this command accordingly. [K] Telnet Node --------------This option should be toggled on if this node is setup to receive callers via Telnet. This option will cause Mystic to return "TELNET" as the user's baud rate as well as list "TELNET" in the WFC screen's Node Status window. [1 to 18] Modem Connection Strings ---------------------------------These commands are used to define the result strings that your modem returns when a connection has been made, and the connection speed that goes along with each result string. In some cases the default connection strings will wor with your modem. If Mystic is not ta ing the user into the BBS after a connection has been made, you may need to refer to your modem instruction manual to see what baud rates your modem supports and the result strings that go along with each baud rate. ---------------------------------------------------------------[C] General Settings (System Configuration Editor) ---------------------------------------------------------------The General Settings section is where all the general options of the BBS are defined. Below is a screen capture of the General Settings screen followed by an explanation as to what each option does: General Settings A. B. C. D. E. F. G. H. I. J. K. L. M. N. O. P. R. S. BBS Name Sysop Name System PW Sysop PW : Another Mystic BBS : Sysop : : SYSOP MAIN MAIN DEFAULT 1 5 180 00:00 23:59 Yes Yes Detect s255 s255 2 line 1. 2. 3. 4. F1 F2 F3 F4 Macro: Macro: Macro: Macro:

Default Start MNU : Default Fallbac : Default Language : Max # of Nodes : Screen Saver : Inactive Timeout : Chat Hours Start : Chat Hours End : Allow Sysop E-mail : Sysop Chat Logging : Login Terminal Mode: BBS List Edit ACS : Invisible Login ACS: Status Line Type :

Command (Q/Quit): [A] BBS Name -----------This option is used to define the name of your BBS. [B] System Operator (SysOp) Name -------------------------------This option is used to define the name of the System Operator (SysOp). [C] System Password ------------------This option is used to define a system password, which can be used if you wish to run a private BBS system which only someone who nows the password can access. If this option is left blan , the system password option will be disabled. If a system password is set, Mystic BBS will prompt the caller for the system password IMMEDIATELY after connecting to the BBS - before displaying anything else. If the user does not correctly enter the system password, the display file CLOSED.XXX will be displayed, and the call will be terminated. [D] Sysop Password -----------------This option is used to define the Sysop password. Any time one of the Sysop-related menu commands or functions is selected, the user will have to correctly input this password in order to access that Sysop function. [E] Default Start Menu ---------------------This option is used to define the default start menu. The start menu is the first menu that the user will see after logging into the BBS. It can be optionally defined by security level, or for each individual user. If a start menu is NOT defined for the user's security level or for that specific user, Mystic BBS uses the default start menu as the first menu that the user will see. For more information on the start menu, see the Security Level Editor section and/or the User Editor section. [F] Default Fallbac Menu ------------------------This option is used to define the default fallbac menu. The fallbac menu is the menu that is loaded if the menu the user is trying to access doesn't exist. The fallbac menu can be set for each menu in the Menu Editor, but if a fallbac menu is not defined for the menu the user is trying to access, Mystic will use the default fallbac menu. [G] Default Language File ------------------------This option is used to define the default language file. Mystic BBS supports the use of an unlimited number of language definitions which can be used to customize the the interface of your BBS. The default language file MUST exist in the data directory, or Mystic BBS will return an error. For more information on the Language system, see the Language Editor section.

[H] Maximum Number of Nodes --------------------------This option is used to define the maximum number of nodes currently in use. Each copy of Mystic BBS is a node. If you have multiple phone lines and need to run multiple copies of Mystic BBS, then each copy of Mystic you are running is a node. For more information see the section on Setting up a Multi-Node BBS. [I] Screen Saver ---------------This option is used to define the number of minutes of inactivity to wait before activating the screen saver. When running a BBS, the software can sometimes sit idle between calls for quite a while. A screen saver has been implemented to prevent screen burn-in while waiting for calls. [J] Inactivity Time Out ----------------------This option is used to set the number of seconds a user can be idle before Mystic BBS will hang up on them for inactivity. [K] Sysop Chat Hours - Start ---------------------------This option is used to define when the Sysop will be available for chat. If a user tries to page the Sysop during off hours, Mystic will not activate the page bell, but instead inform the user that the SysOp is not available and optionally as the user if they'd li e to send e-mail to the Sysop. [L] Sysop Chat Hours - End -------------------------This option goes along with the above option which defines the SysOp chat hours. [M] Allow Sysop E-Mail ---------------------If this option is set to Yes, the user will be as ed if they would li e to send e-mail to the SysOp if they try to page during off chat hours. [N] SysOp Chat Logging ---------------------If this option is set to Yes, Mystic BBS will record SysOp chat sessions to CHAT.LOG found in the logs directory. [O] Login Terminal Mode ----------------------This option sets how Mystic handles getting the users terminal emulation. If set to As , Mystic will as the user. If set to detect, Mystic will attempt to detect which terminal emulation to use. If set to Detect/As , Mystic BBS will attempt to detect and if ANSI isn't detected, the user will be as ed. [P] BBS List Edit ACS ---------------------

This option defines the ACS string required to edit entries in the BBS list. Mystic will also allow the user who added the entry in the BBS list to edit it regardless of this ACS string. [R] Invisible Login ACS ----------------------This option defines the ACS string required for a user to have the option of logging onto the BBS as "invisible" mode. When a user is logged in as invisible, they will not appear in any of the Who's Online listings. [S] Status Line Type -------------------This option defines the type of "status line" that Mystic BBS will use. The status line is at the bottom of the screen where information on the logged in user is displayed. Valid options are 1 line, 2 lines, and none. This can also be toggled by pressing ALT-T while a user is online. [1-4] Sysop Macro ----------------These options define the SysOp macros. A SysOp macro is text that is displayed whenever a macro ey is pressed. Mystic supports four macro eys: F1 through F4. The text defined for each of these eys will be pushed into the input buffer whenever they are pressed, just as if it was actually typed in. ---------------------------------------------------------------[D] File Area Settings (System Configuration Editor) ---------------------------------------------------------------The File Area Settings section is where all options relating to the file transfer bases are found. Below is a screen capture of the File Area Settings screen followed by an explanation of what each option does: File Settings A. Compress area numbers : Yes B. File area list columns: 2 C. D. E. F. G. H. I. J. K. L. M. Import FILE_ID.DIZ : Max File Desc. Lines : Auto-validate ACS : See unvalidated files : DL unvalidated files : See Failed Files : DL Failed Files : Min UL Space ( b) : Min CD Copy Space ( b): Redisplay File Header : Default Upload Base : Yes 20 s255 s255 s255 s255 s999 1000 1000 Yes 0

N. Test uploaded files O. Pass errorlevel P. Test command line Command (Q/Quit):

: No : 0 :

[A] Compress File Area Numbers -----------------------------This option, if toggled on, will compress file area numbers so they are always sequential during a file area list. So in a file area list, if a user does not have access to area number 2, then the next area that the user does have access to will become area number 2. [B] File Area List Columns -------------------------This option allows the number of columns used in the file area lists to be configured. Valid options are 1 or 2 columns. Note: If you change this to 1 column listings, you will have to edit the file area list prompt to reflect a single listing. [C] Import FILE_ID.DIZ ---------------------This option, if toggled on, will allow Mystic BBS to search all uploaded files for a FILE_ID.DIZ file. The FILE_ID.DIZ file is included in many archives and contains a description of the file. If this file is found, Mystic BBS will automatically read the description and use it as the file description in the file listing. [D] Max File Description Lines -----------------------------This option defines the maximum number of file description lines which can be used for each file entry. It must be within the range of 1 to 99. [E] Auto Validate ACS --------------------This option defines the ACS string a user must pass in order for the files they upload to be mar ed as validated. If they do not pass this ACS string, the files will be mar ed as unvalidated. [F] See Unvalidated Files ACS ----------------------------This option defines the ACS string a user must pass in order for unvalidated files to appear in a file listing. [G] Download Unvalidated Files ACS ---------------------------------This option defines the ACS string a user must pass in order to download a file that is mar ed as unvalidated. [H] See Failed Files ACS -----------------------If upload testing is toggled on and a file fails the upload test, they will be mar ed as "failed". This option defines the ACS a user must have to see files which have failed the upload test in their file listing. [I] Download Failed Files ACS ----------------------------This option defines the ACS a user must meet in order to download a file which has been mar ed as "failed".

[J] Minimum UL Space ( b) ------------------------Mystic BBS has the option to refuse to accept uploaded files when drive space gets low. This option sets the number of ilobytes that must exist in order for Mystic BBS to accept uploads. If this option is set to zero (0), it will be disabled. [K] Minimum CD Copy Space ( b) -----------------------------This option specifies the number of ilobytes which must be available on the BBS drive for Mystic BBS to use it's CD-ROM copy feature. When a file area is mar ed as a "CD-ROM" file area, Mystic BBS will attempt to copy files from the CD-ROM to the temporary directory before a user downloads it. This eeps the access to the CD-ROM drive minimal, since CD drives are usually much slower than a hard drive. [L] Redisplay File Header ------------------------This option specifies whether Mystic BBS will redisplay the file header after a pause during standard file listings. [M] Default Upload Base ----------------------This option defines the default upload base. When this is set to zero (disabled), all uploaded files will go into the user's currently selected file base. If set to a non-zero value, all uploads will be uploaded to the set file base number (as listed in the file base editor). [N] Test Uploaded Files ----------------------Mystic BBS optionally supports external upload testing. An upload processor is a program which will search a file for viruses and/or errors which may have occurred during the file transfer. Any upload processor should wor with Mystic but THD Pro Scan is recommended. It's free and available on the Mystic BBS web page and support BBS. If this option is toggled to Yes, Mystic BBS will attempt to run the external processor after all uploaded files. [O] Pass Errorlevel ------------------This option defines the Errorlevel which is returned by the external file processor if the file has passed all testing successfully. For more information, see the documentation included with the upload processor you wish to use. [P] Test Command Line --------------------This option defines the command line which is used to run the external file processor. The following MCI codes can be used with this command line: %1 = Modem ComPort. %2 = Modem Baud Rate.

%3 = Path and File Name of file to be tested. For more information, see the documentation included with the upload processor you wish to use. ---------------------------------------------------------------[E] Message Base Settings (System Configuration Editor) ---------------------------------------------------------------The Message Base Settings section is where all options relating to the Message Base system are found. Below is a screen capture of Message Base Settings screen following by an explanation of what each option does: Message Base Settings A. B. C. D. E. F. G. H. I. J. K. L. M. N. O. Compress area numbers: Message Area List Col: Max Auto Sig Lines : Redisplay Msg Header : QWK/REP filename Welcome filename News filename Goodbye filename Default Archive QWK Max Msgs/Base QWK Max Msgs/Pac et Quote Color : Text Color : Tear Line Color : Origin Line Color: : : : : : : : Yes 2 3 No MYSTIC

ZIP 0 0

Command (Q/Quit): [A] Compress Area Numbers ------------------------This option, if toggled on, will compress message area numbers so they are always sequential during a message area list. So in a message area list, if a user does not have access to area number 2, then the next area that the user does have access to will become area number 2. [B] Message Area List Columns ----------------------------This option allows the number of columns used in message base listings to be configured. Valid options are 1 or 2 columns. Note: If you change the message area list to 1 from 2, you'll have to edit your message base list prompt to reflect a single column listing. [C] Max Auto Sig Lines ---------------------This option defines the maximum number of lines a user will be allowed to use in their auto signature. An auto signature is a few lines of text which is automatically appended to each message a user posts. Many users will use their auto signature to add their handle and e-mail address to each message.

XX> Quote Text --- Tear * Origin:

[D] Redisplay Message Header ---------------------------When this option is set to "Yes", Mystic will redisplay the message header after a page full of message text has been displayed. [E] QWK/REP File Name --------------------Mystic BBS internally supports the QWK/REP offline mailing standard. The QWK offline mailing system allows users to download messages from the BBS message base and read them offline using a QWK mail reader. This allows the user to read and reply to mail offline when it's convenient to them, and also eeps the phone line free for other callers because the user will not be reading messages online. The QWK/REP filename is the name of the pac et that Mystic BBS will create for the user when they select to download a QWK pac et. This file name should be unique to your BBS name so it doesn't get mixed up with pac ets downloaded from another BBS. [F] QWK Welcome File Name ------------------------Many QWK offline mail readers offer support to display files which are included with a QWK pac et. This option defines the filename which the QWK reader will display when the user first opens the pac et for reading. [G] QWK News File Name ---------------------This option is used to define the file that will be displayed by the QWK offline reader as BBS news. [H] QWK Goodbye File Name ------------------------This option is used to define the file that will be displayed by the QWK offline reader when the user has finished reading the QWK pac et. [I] Default Archive Extension ----------------------------This option is used to define the default archive which is used to compress QWK pac ets. The extension should match the extension of any archives which have been setup in the Archive Editor. [J] QWK Max Msgs/Base --------------------This option defines the maximum number of messages which can be pac ed into a QWK pac et per message base. This option is disabled if set to 0. [K] QWK Max Msgs/Pac et ----------------------This option defines the maximum number of messages which can be pac ed into a QWK pac et. This option is disabled if set to 0.

[L] Default Quote Color ----------------------This option is used to set the default display color for Quoted text while reading messages. This color can also be configured for each individual message base in the Message Base Editor. [M] Default Text Color ---------------------This option is used to set the default display color for text while reading messages. This color can also be configured for each individual message base in the Message Base Editor. [N] Default Tear Line Color --------------------------This option is used to set the default display color for the Tear Line while reading messages. This color can also be configured for each individual message base in the Message Base Editor. [O] Default Origin Line Color ----------------------------This option is used to set the default display color for the Origin line while reading messages. This color can also be configured for each individual message base in the Message Base Editor. ---------------------------------------------------------------[F] Networ Settings (System Configuration Editor) ---------------------------------------------------------------The Networ Settings option is used to setup Mystic BBS with message base networ s such as FidoNet. A Message Base networ is a collection of BBSes that all share the same message bases, allowing users on a BBS in Europe (for example) to hold a discussion with users on a BBS in the United States. For more information, see the section on interfacing with message networ s. The following is a screen capture of the Networ Settings screen followed by an explanation of what each option does: Networ Settings 1. 3. 5. 7. 9. 11. 13. 15. 17. 19. 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0

2. 4. 6. 8. 10. 12. 14. 16. 18. 20.

0:0/0 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0 0:0/0

A. Origin : Mystic BBS * (000)000-0000 B. Netmail Crash : No C. Netmail Hold : No

D. Netmail Kill : No Command (Q/Quit): [1 to 20] Networ Addresses --------------------------These options are used to setup Networ addresses. When a BBS joins a message networ , it is assigned a networ address which is used to identify the BBS. Mystic BBS allows up to 20 address definitions, meaning that Mystic BBS can be interfaced with up to 20 different message networ s at once. [A] Default Origin Line ----------------------This option defines the default origin line which will be used for each message base. This option can also be set for each individual message base in the Message Base Editor. An origin line is a line of text which is added at the bottom of each message posted into a networ ed message base. It is used to identify what BBS the message originated from as well as any other general information you wish to have supplied about your BBS (ie, phone number, modem speed, etc). [B] Netmail Crash ----------------When this option is set to "Yes", the CRASH flag will be set true on all outgoing Netmail messages. [C] Netmail Hold ----------------When this option is set to "Yes", the HOLD flag will be set true on all outgoing Netmail messages. [D] Netmail Kill ----------------When this option is set to "Yes", the KILL flag will be set true on all outgoing Netmail messages. ---------------------------------------------------------------[L] Language Definition Editor (System Configuration Editor) ---------------------------------------------------------------About The Language System ------------------------The language definition editor is where all available language files are defined. A language file is a file that contains all the text that is displayed to a user while they are online. These files can be edited with any text editor, or the language editor supplied with Mystic BBS (LANGEDIT.EXE). By editing the language file, the user interface can be totally customized to your li ing. Almost 100% of the text displayed to the user can be customized using the MCI system and the display file system within the language files. More information on editing language files can be found in the "Editing Language Files" section of the documentation. The following is a screen capture of the Language Editor

screen followed by an explanation of each available option: Language Editor ## FileName Description -- -------- -----------------------------1 DEFAULT Default (I)nsert, (D)elete, (E)dit, (Q)uit? [I] Insert Language ------------------This option is used to insert a new language file into the Language database. Do not insert a new language file if it has not already been compiled. If a user selects a language that doesn't have a compiled language file, they will receive an error message and Mystic BBS will then attempt to load the default language file, as defined in the System Configuration -> General Settings. [D] Delete Language ------------------This option is used to delete a language entry in the language editor. [E] Edit Language ----------------This option is used to edit the settings for a language entry. When this option is selected, Mystic BBS will then allow the settings for the language file to be edited. The following is a screen capture of the Edit screen followed by an explanation of what each option does: Language 1 of 1 A. B. C. D. M. N. E. F. G. H. I. J. K. L. O. P. Description: Filename : Text Path : Menu Path : Allow ASCII: Allow ANSI : Default DEFAULT D:\TP\MYSTIC\TEXT\ D:\TP\MYSTIC\MENUS\ Yes Yes Yes Yes No Yes No Test Test * Test Test

Use Lightbar Y/N : Y/N Highlight Yes : Y/N Highlight No : Input field color : Quote Bar Color : Echo Character : Input Character : File Tag Character: File Search Hi : File Desc. Lo :

Command (Q/Quit): [A] Description --------------This option holds the description of the language file. The description is what the user will see when they are prompted to select a language file.

[B] File Name ------------This option sets the file name of the compiled language file. The compiled language file must exist in the DATA directory in order for Mystic BBS to use the language. Language files can be edited with LANGEDIT.EXE or a standard text editor, and are compiled with MAKELANG.EXE. For more information, see the "Editing Language Files" section of the documentation. [C] Text Path ------------This option sets the directory where all display files for this language exist. It is possible for language files to share the same text directory as other language files. [D] Menu Path ------------This option sets the directory where all system menu files for this language exist. It is possible for language files to share the same menu directory as other language files. [E] Use Lightbar Y/N -------------------This option specifies if Mystic BBS will use lightbar Yes and No prompts for this language. The user must have ANSI graphics to use any lightbar options. If the user doesn't support ANSI and this option is turned on, Mystic BBS will ignore it and use standard prompts. [F] Y/N Highlight Yes --------------------This is the text that is displayed in a Y/N lightbar prompt when the user has selected a Yes answer. [G] Y/N Highlight No -------------------This is the text that is displayed in a Y/N lightbar prompt when the user has selected a No answer. [H] Input Field Color --------------------Throughout the BBS, Mystic will prompt the user using a colored input field. The color of these input fields can be set here using standard DOS color numbers: Foreground colors: 0 - Blac 6 1 - Blue 7 2 - Green 8 3 - Cyan 9 4 - Red 10 5 - Magenta 11 Brown Light Grey Dar Grey Light Blue Light Green Light Cyan 12 13 14 15 Light Red Light Magenta Yellow White

Bac 0 1 2 3 -

ground colors: Blac 4 - Red Blue 5 - Magenta Green 6 - Brown Cyan 7 - Gray

[I] Quote Bar Color ------------------This option defines the foreground and bac ground colors of the lightbar used in the quote window of the full screen editor. See option [H] for a reference to valid colors. [J] Echo Character -----------------This option defines the character that will be echoed in the input field when a password is being entered. [K] Input Character ------------------This option defines the character used to fill blan spaces during field input. Here are some recommended settings for this option: Ascii 32 ( ) Ascii 250 () Ascii 176 () To enter any of these characters: Select option [K], hold in the ALT ey, type the ASCII number on the eypad, then release the ALT ey. [L] File Tag Character ---------------------This option defines the character used to mar a file as "tagged" into the lightbar file listings. The suggested setting for this field is ASCII 251 (the character). Other lightbar file list options are defined within the ANSIFLST.XXX template file. [M] Allow ASCII Graphics -----------------------This option specifies whether or not this language definition will allow users in ASCII (no graphics) mode to use this language file. [N] Allow ANSI Graphics ----------------------This option specifies whether or not this language definition will allow users in ANSI (color graphics) mode to use this language file. * NOTE * These settings in the DEFAULT language file (as defined in System Configuration -> General Settings) are used to define which graphic modes your BBS will support. For example, setting Allow ASCII to "No" in the default language file will force Mystic BBS to hangup on any callers using ASCII graphics. [O] File Search Hi -----------------This option defines the color of the highlighted text in the file description, when doing a file search. See option [H] for a reference of available color combinations. [P] File Desc. Lo

----------------This option goes along with "File Search Hi". It specifies the color of normal file description text, when doing a NON LIGHTBAR file listing. See option [H] for a reference of available color combinations. ---------------------------------------------------------------[N] New User Settings (System Configuration Editor) ---------------------------------------------------------------The New User Settings section is used to define how Mystic BBS will handle new callers who wish to create an account with the BBS. The following is a screen capture of the New User Settings screen following by an explanation of what each option does: New User Settings A. Allow New Users: Yes B. New User PW : C. Security Level : 10 P. R. S. T. Use Matrix Login: Matrix Menu Name: Matrix Password : Matrix PW ACS : No MATRIX MATRIX s20

Command (Q/Quit): [A] Allow New Users ------------------If this option is toggled off, Mystic BBS will not accept new user accounts. Instead, the display file CLOSED.XXX will be displayed and the call will be terminated. [B] New User Password --------------------This option is used to define a new user password. If a password has been defined, a caller who attempts to log in as a new user will be prompted for the new user password before they will be able to continue to log in as a new user. [C] New User Security Level --------------------------This option is used to set what security level a new user will be upgraded to after successfully completing the new user login procedure. For more information on the security system, see the Security Level Editor section.

D. E. F. G. H. I. J. K. L. M. N. O. U. V. W.

As Alias As Real Name As Street As City/State As Zip Code As Home Phone As Data Phone As Birthdate As Gender Use USA Phone Date Format Language File Editor Sysop Feedbac File List Type

: : : : : : : : : : : : : : :

Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes MM/DD/YY As As Yes Lightbar

X. User Name Format: As Typed

[M] Use USA Phone Numbers ------------------------If this option is set to Yes, Mystic BBS will use USA format phone numbers (XXX-XXX-XXXX). [N] Date Format --------------This option sets the date format which will be used for each user. Valid options are MM/DD/YY, DD/MM/YY, YY/DD/MM, or As . If this option is set to As , Mystic BBS will as each new user which date format they'd li e to use. [O] Language File ----------------This option is used to set which language file is used for

[L] As Gender -------------If this option is set to Yes, Mystic BBS will as for their gender.

[K] As Birthdate ----------------If this option is set to Yes, Mystic BBS will as for their date of birth.

[J] As Data Phone -----------------If this option is set to Yes, Mystic BBS will as for their data phone number.

[I] As Home Phone -----------------If this option is set to Yes, Mystic BBS will as for their home phone number.

[H] As Zip Code ---------------If this option is set to Yes, Mystic BBS will as for their Zip code.

[G] As City/State -----------------If this option is set to Yes, Mystic BBS will as for their City and State.

[F] As Street -------------If this option is set to Yes, Mystic BBS will as for their street address.

[E] As Real Name ----------------If this option is set to Yes, Mystic BBS will as for their real name.

[D] As Alias ------------If this option is set to Yes, Mystic BBS will as for an Alias.

new users

new users

new users

new users

new users

new users

new users

new users

new users

new users. Valid options are Use Default and As . If set to Use Default, Mystic BBS will use the default language as defined in the General Settings section. If set to As , Mystic BBS will as the user which language they'd li e to use. [P] Use Matrix Login -------------------This option defines whether Mystic BBS will use the Matrix login option. The Matrix login is an alternative to the standard "Enter your name and password" login. The Matrix system allows users to apply for an account and then when (if) they are validated, they receive a Matrix Password which is used to log into the BBS. [R] Matrix Menu Name -------------------This option defines the menu file name which is used as the Matrix Login menu. This file must exist in order for the matrix login system to wor properly. [S] Matrix Password ------------------This option defines the password which is given to the user after their account has been validated. This is the password which the user will have to now in order to log into the BBS system from the Matrix Login menu. If this field is left blan , the matrix password option will be disabled and the XL (Matrix Login) menu command will not require a password. [T] Matrix PW ACS ----------------This option defines the ACS level which the user must meet in order to be given the matrix login password from the matrix menu. [U] Editor ---------This option defines how the BBS will determine the new user's message editor preference. Valid options are: Line : New user's use the line editor by default. Full : New user's use the full screen editor by default. As : Mystic BBS will as the user their preference. [V] Sysop FeedBac -----------------This option defines if Mystic BBS will force new users to send an e-mail to the Sysop after creating a new user account. [W] File List Type -----------------This option defines how the BBS will determine the new user's file listing type. Valid options are: Normal : Normal file listing. Lightbar : Lightbar file listing. This allows users with ANSI graphics to scroll through the list of files with arrow eys.

[X] User Name Format -------------------This option specifies the way Mystic will handle new user's handle. Valid options are: As typed : Mystic will leave the user handle as they typed it. Upper case : Mystic will convert the user's handle to all uppercase letters. Lower case : Mystic will convert the user's handle to all lower case letters. Proper : Mystic will convert the first letter in each word of the user's handle to a capital letter, while forcing all other letters as lower case. --------------------------------------------------------------------Event Editor --------------------------------------------------------------------The event editor is where all system events are setup. A system event is when Mystic BBS exits at a specified time so external programs can be ran to help maintain the BBS. The following is a screen capture of the Event Editor screen followed by an explanation of what each option does: Event Editor ### Name --- ------------------------------1 New Event (I)nsert, (D)elete, (E)dit, (Q)uit? [I] Insert Event ---------------The Insert option is used to add a new event into the event database. After an event has been added, it should be setup to run as you want it to. [D] Delete Event ---------------The delete option is used to remove an event from the event database. [E] Edit Event -------------The edit option is used to edit an event already in the event database. When this option is selected, the following screen will be shown: Event 1 of 1 !. A. B. C. D. Active Description Forced Errorlevel Execution Time : : : : : No New Event No 0 00:00

As

: Mystic BBS will as the user their preference.

E. Busy Warning F. Last Ran on Command (Q/Quit):

: 0 : 00/00/80

[!] Active Event ---------------This option sets if the event is active. If the event is not set to active, Mystic BBS will ignore the event as if it doesn't even exist in the event database. [A] Description --------------This option sets the description of the event. This isn't internally used by Mystic BBS but is added to help eep trac of which event does what. [B] Forced Event ---------------This option specifies if the event is a forced event. A forced event will run at the execution time no matter what. the circumstances are. If a user is online when a forced event approaches, they will be warned and then the call will be terminated if they do not log off by the execution time. If the event is not a forced event, Mystic BBS will wait until the user terminates their call before running the event. [C] Errorlevel -------------This option specifies the Errorlevel that Mystic BBS will exit at when this event is being ran. This is used by the batch file which runs the BBS to determine which event is running. For more information on Errorlevels and batch files, see the instruction manual for your operating system. [D] Execution Time -----------------This option is used to set what time Mystic BBS will run the event. The time format is in 24-hour format. For example, 12:00 is 12 noon, and 23:59 would be 11:59pm. [E] Busy Warning ---------------The busy warning option is used to set when Mystic BBS will warn the user of an upcoming event. So if this option is set to 5, Mystic BBS will wait until 5 minutes before the event to warn the user. If the event is not a forced event then Mystic BBS does not run the event until the user logs off, and this option will be ignored. [F] Last Ran On --------------This option is used to show the date when the event was last ran. In most cases, this option does not need to be touched as Mystic BBS eeps this field up-to-date each time the event is ran. --------------------------------------------------------------------Archive Editor

--------------------------------------------------------------------The archive editor is where all archive compression and decompression utilities are setup. Archive utilities are programs which ta e a number of files and compress them into one file, saving drive space and in the case of a BBS, file transfer time. Archive utilities are used with Mystic BBS in the file transfer functions, and in the QWK offline mail functions and are almost required if you want to use these features. Some popular archive programs are:

These utilities can be found on most BBSes and throughout the Internet. Many are free for non-commercial use. Below is a screen capture of the Archive Editor followed by an explanation of what each option does: Archive Editor ### --1 2 3 4 Ext --ZIP LZH RAR ARJ Name -------------------P Ware's ZIP Yoshi's LHA Roshal's RAR Jung's ARJ

(I)nsert, (D)elete, (E)dit, (Q)uit? [I] Insert Archive -----------------This option is used to insert a new archive definition into the archive editor. [D] Delete Archive -----------------This option is used to delete an archive definition from the archive editor. [E] Edit Archive ---------------This option is used to edit an archive definition in the archive editor. Below is a screen capture of the Archive Settings screen followed by an explanation of what each option does: Archive 1 of 4

Command (Q/Quit):

A. B. C. D. E.

Name : Extension : Pac Cmd : Unpac Cmd: View Cmd :

P Ware's PKZIP utilities Robert Jung's ARJ utilities Eugene Roshal's RAR utilities Haruyasu Yoshiza i's LHA utilities

ARJ241A.EXE PKZ204G.EXE RAR202.EXE LHA225.EXE

P Ware's ZIP ZIP PKZIP -a -ex -o %1 %2 PKUNZIP -o -ed %1 %2 %3 PKUNZIP -vb %1 >%3%2

[A] Archive Name ---------------This option defines the description of the archive as it will appear when listed by Mystic BBS. [B] Archive Extension --------------------This option defines the archive extension as created by the archive utility which is currently being setup. [C] Pac Command Line --------------------This option defines the command line that Mystic BBS uses to pac a group of files into one file. Archive MCI codes must be used for this command line and are listed below. [D] Unpac Command Line ----------------------This option defines the command line that Mystic BBS uses to unpac an archive into the temporary directory. Archive MCI codes must be used for this command line and are listed below. [E] View Command Line --------------------This option defines the command line that Mystic BBS uses to view the contents of an archive. Mystic BBS internally supports the viewing of ZIP, LZH, ARJ, and RAR files. If an archive is not of one of the above types, Mystic BBS will loo into the archive definitions and use the this command line to view if the extension of the file matches the extension of the archive definition. Archive MCI Codes ----------------These codes wor just li e the MCI display codes, but only wor with the archive definitions. The following MCI codes can be used in the Archive Editor: %1 = File name being processed. %2 = Files to pac /unpac . %3 = Temporary file directory where Mystic BBS pac s/unpac s archives. --------------------------------------------------------------------Protocol Editor (Editing File Transfer Protocols) --------------------------------------------------------------------The protocol editor is where all file transfer protocols are setup and maintained. A file transfer protocol is a program which is used to transfer files between computer systems. In almost all cases they are needed if you wish to run a BBS, unless you don't plan on using the entire file transfer section or any of the QWK offline mailing functions. By default, Mystic BBS comes pre-configured to use the CEXYZ v1.00 protocol driver. This archive can be found on the Mystic BBS web page as well as on various BBS systems under the filename of CEXYZ100.XXX

(where XXX is the archive type). In most cases, you should only need to copy the CEXYZ.EXE file into the protocol directory as defined in the System Configuration -> System Paths in order to have a fully wor ing protocol setup. If you wish to use a protocol driver other than CEXYZ, you must ma e sure that it is capable of producing a compatible DSZ-style log file. Below is a screen capture of the Protocol Editor screen followed by an explanation of what each option does: Protocol Editor ## Key Description -- --- -------------------1 X (CEXYZ) Xmodem 2 Y (CEXYZ) Ymodem 3 Y (CEXYZ) Ymodem Batch 4 G (CEXYZ) Ymodem-G 5 G (CEXYZ) Ymodem-G Batch 6 Z (CEXYZ) Zmodem 7 Z (CEXYZ) Zmodem Batch (I)nsert, (D)elete, (E)dit, (Q)uit? [I] Insert Protocol ------------------This option will add a new protocol definition to the protocol editor. [D] Delete Protocol ------------------This option will allow an existing protocol definition to be deleted from the protocol editor. [E] Edit Protocol ----------------This option allows an existing protocol definition to be edited. The following is a screen capture of the Protocol Editor EDIT screen followed by an explanation of each option: Protocol 6 of 7 A. B. C. D. E. Key : Description: Batch : UL Command : DL Command : Z (CEXYZ) Zmodem No cexyz.exe /P%1 /B%2 /L%4 /Rz %3 cexyz.exe /P%1 /B%2 /L%4 /Sz %3

Command (Q/Quit): [A] Key ------This option specifies the hot ey which is this protocol from the protocol list. It ma e sure that a protocol definition does hot ey as another protocol definition, or occur. [B] Description ---------------

used to select is important to not use the same problems may

This option defines the name / description of the protocol as it will appear when a user is prompted to select a protocol. [C] Batch --------This option defines if this protocol is a batch protocol. A batch protocol is a protocol which allows a group of files to be sent at one time, consecutively. If a user has flagged a list of files to download at one time, Mystic BBS will prompt them to select a BATCH protocol. If a user has selected only one file to download, Mystic BBS will prompt the user to select a non-batch protocol. Note that some protocols allow both single and batch file transfers, so there might be two definitions on the protocol editor for one protocol. One being the setup for single file transfers, and one being the setup for batch file transfers. [D] Upload Command Line ----------------------This option specifies the command line that is sent to the protocol driver in order to upload (receive) files from another connection. There is a specific set of MCI codes which can be used in the protocol editor only listed below. [E] Download Command Line ------------------------This option specifies the command line that is sent to the protocol driver in order to download (send files FROM the BBS) to a connected user. The MCI codes available only to the protocol editor are listed below: PROTOCOL SPECIFIC MCI CODES: %0 %1 %2 %3 %4 = = = = = Comport handle (Win32 and OS/2 only) Comport which the modem is using. The baud rate the user is currently connected at. Name of the file being transferred. Baud rate as setup in the Node settings (loc ed).

--------------------------------------------------------------------Voting Booth Editor (Editing Voting Booth Questions) --------------------------------------------------------------------The Voting Booth Editor is where all questions and answers for the built in Voting Booth are setup. The Voting Booth option can allow up to 20 voting questions, and 15 answers per question to be defined. The following is a screen capture of the Voting Booth screen followed by an explanation of what each option does: Voting Booth Editor ## Question -- --------------------------------------1 New Question (A)dd, (D)elete, (E)dit, (Q)uit? [A] Added New Question ----------------------

This option allows a new voting question to be defined. [D] Delete Question ------------------This option allows an already defined voting question to be deleted from the Voting database. [E] Edit Voting Question -----------------------This option allows an already defined voting question to be configured. All available answers and options for each question are defined here. The following is a screen capture of the Voting Booth Question Editor followed by an explanation of what each option does: Question 1 of 1 A. B. C. E. F. Question Votes Vote ACS Add ACS Forced ACS : : : : : New Question 1 s255 s255 s999

## Answer ## Answer -- --------------------------- -- --------------------------01 New Answer 02 Another New Answer (I)nsert, (D)elete, (Q)uit): [A] Question -----------This option defines the question text as it will appear to the user who is voting on the question. [B] Votes --------This option defines the total number of votes which have been placed for this question. Note: Mystic BBS internally eeps trac of this and in most cases this options should not be changed by the SysOp. If this option is changed, it could cause an error in the percentage calculation in the voting results screen. [C] Vote ACS -----------This defines the ACS string which is required to vote on this question. If the user does not meet the ACS string, they will not be able to see the question. [E] Add ACS ----------This defines the ACS string which is required to add an answer to the voting question. If the user meets this ACS string they will be able to add their own answer to the voting question, as long as the maximum of 15 answers hasn't been reached. [F] Forced ACS -------------Mystic BBS can optionally force users to vote on certain

questions. This option defines the ACS string to force a user to vote on the question. If the user meets this ACS string as well as the ACS string for the question itself, they will be forced to vote on this question before getting into any system menus. [1 to 15] Edit An Answer -----------------------The answers for each question are listed in the question editor as 1) through 15). By entering the number of the answer on the command line, the answer text can be edited, as well as the the number of votes for each answer. Note: The number of votes for each answer is maintained by Mystic BBS and does not need to be edited by the Sysop. If these values are changed, it may cause an error in the percentage calculation in the voting question results. [D] Delete Answer ----------------This option allows a defined answer to be deleted. [I] Insert Answer ----------------This option allows a new answer for the question to be defined. --------------------------------------------------------------------Message Base Editor (Editing Message Bases) --------------------------------------------------------------------The message base system allows users to post messages which can be publicly read by anyone, or sent privately to an individual user. Mystic also supports to option of having "networ ed" message bases, meaning, a message base which is shared with several other BBS systems, allowing all users from every system to send messages to each other! The following is a screen capture of the Message Base Editor along with a description of each available option: Message Base 1 of 3 A. B. C. D. E. F. G. H. I. J. K. L. M. N. Name QWK Name Filename Storage Path Post Type : : : : : General Messages General Msgs GENERAL D:\TP\MYSTIC\MSGS\ Public s10 s10 s10 s255 Local 0:0/0 My BBS * (000)000-0000 No W. Max Messages : 0 X. Max Msg Age : 0 days

Y. Format Type : JAM O. P. R. S. T. Quote Color Text Color Tear Color Origin Color Header File : : : : : XX> Quote Text --- Tear * Origin:

List ACS : Read ACS : Post ACS : Sysop ACS : Password : Base Type : Net Address : Origin line : Use Realnames:

U. Default New Scan: Yes V. Default QWK Scan: Yes ([) Prev, (]) Next, (Q)uit:

[A] Message Base Name --------------------This option defines the message base name, as it will appear in the list of available message bases. [B] QWK Message Base Name ------------------------This option defines the QWK message base name. This name will be used as the message base name within a user's QWK offline mail pac et. [C] Storage File Name --------------------This option defines the file name which Mystic will use to store the message base data in. This should be a unique name, up to 8 characters in length. [D] Storage Path ---------------This option is used to specify the path on your hard dis that Mystic BBS will use to store data files for this message base. Mystic will automatically assign the "default" message base path to this option, and in most cases it does not need to be changed. [E] Post Type ------------This option sets the "type" of message that is allowed to be posted in this base. Available options are: 1) Public : All messages are posted as public and can be read by all users. 2) Private : All messages are posted as private and can ONLY be read by the user it is sent to. [F] List ACS -----------This option defines the Access String (ACS) which the user must meet in order for this base to appear in the message base listing. [G] Read ACS -----------This option defines the ACS string which the user must meet in order to read messages in this base. [H] Post ACS -----------This option defines the ACS string which the user must meet in order to post a message into this base. [I] SysOp ACS ------------This option defines the ACS string which the user must meet in order to access "SysOp" functions for this message base. Functions such as editing the message header and text, along with (X)porting the message to a text file. [J] Password ------------

This option defines the password required to access this message base. If this option is left blan , no password will be required. [K] Base Type ------------This option defines the "type" of message base that is being setup. Available options are: Local : Sets the message base as a local base. This means that this base is NOT part of any message networ where messages need to be exported, processed, and sent to another system.

EchoMail: Sets the message base as a EchoMail message base. Most message base networ s available to BBS SysOps are "FidoNet" style echomail networ s. This option causes Mystic to exit with an errorlevel of 5 when new Echomail mail has been entered. This allows for your setup to execute the appropriate Echomail mail processors. UseNet : Sets the message base as a UseNet message base. This option is for easier integration with the Internet UseNet newsgroups. This option wor s much li e a Echomail base, except it causes Mystic to exit with errorlevel 6 when new messages have been entered and it automatically sets all messages "To: ALL". NetMail : Sets the message base as an EchoMail / NetMail base. When a base is set as NetMail, Mystic will also as for an echomail destination address along with the "To" field. NOTE: When both Echomail and UseNet mail have been entered, Mystic will exit with an errorlevel of 7. When this occurs, both Echomail and UseNet mail processors should be executed. [L] Networ Address ------------------This option defines the FidoNet networ address, which is assigned to each BBS in a message base networ . [M] Origin Line --------------This option defines the Origin Line which is appended to each message posted in aa Echomail message base. The origin line usually contains the name or your BBS, the phone number, location, telnet address, etc. [N] Use Real Names -----------------This option defines whether Mystic will use the user's REAL name in the "From" field. Some message base networ s require that all message posted use the user's real name. [O] Quote Color --------------This option specifies the color Mystic will use for "quoted" text when reading messages. Available colors options are:

[P] Text Color -------------This option defines the color Mystic will use to display "regular" text while a user is reading a message. [R] Tear Color -------------This option defines the color Mystic will use to display the tear line of the message. The tear line is a line of text usually appended at the end of a networ ed message base. For example, at the end of each exported message, Mystic will append the following tear and origin line: --- Mystic BBS v1.03/DOS * Origin: <your configured origin here> (0:0/0) [S] Origin Color ---------------This option defines the color Mystic will use to display the origin line of the message. [T] Message Header File ----------------------This option defines the optional external message header which can be used. The filename specified here should be found in the TEXT directory with all of the other display files. If this file does not exist, Mystic will generate it's own message header. The following PromptInfo MCI codes are available in the message header file: |&1 |&2 |&3 |&4 |&5 From To Subject Message Date Message number |&6 |&7 |&8 |&9 |&0 Total messages in base Reply to message number See also message number Message status Message Time

[U] Default New Scan -------------------This option defines if the message base will be toggled ON in all users new message scan settings by default. [V] Default QWK Scan -------------------This option defines if the message base will be toggled ON in all users QWK message scan settings by default.

Bac 0 1 2 3 -

ground colors: Blac 4 - Red Blue 5 - Magenta Green 6 - Brown Cyan 7 - Gray

Foreground colors: 0 - Blac 6 1 - Blue 7 2 - Green 8 3 - Cyan 9 4 - Red 10 5 - Magenta 11

Brown Light Grey Dar Grey Light Blue Light Green Light Cyan

12 13 14 15

Light Red Light Magenta Yellow White

[W] Max Messages ---------------This option specifies the maximum number of messages which this base can contain before they will be purged. Mystic does not internally do anything with these values. They have been added to support the Squish message base standard and their utilities. [X] Max Message Age ------------------This option specifies the maximum days a message can be posted before they will be purged. Mystic does not internally do anything with these values. They have been added to support the Squish message base standard and their utilities. [Y] Format Type --------------This option specifies the message base "format" to use. This can be set to either "JAM" or "Squish", the two most popular message base formats. *NOTE: If you have an active message base in one format, and wish to change to another format, you will need to do one of two things: 1) Delete the message base data files, and lose the current messages in the base, or... 2) Run a utility to convert from one format to the other THEN switch formats in the message base editor. --------------------------------------------------------------------File Base Editor (Editing File Bases) --------------------------------------------------------------------The file base system allows users to transfer files to and from the BBS system so they can be shared with other users of the BBS. These files can be categorized into different file bases, which are setup in the File Base Editor. The following is a screen capture of the file base editor screen along with a description of each available option: File Board Editor ### Name --- -------------------------1 New File Base (I)nsert, (D)elete, (E)dit, (M)ove, (Q)uit? [I] Insert File Base -------------------This option allows a new file base definition to be added into the database. [D] Delete File Base -------------------This option allows an already defined file base to be removed from the file base database. [M] Move File Base ------------------

This option allows already defined file bases to be moved around within the database. [E] Edit File Base -----------------This option allows the settings for an already defined file base to be edited. The following is a screen capture of the file base modify screen along with an explanation of what each option does: File Base 1 of 1 A. B. C. D. E. F. G. H. I. J. K. L. Name : Filename : Display File : ACS : Sysop ACS : Upload ACS : Download ACS : Storage Path : Password : Show Uploader : Default NewScan: CD-Rom Area : New File Base NEW s255 s255 s255 s255 Yes Yes No

Command (Q/Quit): [A] Name -------This option defines the file base name / description as it will appear to the user when they select a file base. [B] File Name ------------This option defines the data file name that is used to store information for this file base. This file should be a unique file name, different from all other data files. [C] Display File ---------------This option defines the display file that Mystic can display before the files in this base are listed. This field is optional and should be left blan if you do not wish to have Mystic send a display file before each file list. [D] ACS -------This option defines the ACS string which the user must pass in order to gain access to this file base and list files. [E] SysOp ACS ------------This option defines the ACS string which the user must pass in order to access SysOp functions such as the File Directory Editor. [F] Upload ACS -------------This option defines the ACS string which the user must pass in order to upload (send) files from their computer to this file base.

[G] Download ACS ---------------This option defines the ACS string which the user must pass in order to download (receive) files from this file base onto their computer. [H] Storage Path ---------------This option defines the directory where Mystic will store the files uploaded into this file base. [I] Password -----------This option defines the password which is required to access this file base. If you do not wish to require a password to access this base, leave this field blan . [J] Show Uploader ----------------This option defines if Mystic BBS will show the uploader's name during the file list. If this option is set to yes, Mystic will show who uploaded each file into the file base at the end of the file description. [K] Default New Scan Setting ---------------------------This option defines the default new scan setting for this file base. When a new user logs into the system, their file base new scan setting for this base will be set to the default. [L] CD-ROM Area --------------This option specifies whether the files in this area are being stored on a CD-ROM drive. If this option is set to "Yes", Mystic BBS will refuse uploads into the area, as well as attempt to copy files from the CD-ROM drive to the hard drive before sending them to the user. This eeps the CD drive access to a minimal, which is important when multiple users are downloading files from the same CD-ROM drive. See also: System Configuration / File Settings. --------------------------------------------------------------------Menu Editor (Editing System Menus) --------------------------------------------------------------------The BBS menus are the core of the BBS system. It is where all BBS commands and functions available to the user are defined and setup. Mystic BBS supports an unlimited number of defined menus which can be setup in any way, allowing a totally customizable and unique interface to the user. When first entering the menu editor, you will be prompted to select which language definition you'd li e to edit. It is possible to have different sets of menus for each language! After you've selected the language you'd li e to edit, you will be

shown the main menu selection screen: Menu Editor (Language: Default) Directory of C:\MYSTIC\MENUS\*.MNU FILE.MNU GOODBYE.MNU TIMEBANK.MNU PRELOGIN.MNU MAIN.MNU NEWINFO.MNU TEST.MNU MATRIX.MNU PERSONAL.MNU SYSOP.MNU BBSLIST.MNU VOTING.MNU MESSAGE.MNU BATCH.MNU QWK.MNU

(M)odify, (I)nsert, (D)elete, (Q)uit? The following commands are available from this screen: [M]odify -------This option will allow an existing menu to be edited. [I]nsert -------This option will allow a new menu to be created. [D]elete -------This option will allow an existing menu to be deleted. --------------------------------------------------------------------Menu Editor (Modifying Menus) --------------------------------------------------------------------(THIS PART OF THE DOCUMENTATION HAS NOT BEEN FINISHED) --------------------------------------------------------------------Menu Editor (Menu Command Reference) ------------------------------------------------------------------------------------------Auto Signature Commands ----------------------Command : AD Description : Delete auto signature Optional data : None. Command : AE Description : Edit auto signature Optional Data : None. Command : AT Description : Toggle auto signature ON or OFF. Optional Data : None. Command : AV Description : View current auto signature Optional data : None. ----------------BBS List Commands -----------------

Command : BA Description : Add to the BBS list. Optional Data : None. Command Description : BL : Display the extended BBS list. The optional data field requires a LIST ID, which is up to an 8 character long unique name for the BBS list. This allows multiple BBS lists to be maintained. If ;SEARCH is appended after the LIST ID, Mystic will prompt the user for a search string to allow them to view only BBSes which contain the search string. Optional Data : <LIST ID>;SEARCH Command Description : BS : Display the short BBS list. The optional data field requires a <LIST ID>, which is up to an 8 character long unique name for the BBS list. This allows multiple BBS lists to be maintained. If ;SEARCH is appended after the LIST ID, Mystic will prompt the user for a search string to allow them to view only BBSes which contain the search string. Optional Data : <LIST ID>;SEARCH -------------------General BBS Commands -------------------Command Description : GD : Display a text file. The optional data field is required and holds the name of the file to display. If there is no file extension then the extension of .ANS or .ASC will be appended according to the user's terminal settings. Optional Data : <FileName> Command Description : GE : Edit User Settings. This command can be used to allow users to edit their user profile. The optional data is required for this menu command, and will set which field in the user's profile to edit. The optional data must be set to one of the following: 1 3 5 7 9 11 *13 15 17 19 21 23 25 27 29 31 Street Address 2 Zip Code 4 Data Phone Number 6 Gender 8 Terminal Emulation 10 Password *12 Alias 14 Editor Type 16 File List Type 18 Toggle HotKeys 20 Toggle LB Msg Idx 22 User Note 24 Optional Field 2 26 Toggle LB Quote 28 Toggle Node Chat Type 30 Select Archive Type City/State Home Phone Number Birthdate Date Format Screen Length Real Name Language Toggle Invisibility Toggle Availability Message Reader Type Email Address Optional Field 1 Optional Field 3 Toggle LB Email Idx Toggle QWK FileList

* NOTE: These commands should not be made available to the user. They are added as an option for use with the NEWINFO.MNU. Optional Data : <Number of Field to Edit> Command Description : GH : Logoff user. This command will show the display file GOODBYE.xxx and then log the user offline. If the user has files in their download queue, they will be prompted to download them before logoff. Optional Data : None. Command Description : GL : This command lists the last 10 users who called into the BBS system. Local logins are not included in this list. Optional Data : None. Command Description : GN : One Liners. This option will allow the user to view and enter a one-liner if they choose. The optional data field allows the maximum number of lines and the maximum line length (in characters) to be configured. If no optional data is supplied, the default used is 10 lines and 75 characters.

Optional Data : <max lines>;<max line length>;<max input field length> Command Description : GO : Go to a new menu. The optional data field for this menu command is required. It holds the name of the new menu that is to be loaded. Optional Data : <Menu Name> Command Description : GP : Page the System Operator for chat. This command will allow the user to page the System Operator for chat. If the optional data is set to /F, Mystic BBS will ignore the defined chat hours and page the SysOp. Optional Data : /F Command Description : GR : Return from a gosub. This option will load the last menu which was saved onto the menu stac by the GS (Gosub Menu) command. Optional Data : None. Command Description

: GS : Gosub to a new menu. This option will save the current menu name on the menu stac and go to a new menu. The optional data field is required and holds the name of the new menu that is to be loaded. Optional Data : <Menu Name> Command Description : GT : Display line of text. This command is used to display a line of text. The optional data field holds the text that is to be displayed. Optional Data : <Text to Display>

Command Description

: GU : List all system users. This command will display a list of all user accounts on the system. If the optional data is set to SEARCH, the user will be able to search the list for a specific user. Optional Data : SEARCH Command Description : GX : Execute MPE module. This command will execute a Mystic BBS programming executable. Mystic BBS has a built in programming language which allows the Sysop to write custom programs for their BBS. For more information on this, see the MPL.DOC file included with the distribution archive in the Script/MPE directory. Optional Data : None. -------------------------Voting Booth Menu Commands -------------------------Command Description : VA : Add Question to Voting Booth. This command allows users to add questions into the voting booth. Optional Data : None. Command : VN Description : Votes on all unvoted on (new) voting questions. Optional Data : None. Command Description : VR : See results of a voting question. This command allows users to display the results of a voting question. If the question number is supplied in the option data field, the results for that question will be displayed. If the optional data field is left blan , the user will be as ed to select which question they'd li e to see the results of. Optional Data : <Question Number> Command Description : VV : Voting Booth. This command will allow users to access and vote on the current voting questions in the Voting Booth database. The optional data field can be used to force a user to vote on a certain question by supplying the number of the question (as listed in the voting editor). Optional Data : <Question Number> ----------------------Time Ban Menu Commands ----------------------Command : TA Description : Deposit Kilobytes into Kilobyte ban . Optional Data : None. Command : TD

Description : Deposit time into the time ban . Optional Data : None. Command : TS Description : Withdrawal Kilobytes from Kilobyte ban . Optional Data : None. Command : TW Description : Withdrawal time from the time ban . Optional Data : None. ----------------------File Base Menu Commands ----------------------Command Description : FA : Allows the user to change their selected file base. If the file base number (as listed in the file base editor) is supplied in the optional data field, Mystic will automatically change to that file base. If the data field is set to "+", Mystic will change to the next file base. If the field is set to "-", Mystic will change to the previous file base. Optional Data : <File Base Number> or "+", "-", "nolist" Command Description : FD : Download a file. This command will prompt the user for a filename and allow them to download a file from the file database. Optional Data : None. Command Description : FF : Create a file list. This command is used to allow the user to create and download a text file containing a list of files on the BBS system. Optional Data : </NEW> </ALLGROUPS> /NEW - Creates a list of only NEW files rather then a list of all files. /ALLGROUPS - Creates a list from all file areas in all groups. If this option is not specified, Mystic will create a list of files in the user's currently selected file group. Command Description : FG : Select file group. This command will allow the user to select which file group they are in. If the optional data field holds a file group number as listed in the File Group Editor, the user will be automatically put into that File Group if they meet the access requirements. If "+" is supplied on the field, Mystic will move the user into the next available file group. If "-" is supplied, Mystic will move the user into the previous available file group. Optional Data : <File Group Number>, "+", "-" Command Description : FL : List files. This command will list files in the currently selected file base. If the optional data

field is left blan , all files will be listed. If the optional data file is set to "SEARCH", the user will be prompted for a file mas . If a <File Mas > is supplied, files which match the supplied mas will be listed. Optional Data : "SEARCH" or <File Mas > : FN : New file scan. This command will allow the user to scan for all files that have been added to the file database since the last time they preformed a new file scan. If the optional data field is set to "C", only files in the current file base will be scanned. If set to "G", all bases in the current group will be scanned. If set to "A", all files in all groups will be scanned. If left blan , the user will be as ed if they'd li e to scan all bases, or just the current base. Optional Data : "A", "C", "G" or <BLANK>. Command Description : FP : Set file new scan pointer. This command will allow the user to set the date which Mystic will use to search for new files. Command Description

Command Description

: FS : Search for files. This command will allow the user to search the file database for a matching search string. Optional Data : None. Command Description : FU : Upload a file. This command will allow a user to transfer a file from their computer into the BBS system's file base. Optional Data : None. Command Description : FV : View an archive. This command will allow a user to view the contents of any archive in the file base. Optional Data : None. Command Description : FZ : Toggle New Scan File Bases. This command will allow a user to set which file bases will be scanned when a scan for new files is ran. Optional Data : None. Command Description : F1 : Mass file upload. This command will search the current file base's directory for files that haven't been added into the file database. When a new file is found, the BBS as how to handle the file: Upload BLAH.ZIP? (Y)es, (N)o, (A)uto, (S) ip, (Q)uit:

(Y)es (N)o (A)uto (G)lobal

Adds the file into the file base. S ips the file. Upload all files in area without prompting. Upload all files in all areas without prompting.

Mystic BBS will automatically search for FILE_ID.DIZ description files and import them if found. When no description file is found, Mystic will prompt for a file description unless in Auto mode. *NOTE* This command should only be made accessible by a SysOp! Optional Data : None. Command Description : F2 : File directory editor. This command will bring up the file directory editor for the current file base. Here each file listed in the directory can be edited or deleted. *NOTE* THIS COMMAND SHOULD BE MADE AVAILABLE ONLY TO A SYSOP. Optional Data : None. Command Description : F3 : File download. This command will allow the SysOp to force a user into downloading a file. The optional data field is required and holds the full path and file name of the file to send. Note that the file specified in the optional data field does NOT have to be a file which exists in the file database. It can be any file, just as long as it exists somewhere on the drive. Optional Data : <Full path and file name of file to Send> -----------------------------File Batch Queue Menu Commands -----------------------------Command Description : QA : This command will allow a user to add a file to their batch queue. Optional Data : None. Command Description : QC : Clear batch queue. This command will remove all the files in the user's batch queue. Optional Data : None. Command Description : QD : Delete batch queue. This command will allow a user to remove a file from their batch queue. Optional Data : None. Command Description : QL : List batch queue. This command will allow a user to list the files currently in their batch queue. Optional Data : None. -------------------------Message Base Menu Commands -------------------------Command : MA

(S) ip (Q)uit

- S ip this base and move on to the next one. - Abort mass upload.

Description

: Select the current message base from a list. If the message base number (as listed in the message base editor) is supplied in the optional data field, Mystic will automatically change to that message base. If the data field is set to "+", Mystic will change to the next message base. If the data field is "-", Mystic will change to the previous message base. Optional Data : <Message Base Number>, "+", "-", "nolist" Command : MC Description : Chec s for any new electronic mail. Optional Data : None. Command Description : MG : Select a message group. This command will allow the user to select what group they are in. The optional data field can be used to force the user to join a certain group if the number of the group (as listed in the Message Group Editor) is supplied. If "+" is supplied, Mystic will change to the next message group. If "-" is supplied, Mystic will change to the previous message group. Optional Data : <Group Number>, "+", "-" Command Description : MM : Mass e-mail. Allows SysOps to send e-mail to multiple users at once, by three different options:

ACS Level - This will allow the e-mail to be sent to all users who pass the given ACS level. User List - This will allow a list of users to be composed, which a copy of the e-mail will be sent to. All Users - This will send the e-mail to all users on the BBS system! Optional Data : None. Command Description : MN : Scans all message bases for new messages. The optional data field can be left blan , or can contain any of the following options:

/G : Scans all message bases in all message groups. /P : Scans for only personal messages in each base. In other words, only messages directed TO the user who is scanning will be read. Mystic will also scan the electronic mail base when this command is specified. /M : Scans only message bases mar ed as mandatory scanning. Optional Data : </P or /M> </G> Command : MP Description : Posts a message to the currently selected message base. Optional Data : </TO:> </SUBJ:> </ADDR:> </F> /TO:<user_name> /SUBJ:<subject> /ADDR:<netaddr> /F Sets the TO field of the message. Sets the SUBJECT field of the message. Sets the netmail address field. Forces the user to post the message.

The text supplied with the /TO and /SUBJ options should have any spaces replaced by the "_" character. An example menu command for this might be: Command : MP Data : /TO:some_user /SUBJ:hello_there! /F The above would post a message to "some user" with the subject of "hello there!". The user would not be able to abort posting this message because the /F option was supplied. Command Description : MR : Reads messages in the currently selected message base. The optional data field specifies the read <MODE>, which can be any one of the following: <BLANK> "F" "N" "Y" "S" Optional Data : <MODE> Command Description : MS : Allows searching of one or all message bases for a text match. The optional data field has three options available: C : Prompts the the current G : Prompts the all message matches. A : Prompts the all message user for search text and searches message base for matches. user for search text and searches bases in the current group for user for search text and searches bases in all groups for matches. Prompts user to select read mode. Reads messages forward. Reads new messages. Reads messages sent TO the user. Text search for messages

This command defaults the the "G" option if no optional data is provided. Optional Data : "C" or "G" or "A" Command : MW Description : Send electronic mail to another user. Optional Data : </TO:> </SUBJ:> </ADDR:> </F> /TO:<user_name> /SUBJ:<subject> /ADDR:<netaddr> /F Sets the TO field of the message. Sets the SUBJECT field of the message. Sets the netmail address field. Forces the user to post the message.

The text supplied with the /TO and /SUBJ options should have any spaces replaced by the "_" character. An example menu command for this might be: Command : MP Data : /TO:some_user /SUBJ:hello_there! /F The above would post a message to "some user" with

the subject of "hello there!". The user would not be able to abort posting this message because the /F option was supplied. Command Description : MZ : Allows the user to select which message bases will be scanned in their new message scan (menu command MN). Optional Data : None. -----------------------Multi-Node Menu Commands -----------------------Command Description : NA : Set Node Action. This command will set the node action which appears when a Who's Online (NW) list is done. The Optional Data field is required and holds the text that will appear in the "Action" field of a Who's Online list. Optional Data : <Action> : NC : Multi-node chat. This command will enter the multi-node chat conference where all users currently logged in can tal with each other in real time. Optional Data : None. Command Description : NS : Send message to a node. This command will allow a user to send a message to another logged in user. The optional data field can be used to force a message sent to a certain node. The node number must be supplied first followed by a semi-colon and then the message text. For example, 2;Hello would send a message to node 2 saying Hello. If a zero is used as the node number, the message text will be sent to all users currently logged in to the BBS system using the System Message format. This way it is possible to have Mystic inform all users online when a user logs into another node, or when a user basically does anything you wish everyone to now about. Two MCI codes can be used to send the user name and node number of where the message originated from: &1 = Name of user where message was sent from &2 = Node number message was sent from Optional Data : <Node>;<Text> Command Description : NW : Who's Online. This command will list all the users who are currently logged into the system. It will also give a general idea of what they are doing at the time of the list, and where they are calling from. Optional Data : None. -------------------------------Offline Mail (QWK) Menu Commands -------------------------------Command Description

: OC : Configure user's QWK options. This option will allow the user to select which archive format they'd li e to use for their QWK pac ets, as well as select if they'd li e to have a new files list included in their QWK pac et. Optional Data : None.

Command Description

Command Description

: OS : Set QWK scanned bases. This command will allow the user to select which message bases are included in their .QWK pac et. Optional Data : None.

-----------------Door Menu Commands -----------------Command : DDescription : Shells to the OS and executes <command line>. Optional Data : <Command Line> Command Description : DC : Shells to the OS and executes <command line>. The CHAIN.TXT drop file is created in the node's temporary directory.

Command Description

: DD : Shells to the OS and executes <command line>. The DORINFO1.DEF drop file is created in the node's temporary directory. Optional Data : <Command Line> Command Description : DG : Shells to the OS and executes <command line>. The DOOR.SYS drop file is created in the node's temporary directory. Optional Data : <Command Line> -------------------------Matrix Login Menu Commands -------------------------Command Description : XA : Apply for an account. This menu command allows the user to log in as a new user, but then is ta en bac to the Matrix menu where they will not be able to

Command Description

: OU : Upload a .REP pac et. This command will allow the user to upload a .REP pac et produced by their offline mail reader. After the pac et is uploaded, Mystic will then add the messages into their appropriate message bases. Optional Data : None.

Command Description

: OD : Download a .QWK pac et. This command will compile, archive and allow a user to download a .QWK pac et. Optional Data : None.

enter the BBS without the matrix password.

Command Description

: XL : Log into the BBS system. This command allows a user to log into the BBS system from the Matrix menu. When this option is selected, the user will be prompted for the Matrix password and will not be able to log in without it.

: XP : Page SysOp for chat from Matrix. This command wor s just li e the GP (Page SysOp) command, but is to be used from the Matrix login menu. Optional Data : <same as GP command> ----------------------------System Operator Menu Commands ----------------------------*NOTE* These commands are for the System Operator (Sysop) only and should NOT be made available to anyone except the Sysop. Command : *# Description : Menu Editor. Optional Data : None. Command Description : *A : System Archive Configuration. This enters the archive configuration where all compression utilities are setup and maintained. Optional Data : None. Command : *F Description : File Base Editor. Optional Data : None. Command : *G Description : Group Editor. Optional Data : None Command : *L Description : Security Level Editor. Optional Data : None. Command : *M Description : Message Base Editor. Optional Data : None. Command : *P Description : Protocol Editor. Optional Data : None.

Command Description

Command Description

: XC : Chec for matrix password. This menu command will allow the user to chec for the matrix password. If the user meets the "See Matrix Password" ACS setting in the New User Settings, they will be given the matrix password which will then allow them to log into the BBS.

Command : *S Description : System Configuration. Optional Data : None. Command : *U Description : User Editor. Optional Data : None. Command : *V Description : Voting Booth Editor. Optional Data : None. --------------------------Miscellaneous Menu Commands --------------------------Command Description : -D : Set user flags. This will allow user flags to be set for each user's SECOND set of flags - using the following format: <Command><Flag> <Command> This is the action of the flag. It can be any one of the following: + = Set <FLAG> to ON. - = Set <FLAG> to OFF. ! = Toggle <FLAG>. <FLAG> is the flag to toggle. Valid flags are letters A through Z - all capital letters. Example data fields: !A (toggles flag A) -B (toggles flag B OFF) +A (toggles flag A ON !A-E+Y (toggles A, turns E OFF, turns Y ON) Optional Data : <Command><Flag> Command Description : -F : Set user flags. This will allow user flags to be set for each user's FIRST set of flags - using the following format: <Command><Flag> <Command> This is the action of the flag. It can be any one of the following: + = Set <FLAG> to ON. - = Set <FLAG> to OFF. ! = Toggle <FLAG>. <FLAG> is the flag to toggle. Valid flags are letters A through Z - all capital letters. Example data fields:

!A (toggles flag A) -B (toggles flag B OFF) +A (toggles flag A ON !A-E+Y (toggles A, turns E OFF, turns Y ON) Optional Data : <Command><Flag> Command Description : -N : Prompts user with a Yes/No question and if the user answers "Yes", the OK ACS command will be set to TRUE. The optional data line is the text that will be displayed to the user as the Yes/No question. Optional Data : <TEXT> Command Description : -P : Prompts user with <TEXT> to input a <PASSWORD>. If the user correctly enters the password, the OK ACS command will be set to TRUE. The optional data field for this command is required. The <TEXT> field is the text which prompts the user for the password. The <PASSWORD> field is the password that the user must enter. An example data field for a -P command might be: |CREnter Password: ;PASSWORD The above line would prompt the user with "Enter Password" and chec to see if they enter "PASSWORD", storing the result in the OK ACS command. Optional Data : <TEXT>;<PASSWORD> Command Description : -S : Add line of text into SysOp log file. This command will add a line of text into the SysOp log file. The optional data field holds the text that will be appended. Optional Data : <Text to Output> Command Description : -Y : Prompts user with a Yes/No question and if the user answers "Yes", the OK ACS command will be set to TRUE. The optional data field is the text that will be displayed to the user as the Yes/No question. Optional Data : <TEXT> --------------------------------------------------------------------System Display Files --------------------------------------------------------------------Display files are displayed at certain times while a user is online. These files exist in the TEXT directory and have an extension of either .ANS or .ASC. If you wish to have your BBS use .ANS files (files which ma e use of ANSI color and graphics), then it is suggested that you use an ANSI paint program such as TheDraw to create such files. .ANS files: These are files which contain ANSI color and graphic codes. They are displayed if the user supports the ANSI graphics standard.

.ASC files: These are files which contain only straight ASCII characters. They are displayed if the user does not support ANSI graphics, OR if the user does support ANSI graphics but only a display file with the extension .ASC exists in the text directory. Below is a list of all system display files and when they are displayed (where .XXX is either .ANS or .ASC): ANSICHAT .XXX - This is the template file for the split screen chat mode. For more information on templates, see the section on the Template System. ANSIEDIT .XXX - This is the template file for the full screen editor. For more information on this file, see the section on the Template System. ANSIFINF .XXX - This is the template file used when displaying extended file information during the lightbar file listings. ANSIFLST .XXX - This is the template file used to setup the ANSI lightbar file listings. For more information on this, see the Editing Template section. ANSIMLST .XXX - This is the template file used for the lightbar message reading index. ANSIMRD .XXX - This is the tempalte file used for the lightbar message reading. ANSIQUOT .XXX - This is the template file for the full screen editor quote mode window. For more information on this, see the section on the Template System. ANSITEXT .XXX - This is the template file for the full screen text editor. For more information on this, see the section on the Template System. AMSGHLP1 .XXX - Help file for ANSIMLST.XXX AMSGHLP2 .XXX - Help file for ANSIMRD.XXX BIRTHDAY .XXX - Displayed during login if the user calls on their birthday. BLINDUL .XXX - Displayed when a user selects to start a blind file upload. CLOSED .XXX - Displayed if a System Password has been defined and the incoming caller did not enter the correct password. DOWNLOAD .XXX - Displayed before the "Filename:" prompt when a user attempts a download. EMAILHLP .XXX - Displayed during the e-mail reading prompt when the user enters "?". FEEDBACK .XXX - Displayed before new users are forced to send the SysOp an e-mail message. FGROUPx .XXX - Displayed after joining file group x. FLAG1x .XXX - Displayed during login if user has flag 1x set. FLAG2x .XXX - Displayed during login if user has flag 2x set. FLISTHLP .XXX - Displayed when help is selected during the lightbar file listings. FSEARCH .XXX - Displayed before a file search. FSHELP .XXX - Displayed if user selects help while in the full screen editor. GROUPx .XXX - Displayed after joining group x. LOGOFF .XXX - Displayed right before hanging up the caller when a user selects to log off the BBS. LOGON1-9 .XXX - Displayed in order from 1 to 9 after a user successfully enters their password.

NEWUSER .XXX - Displayed before as ing the user if they'd li e sign up as a new user. NEWUSER1 .XXX - Displayed after user answers yes to continue to login as a new user. NONEWUSR .XXX - Displayed if a new user tries to log in when Allow New Users is toggled off. The call is terminated after this file is displayed. PRELOGON .XXX - Displayed after the user selects their terminal emulation, and before the "login:" prompt. PROTO .XXX - Displayed as a list of available protocols. If this file doesn't exist, Mystic will generate a protocol list. PROTOB .XXX - Displayed as a list of available batch protocols. If this file doesn't exist, Mystic will generate a batch protocol list. READHLP .XXX - Displayed during the message reading prompt when the user enters "?". READSHLP .XXX - Displayed during the message reading prompt when the user enters "?" AND they have SysOp access to the message base. SLxxx .XXX - Displayed during login if user has a security level of xxx or higher. TELECONF .XXX - Displated when entering the standard teleconference system, and redisplayed again after the teleconference help file is displayed. TELEHELP .XXX - The help file displayed in the teleconference when a /? is entered. UPLOAD .XXX - Displayed before the "File Name:" prompt when a user attempts an upload. --------------------------------------------------------------------Random Display Files --------------------------------------------------------------------Mystic BBS supports randomly selected display files. If you have several different versions of a single display file, it is possible to have Mystic BBS randomly select and display one of the files. Here's how the random display system wor s: Mystic BBS will chec to see if the extension of the file with the last letter replaced by a "1" exists. If the display file name is TEMP.ASC, Mystic will loo to see if TEMP.AS1 exists. If it does, Mystic will search for all files which follow the TEST.AS? file mas (where ? is replaced by a 1 through 9). Mystic will then randomly select one of the files and display it. For example: If the display file name is TEST.ASC and the TEST.AS1 file exists, Mystic BBS will randomly select and display any one of the following files that exist: TEST.ASC TEST.AS1 TEST.AS2 TEST.AS4 TEST.AS5 TEST.AS6 TEST.AS7 TEST.AS8 TEST.AS9

The same format wor s for all display files, so if the file name is TEST.ANS, and TEST.AN1 exists, Mystic will randomly select and display any one of the following files that exist: TEST.ANS TEST.AN1 TEST.AN2 TEST.AN3 TEST.AN4 TEST.AN5 TEST.AN6 TEST.AN7 TEST.AN8 TEST.AN9 --------------------------------------------------------------------MCI Display Codes --------------------------------------------------------------------MCI codes are used to display various information about the BBS system or the currently logged in user. They can be used in all prompts and display files throughout Mystic BBS, and are in the format of |XX (where XX is replaced by any one of the codes listed below). The following is an example of using the MCI system in a display file: Original text: -------------Welcome to this BBS, |UN. You have called |CS times total. You have called |CT times today. When displayed by Mystic: ------------------------Welcome to this BBS, <User_Name_Will_Be_Here>. You have called <Total_Calls_Will_Be_Here> times total. You have called <Calls_Today_Will_Be_Here> times today. --------------------------------------------------------------------Available MCI Codes --------------------------------------------------------------------Codes 00 through 15 can be used to set the foreground color:

00 01 02 03 04 05 06 07 08 09 10 11 12 13

Blac foreground. Dar blue foreground. Dar green foreground. Dar cyan foreground. Dar red foreground. Dar magenta foreground. Dar yellow foreground. Light gray foreground. Dar gray foreground. Light blue foreground. Light green foreground. Light cyan foreground. Light red foreground. Light magenta foreground.

14 - Light yellow foreground. 15 - White foreground. Codes 16 through 23 can be used to set the bac ground color:

The following three MCI codes are used to set how the next displayed MCI code is formatted: $Rxx - Pads the next MCI code to the right with spaces. Where xx is the number of spaces to pad. It must ALWAYS be two characters, so if you want to pad an MCI to 5 spaces, you MUST enter |$R05, not |$R5. $Lxx - Pads the next MCI code to the left xx spaces. $Cxx - Pads the next MCI code to the center. Where xx is the number of spaces to center the MCI within. The following MCI code is used to duplicate a character a specified number of times: $Dxxy - Duplicates the character y, xx number of times. Here are some examples of using MCI formatting: Original text: -------------|$R30|UNHello When displayed by Mystic: ------------------------<User_Name_Here> Original text: -------------Hello|$L30|UN When displayed by Mystic: ------------------------Hello Original text: -------------|$C70|UN When displayed by Mystic: ------------------------<User_Name_Here> Original text: -------------Hello |$D20*

16 17 18 19 20 21 22 23

Blac bac ground. Blue bac ground. Green bac ground. Cyan bac ground. Red bac ground. Magenta bac ground. Yellow bac ground. Grey bac ground.

<User_Name_Here>

Hello

When displayed by Mystic: ------------------------Hello ******************** The following MCI codes are used to move the cursor to a specified position on the screen. They will only wor if the user is capable of supporting ANSI graphics, otherwise they will be ignored: [Xxx - Moves the cursor to column XX. [Yxx - Moves the cursor to row XX. [Axx [Bxx [Cxx [Dxx Moves Moves Moves Moves the the the the cursor cursor cursor cursor XX XX XX XX rows rows rows rows UP DOWN RIGHT LEFT

Codes &0 through &9 are used in the language file and hold different values for different display strings. They are called Prompt Info MCI codes. The supported prompt info codes for each string are listed in the language file and the language editor (LANGEDIT.EXE). Codes !0 through !9 are used with the template system and are called Screen Info MCI codes. They are usually used to define screen coordinates in each template file. For more information on these MCI codes and the template system, see the section on the Mystic BBS Template System. The following MCI codes are used to display information on the BBS and the currently logged in user: AS AV BD BE BI BN CL CM CR CS CT DA DE DF Is user's auto signature toggled ON? (Returns YES or NO) Is the user available to receive node messages (YES or NO) Displays the user's baud rate. Sounds a BEEP. Displays the user's birth date. Displays the BBS name as defined in System Configuration. Clears the screen. Displays "on/off" according to the user's FS node chat setting Sends a carriage return (Enter). Displays the user's total number of calls to the BBS. Displays the number of times the user called today. Displays the current date. Delays for half a second. Displays a text file from the language text directory. For example, |DFHELLO would display the text file HELLO.XXX from the currently language text file directory. Mystic BBS assumes all of the remaining text on a line after a DF code as the file name to display. Displays the user's total number of downloaded ilobytes. Displays the user's total number of downloads. Displays the user's number of downloads today. Displays the current file base name. Displays the current file group name. Displays the user's total number of uploaded ilobytes. Displays the date of the user's first call to the BBS. Displays the user's total number of uploads. Returns either ON or OFF depending on the user's hot ey setting.

DK DL DT FB FG FK FO FU HK

PO QA QL QO RD RK RP SA SB SC SD SK SL SP ST SX TB TC TE TI TL TO U1 U2 U3 UA UB UC UD UE UF UG UH UI UJ UK UL UM UN

PC PI PN -

IF IL IN KB KT LO MB ME MG ML MN MP ND NE OS PA

Turns the input field box OFF for the next input. Displays the user's invisibility status (ON/OFF). Format: INxx. Limits input field to XX characters. Displays the number of KB in user's KB ban . Displays the user's total number of download ilobytes today Displays the date of the user's last login. Displays the name of the current message base. Displays the number of emails the user has sent. Displays the name of the user's current message group. Displays on/off based on the user's lightbar message index. Displays the networ name for the current message base. Displays the number of messages the user has posted. Displays the current node number Displays the number of minutes until the next system event. Displays the Mystic BBS OS version. IE: DOS, WIN, or OS2. Pause. Sends the pause prompt and waits for the user to press a ey. Displays the user's current post/call ratio percentage Display a pipe character (|). Pause. Waits for the user to press a ey without sending the pause prompt. Temporarily disables screen pauses. Displays the user's current archive setting. Displays the user's current QWK file list setting. Displays a randomly generated quote. Displays the user's set download ratio. Displays the user's set download ilobyte ratio. Format: RPxx. Sets the pause screen counter to xx lines. Displays the max amount of KB allowed in KB ban . Displays the max amount of minutes allowed in time ban . Displays the max number of calls allowed per day. Displays the description of the user's security level. Displays the max number of download Kb allowed per day. Displays the user's security level. Displays the post/call ratio for the user's security level. Displays the # of minutes given to the user per day. Displays the max number of downloads allowed per day. Displays the total minutes in the user's time ban . Displays the total number of callers the BBS has had. Displays the user's terminal emulation (ANSI/ASCII). Displays the current time. Displays the user's time (in minutes) left for the day. Displays the number of minutes the user has been online. Displays the user's optional field 1 Displays the user's optional field 2 Displays the user's optional field 3 Displays the user's address. Displays the user's file listing type. Displays the user's city and state. Displays the user's data phone number. Displays the user's message editor setting. Displays the user's selected date format. Displays the user's gender. Displays the user's handle/alias. Displays the user's user note. Displays the user's message reader type. Displays the user's e-mail address. Displays the user's current language. Displays the user's lightbar email index setting. Displays the user's real name.

UP UQ US UZ VR

Displays Displays Displays Displays Displays

the the the the the

user's home phone number. user's current quote mode setting. user's screen length. user's zip code. version of Mystic BBS.

--------------------------------------------------------------------Template System (Editing Mystic BBS Templates) --------------------------------------------------------------------The template system is used to customize the display of many options of Mystic BBS which are not part of the language system. Template files are more or less "screen captures" of the screen that will be displayed to the user, with Screen Info MCI codes inserted to define the X and Y screen coordinates for various things. These files MUST exist in the text directory for each language in order for Mystic BBS to function properly. The default installation for Mystic BBS includes these files, but they can be edited if the default files are not satisfactory. The following is a list of template files which Mystic BBS requires, and a description of where they are used: ANSICHAT.XXX ANSIEDIT.XXX ANSIFINF.XXX ANSIFLST.XXX ANSIMLST.XXX ANSIMRD .XXX ANSIQUOT.XXX ANSITEXT.XXX : : : : : : : : Split screen chat template. Full screen editor template. Lightbar file listing: extended file information. Lightbar file listing template. Lightbar message reading index. Lightbar message reader. Full screen editor quote mode template. Full screen TEXT editor template.

The template system can be confusing for someone who doesn't have much experience with ANSI text file editing. In most cases, it is suggested that the ANSI file editor "TheDraw" be used, and that the files are saved as ANSI animated files. If you are not familiar with editing ANSI files then it is suggested that you do not edit the default templates, or at least ma e a bac up of the default templates before attempting to modify them. The following is a small section on each template file, with instructions on how each one is used: ----------------------------------------ANSICHAT.XXX - Split Screen Chat Template ----------------------------------------The ANSICHAT.XXX template is used when the split screen chat mode is activated. Screen Info MCI codes are used in this template to specify the coordinates of both the sysop and user chat window. The following is a list of the MCI codes used in this template followed by an explanation of where each one should be used: |!1 Specifies the text color of |!2 Specifies the |!3 Specifies the |!4 Specifies the upper Y position of the user's window. lower Y position of left X position of right X position of the user's window and the the user's window the user's window the user's window

|!5 Specifies the upper Y position of the sysop's window and the

text color of the user's window. |!6 Specifies the lower Y position of the sysop's window |!7 Specifies the left X position of the sysop's window |!8 Specifies the right X position of the sysop's window |!9 Specifies the color/location of time left update |!0 Specifies the color/location of system time update |&1 Replaced with the user's name. |&2 Replaced with the sysop's name. An example of a split screen chat template would be: User: |&1 ----------------------------|!1 |!3 |!4 |!2 Sysop: |&2 ----------------------------|!5 |!7 |!8 |!6 ---------------------------------------------------------------------ANSIEDIT.XXX - Full Screen Editor Template -----------------------------------------The ANSIEDIT.XXX template is used when the full screen editor is activated. Screen Info MCI codes are used in this file to define the coordinates of the text editing window. The following list of MCI codes are used in the Full Screen Editor template: |!1 Specifies the top line of the edit window, as well as the color of the inputted text. |!2 Specifies the bottom line of the edit window. |!3 Specifies the location of the "INS/OVR" toggle, as well as the color of the "INS/OVR" text. |&1 Who the message is To |&2 Subject of the message An example of a full screen editor template: Full Screen Editor [|!3] Ctrl-Z = Help -----------------------------------------|!1

|!2 -----------------------------------------Note: The color which is set after the template is displayed will be the color of the edited text. See also: ANSIQUOT.XXX. The template for the Full Screen Editor Quote window. -------------------------------------------------------

ANSIFINF.XXX - Extended File Info In Lightbar File List ------------------------------------------------------This template is used when displaying extended information on a file during the lightbar file listings. The following screen info and prompt info MCI codes are available: |&1 |&2 |&3 |&4 |&5 |&6 |&7 |&8 File name of the file. File size of the file. Date the file was added into the database. Time the file was added into the database. Number of times the file was downloaded. Estimated minutes it will ta e to transfer the file. Estimated seconds it will ta e to transfer the file. Name of the user who uploaded the file.

|!1 Specifies the color and top Y position of the file description window. |!2 Specifies the bottom Y position of the file description window. --------------------------------------------ANSIFLST.XXX - Lightbar File Listing Template --------------------------------------------The ANSIFLST.XXX template is used to define the coordinates and colors for the lightbar file listings. The color of each screen info MCI code for this template is saved, and will be used in the file listing. The following screen info MCI codes are used: |!1 Specifies the top Y coordinate of the file list window. The color of this code is ignored. |!2 Specifies the bottom Y coordinate of the file list window. The color of this code is ignored. |!3 Specifies the Y coordinate and default color for the "prompt" line. This is the line where general text is displayed, such as "Batch queue full", etc. |!4 This code is optional, and if defined specifies the X/Y coordinates AND the color of the total number of files in the user's batch queue. --------------------------------------------ANSIMLST.XXX - Lightbar Message Reading Index --------------------------------------------|!1 Specifies the top line of the message index list window |!2 Specifies the bottom line of the message index window |!3 Specifies the line Mystic will relocate to when the user selects to quit reading. ------------------------------------ANSIMRD.XXX - Lightbar Message Reader ------------------------------------The ANSIMRD.XXX template is used when the user is reading actual messages and has the lightbar message reader toggled ON. -----------------------------------------------ANSIQUOT.XXX - Full Screen Editor Quote Template

-----------------------------------------------The ANSIQUOT.XXX template file is used to define the quote window used in the full screen editor. The quote window is always six lines in size, so when creating the ANSIQUOT.XXX, you must ma e sure that there are at least 6 lines from the beginning of the quote window to the end of the screen. The following is a list of MCI codes which are used for this template: |!1 This defines the position where text scroll at while quoting. This is usually the line before the quote window starts. |!2 This is the line where the actual first line of the quote window is. The bottom line is not needed since the quote window is always 6 lines long. The color of this code is saved and is used for non-highlighted text. An example of the quote template: <top of screen> |!1 --Quote Window (ESC) Quit---------------|!2 <bottom of screen> The color for the Quote Window Lightbar can be defined in the System Configuration -> Language Editor section of the BBS. ----------------------------------------------ANSITEXT.XXX - Full Screen Text Editor Template ----------------------------------------------This template file is identical to the ANSIEDIT.XXX file except that it is used when editing text, and not inputting a message. Ctrl-Z in the text editor SAVES the text, instead of showing the help screen as the full screen editor does. The &1 and &2 MCI codes are not available for this template. ---------------------------------------------------------------------Installing Multiple Nodes of Mystic BBS ---------------------------------------------------------------------Mystic BBS is a multi-node BBS pac age. This means that multiple incoming connections can be installed - whether they be dial-up or telnet connections. Mystic BBS will allow up to 255 nodes to be defined. Setting up Mystic BBS to run have to change your setup in files or anything li e that. an operating system that has multi-node is VERY any way, or create All you will need built in multi-tas

easy. You will not directories and copy is a multi-tas er, or ing capabilities.

Mystic BBS internally supports to following multi-tas ing software and operating systems: - Quarterdec 's DesqView (DOS) - Microsoft Windows (any version) - IBM OS/2 (any version)

In addition, Mystic BBS will give off "generic" time slicing if one of the above environments is not detected. This means that Mystic BBS will run well under almost ANY obscure multi-tas er! Mystic BBS has been tested and ran under the following operating systems. Mystic may run well in other configurations, but the following have been tested and said to wor well: DOS using DesqView Windows 3.1 Windows 95 Windows 98 Windows NT IBM OS/2 Warp 3.0 IBM OS/2 Warp 4.0 Linux (using DOSEMU)

How to setup Mystic BBS to run Multi-node: (1) Load Mystic BBS and enter "System Configuration". From there select "General Settings". Set the "Max # of Nodes" option to the maximum number of incoming nodes that you plan on loading. Exit Mystic BBS. (2) Load EACH node you wish to setup in local mode. This can be done by running Mystic BBS with the -Nx and -L command lines. For example, the command line for loading node 2 in local mode would be: "-N2 -L". Enter "System Configuration" and select "Modem/Node Settings". You will need to setup each node so it finds the correct modem. You're done! That's it. The only difference in your setup will be that you MUST specify the node number now when loading your BBS. This is done with the "-N" command line option. So loading your BBS would wor something li e this: (1) Create new DOS tas . (2) Load Mystic BBS with -Nx option. (3) Repeat for each node. I hope this is all understandable. It really is VERY easy to do - it ta es me about 3 minutes to get a new node setup and running! ---------------------------------------------------------------------Setting Up Door Programs In Mystic BBS ------------------------------------------------------------------------------------------------------------------------------------------Setting Up Mystic BBS (DOS Version) To Allow Incoming Telnet ---------------------------------------------------------------------Mystic requires the use of a virtual modem driver, such as NetModem for Windows, or Ray Gwinn's SIO drivers for OS/2. More information will be added to this section in the future. ---------------------------------------------------------------------LANGEDIT.EXE / MAKELANG.EXE: Editing Language Files

---------------------------------------------------------------------Language files contain almost 100% of the text that is displayed to the user. These files can be edited via LANGEDIT.EXE or any text editor to allow a totally unique user interface for your BBS. After each language text file has been edited, it must be compiled using the MAKELANG.EXE program for the changes to ta e effect. (THIS PART OF THE DOCUMENTATION HAS NOT BEEN COMPLETED) ---------------------------------------------------------------------MBBSUTIL.EXE: Mystic BBS External Utilities ---------------------------------------------------------------------Mystic BBS comes along with an external utilities program found in the root Mystic BBS directory under the filename of MBBSUTIL.EXE. This program provides many utilities which can (and should) be ran occasionally to help eep your Mystic BBS system running smoothly. When MBBSUTIL.EXE is ran, there are several command line options available which command MBBSUTIL.EXE what to do. The follow is a list of the available commands, and a brief description of what each option does: -BKILL <ID> <Days> : This command will remove all BBS list entries which haven't been verified in the past <Days> days. The <ID> option specifies the BBS list ID name, as required by Mystic's BBS listing menu commands. If <ID> is set to "ALL", MBBSUTIL will chec ALL existing BBS lists.

-BSORT <ID> <Type> : This command will sort a BBS list, and also pac it while sorting! The <ID> option specifies the BBS list ID name, as required by Mystic's BBS listing menu commands. If <ID> is set to "ALL", MBBSUTIL will sort all existing BBS lists. The <TYPE> option specifies the data which MBBSUTIL will use to sort the list. The following options are available: BBSNAME LOCATION PHONE TELNET -FCHECK : : : : Sort Sort Sort Sort by by by by BBS name Location phone number telnet address

: This command will chec all file entries in all file bases to ma e sure that the file physically exists. If the file does not exist, or if the size of the file is 0 bytes, MBBSUTIL will mar the file as offline. Li ewise, if a file mar ed as offline physically exists, MBBSUTIL will remove it's offline flag. The FCHECK command will also validate the file size of each file

-BPACK

: This command will pac the BBS list database. It will remove any records which have been mar ed as deleted from the data files.

entry.

-FSORT

: This command will sort the file database in alphabetical order by filename. It will also automatically pac the file base while sorting! : This command will delete users who have not called the BBS for a specified number of <days>. The <days> option must be at least 5. This will prevent accidentally having a 0 wipe out the entire user database. : This command will pac the user file. It will remove any user accounts which have been mar ed as deleted from the user data files.

-UKILL <Days>

It is suggested that all of the "pac ing" functions (-BPACK, -FPACK, -UPACK, etc) are ran at least once every few days, maybe more or less depending on how active your BBS is. The sorting functions are less important, but they are nice to help eep your BBS organized. An example command line for running MBBSUTIL.EXE with all the suggested commands follows: MBBSUTIL.EXE -BPACK -FPACK -UPACK Note: Since MBBSUTIL.EXE ma es modifications to the system data files, it should only be ran when there are NO users currently logged into the BBS system. MBBSUTIL.EXE will attempt to detect if any users are logged into the system, and if so, it will refuse to run. ---------------------------------------------------------------------MENUEDIT.EXE: Mystic BBS External Menu Editor ---------------------------------------------------------------------Mystic BBS is supplied with an external menu editor, as an alternative to using the menu editor inside of Mystic BBS. This menu editor is a little more user friendly as it offers lightbar navigation. Using this editor is much li e using the internal menu editor - so once you get a feel for editing menus within Mystic BBS, using this program will be second nature. ---------------------------------------------------------------------MIDE.EXE and MPLC.EXE: Mystic BBS Programming Executable Compilers ---------------------------------------------------------------------Mystic BBS has a built in programming language which can be used to create add-on games and utilities for your BBS. Two programs are supplied with Mystic BBS which go along with this programming language: MPLC.EXE - A command line compiler. This program translates a MPS source file into a MPE binary executable file. A MPS source file is a text file which contains programming commands recognized by the MPE engine. These files can be edited with any text editor, or the supplied MIDE program described below.

-UPACK

-FPACK

: This command will pac the file database. It will remove any files which have been mar ed as deleted from the data files.

MIDE.EXE - MIDE is the Mystic BBS Integrated Environment. In other words, its helps you to create MPE programs. MPS source files to be edited and offering some other features that does not.

Development a text editor which This program allows compiled, while a normal text editor

For more information on the MPE language, see MPL.DOC located in the scripts directory. This file will reference all the programming commands supported by the MPE engine. You may also wish to loo at the various .MPS files in the script directory for examples of fully functional programs. ---------------------------------------------------------------------System Error Codes (Runtime Errors) ---------------------------------------------------------------------If an error happens while Mystic BBS is running, it will return an error message to the user, and terminate the call. In the log file, an error number will be logged. Below is a list of what each of those error numbers stand for. They are provided for reference only, and will probably not be of any help to a Sysop. 1 2 3 4 5 6 8 10 11 12 15 16 17 18 100 101 102 103 104 105 106 150 151 152 154 156 157 158 159 160 161 162 200 201 202 203 Invalid function number File not found Path not found Too many open files Access denied Invalid handle Not enough memory Invalid environment Invalid format Invalid file access code Invalid drive number Cannot remove current directory Cannot rename across drives No more files Dis read error Dis write error File not assigned File not open File not open for input File not open for output Invalid numeric format Dis is write-protected Bad drive request struct length Drive not ready CRC error in data Dis see error Un nown media type Sector Not Found Printer out of paper Device write fault Device read fault Hardware failure Division by zero Range chec error Stac overflow error Heap overflow error

204 205 206 207 208 209 210 211 212 213 214

Invalid pointer operation Floating point overflow Floating point underflow Invalid floating point operation Overlay manager not installed Overlay file read error Object not initialized Call to abstract method Stream registration error Collection index out of range Collection overflow error

---------------------------------------------------------------------CREDITS ---------------------------------------------------------------------This section gives some credit to some of the people who have helped ma e Mystic BBS what it is today. So chec it out: The authors of the JAM message base proposal as that all authors who support JAM insert this notice into their programs: JAM(mbp) - Copyright 1993 Joaquim Homrighausen, Andrew Milner, Mats Birch, Mats Wallin. ALL RIGHTS RESERVED. Mar May, who has written a Pascal message base library which I've modded and used within Mystic BBS, starting with v1.03. In the near future I will be doing a total rewrite from scratch, but for quic Squish support, his library wor s fairly well. (so far) :) The authors of SPAWNO, a small DOS shell swapper for Turbo Pascal which is used in the DOS version of Mystic BBS. Sonic, who has donated so much to the developement of Mystic BBS. If it wasn't for him, we wouldn't have any 32-bit versions of Mystic. Kargus, who has donated the "Another BBS Running" Mystic BBS login screen. Cremix, who designed the WFC screen which eventually was morphed into the full screen editor help screen! =) The Dutch Dude, who designed the simple ASCII logo which is used at the top of this documentation. Justin Scott (Leviathan), who has supplied us with web space, ftp hosting, mailing list hosting, and more in the past and present. QueTwo, who registered mysticbbs.com for the convience of all of us! I appreciate it GREATLY Que! Than you! And lets not forget all the people who have made valuable bug reports, suggestions, donations (see next section), and last - but certainly not least - all the SysOps who run and support Mystic BBS software. Than s everyone. You're help is appreciated. ----------------------------------------------------------------------

DONATIONS ---------------------------------------------------------------------The following people have made a considerable donation towards the future of Mystic BBS. So far the donations received from these people have given us our native Win32 and OS/2 versions of Mystic BBS. Without these donations, those 32-bit versions of Mystic BBS would have never become a reality. If you would li e to ma e a donation, please see the DONATION section of this documentation, or see REGISTER.DOC included in the distribution archive. SysOp: Sonic BBS : The HUB SysOp: Sloop BBS : The Dead End SysOp: John Guillory BBS : MailLine Consulting BBS WWW : www.mainlinebbs.com SysOp: Reapern66 BBS : <Un nown> SysOp: Ne1 BBS : Distorted Utopia SysOp: QueTwo BBS : Children of Technology

Phone : 318-431-7189 E-Mail: John.Guillory@mainline.nu Telnet: <Un nown> E-Mail: reapern66@netzero.net Telnet: distorted.dar tech.org E-Mail: <un nown> Telnet: cot.dar tech.org E-Mail: quetwo@earthling.net

* If your name is listed here and you want information changed or removed, please send e-mail to me at mysticbbs@geocities.com To everyone that has made a donation: Than you! Your donations and support are greatly appreciated - and will aid in eeping Mystic BBS alive and thriving! I can't than you all enough!!! ---------------------------------------------------------------------EOF: Mystic BBS Sysop Documentation

Telnet: magrathea.desupernet.net E-Mail: djdave@desupernet.net Telnet: <un nown> E-Mail: <un nown>